Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O seguinte descreve todas as propriedades e elementos no conteúdo de notificação de ‘toast’.
Se preferir usar XML bruto em vez das APIs SDK de Aplicações Windows builder, consulte o esquema XML.
ToastContent
ToastContent é o objeto de nível superior que descreve o conteúdo de uma notificação, incluindo elementos visuais, ações e áudio.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Launch | cadeia (de caracteres) | falso | Uma cadeia de caracteres que é passada para o aplicativo quando ele é ativado pelo Toast. O formato e o conteúdo dessa cadeia de caracteres são definidos pelo aplicativo para seu próprio uso. Quando o utilizador toca ou clica no Toast para iniciar a aplicação associada, a cadeia de inicialização fornece o contexto para a aplicação que permite mostrar ao utilizador uma exibição relevante para o conteúdo do Toast, em vez de iniciar da maneira padrão. |
| Visual | ToastVisual | verdadeiro | Descreve a parte visual da notificação da aplicação. |
| Ações | IToastActions | falso | Opcionalmente, crie ações personalizadas com botões e entradas. |
| Áudio | ToastAudio | falso | Descreve a parte áudio da notificação da aplicação. |
| ActivationType | ToastActivationType | falso | Especifica qual tipo de ativação será usado quando o usuário clicar no corpo deste Toast. |
| ActivationOptions | ToastActivationOptions | falso | Opções adicionais relacionadas com a ativação da notificação da aplicação. |
| Cenário | ToastScenario | falso | Declara o cenário para o qual o seu toast é utilizado, como um alarme ou lembrete. |
| DisplayTimestamp | DateTimeOffset? | falso | Substitua o carimbo temporal predefinido com um carimbo personalizado que indique quando o conteúdo da notificação foi realmente entregue, em vez do momento em que a notificação foi recebida pela plataforma Windows. |
| Cabeçalho | ToastHeader | falso | Adicione um cabeçalho personalizado à sua notificação para agrupar várias notificações no Centro de Notificações. |
ToastScenario
Especifica o cenário que a notificação representa.
| Valor | Meaning |
|---|---|
| Predefinição | O comportamento normal do brinde. |
| Reminder | Uma notificação de lembrete. Isso será exibido pré-expandido e permanecerá na tela do usuário até ser descartado. |
| Alarm | Uma notificação de alarme. Isso será exibido pré-expandido e permanecerá na tela do usuário até ser descartado. O áudio repetir-se-á por padrão e usará o áudio de alarme. |
| IncomingCall | Uma notificação de chamada recebida. Isso será exibido pré-expandido em um formato de chamada especial e permanecerá na tela do usuário até ser dispensado. O áudio fará loop por padrão e usará áudio de toque. |
ToastVisual
A parte visual das notificações do sistema contém as associações, que contêm texto, imagens, conteúdo adaptável e muito mais.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| BindingGeneric | ToastBindingGeneric | verdadeiro | A ligação genérica de 'toast', que pode ser renderizada em todos os dispositivos. Essa associação é necessária e não pode ser nula. |
| BaseUri | Uri | falso | Uma URL base predefinida que é combinada com URLs relativos em atributos de origem de imagem. |
| AddImageQuery | bool? | falso | Define para "true" para permitir que o Windows anexe uma string de consulta à URL da imagem fornecida na notificação da aplicação. Use esse atributo se o servidor hospedar imagens e puder manipular cadeias de caracteres de consulta, recuperando uma variante de imagem com base nas cadeias de caracteres de consulta ou ignorando a cadeia de caracteres de consulta e retornando a imagem conforme especificado sem a cadeia de caracteres de consulta. Esta cadeia de caracteres de consulta especifica escala, configuração de contraste e idioma; Por exemplo, um valor de "www.website.com/images/hello.png" dado na notificação torna-se "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
| Language | cadeia (de caracteres) | falso | A localidade de destino do conteúdo visual ao utilizar recursos localizados, especificada como etiquetas de idioma BCP-47, como "en-US" ou "fr-FR". Essa localidade é substituída por qualquer localidade especificada em vinculação ou texto. Se não for fornecida, será usada a configuração regional do sistema. |
ToastBindingGeneric
A associação genérica é a associação padrão para toasts, sendo o local onde se especifica o texto, as imagens, o conteúdo adaptável e outros elementos.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Crianças | IList<IToastBindingGenericChild> | falso | O conteúdo do corpo do brinde, que pode incluir texto, imagens e grupos. Os elementos de texto devem vir antes de quaisquer outros elementos, e apenas 3 elementos de texto são suportados. Se um elemento de texto for colocado depois de qualquer outro elemento, ele será puxado para o topo ou descartado. E, finalmente, certas propriedades de texto como HintStyle não são suportadas nos elementos de texto filhos da raiz, e só funcionam dentro de um AdaptiveSubgroup. |
| AppLogoOverride | ToastGenericAppLogo | falso | Um logotipo opcional para substituir o logotipo do aplicativo. |
| HeroImage | ToastGenericHeroImage | falso | Uma imagem opcional de "herói" em destaque que é exibida no toast e no Centro de Notificações. |
| Attribution | ToastGenericAttributionText | falso | Texto opcional de atribuição que será exibido no final da notificação da aplicação. |
| BaseUri | Uri | falso | Uma URL base predefinida que é combinada com URLs relativos em atributos de origem de imagem. |
| AddImageQuery | bool? | falso | Define para "true" para permitir que o Windows anexe uma string de consulta à URL da imagem fornecida na notificação da aplicação. Use esse atributo se o servidor hospedar imagens e puder manipular cadeias de caracteres de consulta, recuperando uma variante de imagem com base nas cadeias de caracteres de consulta ou ignorando a cadeia de caracteres de consulta e retornando a imagem conforme especificado sem a cadeia de caracteres de consulta. Esta cadeia de caracteres de consulta especifica escala, configuração de contraste e idioma; Por exemplo, um valor de "www.website.com/images/hello.png" dado na notificação torna-se "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
| Language | cadeia (de caracteres) | falso | A localidade de destino do conteúdo visual ao utilizar recursos localizados, especificada como etiquetas de idioma BCP-47, como "en-US" ou "fr-FR". Essa localidade é substituída por qualquer localidade especificada em vinculação ou texto. Se não for fornecida, será usada a configuração regional do sistema. |
IToastBindingGenericChild
Interface de marcador para elementos filho do toast que incluem texto, imagens, grupos e muito mais.
| Implementações |
|---|
| AdaptiveText |
| AdaptiveImage |
| AdaptiveGroup |
| AdaptiveProgressBar |
AdaptiveText
Um elemento de texto adaptável. Se for colocado no nível superior de ToastBindingGeneric.Children, apenas HintMaxLines será aplicado. Mas se isso for colocado como filho de um grupo/subgrupo, o estilo de texto completo será suportado.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Texto | string ou BindableString | falso | O texto a ser exibido. A ligação de dados só funciona para elementos de texto de nível superior. |
| HintStyle | AdaptiveTextStyle | falso | O estilo controla o tamanho, a espessura e a opacidade da fonte do texto. Só funciona para elementos de texto dentro de um grupo/subgrupo. |
| HintWrap | bool? | falso | Defina isso como true para habilitar a quebra automática de texto. Os elementos de texto de nível superior ignoram essa propriedade e sempre quebram (você pode usar HintMaxLines = 1 para desabilitar a quebra automática para elementos de texto de nível superior). Os elementos de texto dentro de grupos/subgrupos têm como padrão false para quebra automática. |
| HintMaxLines | int? | falso | O número máximo de linhas que o elemento de texto pode exibir. |
| HintMinLines | int? | falso | O número mínimo de linhas que o elemento de texto deve exibir. Só funciona para elementos de texto dentro de um grupo/subgrupo. |
| HintAlign | AdaptiveTextAlign | falso | O alinhamento horizontal do texto. Só funciona para elementos de texto dentro de um grupo/subgrupo. |
| Language | cadeia (de caracteres) | falso | A localidade de destino da carga XML, especificada como marcas de idioma BCP-47, como "en-US" ou "fr-FR". O local especificado aqui substitui qualquer outro local especificado, como o de ligação ou visual. Se este valor for uma cadeia de caracteres literal, esse atributo usará, por padrão, o idioma da interface do utilizador. Se este valor for uma referência de cadeia, este atributo corresponde por defeito à localização escolhida pelo Windows Runtime ao resolver a cadeia. |
BindableString
Um valor de vinculação para cadeias de caracteres.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| BindingName | cadeia (de caracteres) | verdadeiro | Obtém ou define o nome que mapeia para o valor de dados de vinculação. |
AdaptiveTextStyle
O estilo de texto controla o tamanho, a espessura e a opacidade da fonte. A opacidade subtil é 60% opaca.
| Valor | Meaning |
|---|---|
| Predefinição | Valor padrão. O estilo é determinado pelo renderizador. |
| Caption | Menor do que o tamanho da fonte do parágrafo. |
| CaptionSubtle | O mesmo que Caption, mas com opacidade sutil. |
| Corpo | Tamanho da fonte do parágrafo. |
| BodySubtle | O mesmo que Corpo, mas com opacidade sutil. |
| Base | Tamanho da fonte do parágrafo, peso em negrito. Essencialmente a versão arrojada de Body. |
| BaseSubtle | O mesmo que Base, mas com opacidade sutil. |
| Subtitle | Tamanho da fonte H4. |
| SubtitleSubtle | O mesmo que "Subtitle", mas com opacidade subtil. |
| Título | Tamanho da fonte H3. |
| TitleSubtle | O mesmo que Título, mas com opacidade subtil. |
| TitleNumeral | O mesmo que título, mas com a margem superior/inferior removida. |
| Subheader | Tamanho da fonte H2. |
| SubheaderSubtle | O mesmo que Subheader, mas com opacidade sutil. |
| SubheaderNumeral | O mesmo que Subheader, mas com espaçamento em cima/em baixo removido. |
| Cabeçalho | Tamanho da fonte H1. |
| HeaderSubtle | O mesmo que Header, mas com opacidade sutil. |
| HeaderNumeral | O mesmo que o Cabeçalho, mas com as margens superior e inferior removidas. |
AdaptiveTextAlign
Controla o alinhamento horizontal do texto.
| Valor | Meaning |
|---|---|
| Predefinição | Valor padrão. O alinhamento é determinado automaticamente pelo renderizador. |
| Automático | Alinhamento determinado pela língua e cultura atuais. |
| Left | Alinhe horizontalmente o texto à esquerda. |
| Center | Alinhe horizontalmente o texto no centro. |
| Right | Alinhe horizontalmente o texto à direita. |
AdaptiveImage
Uma imagem embutida.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Source | cadeia (de caracteres) | verdadeiro | O URL para a imagem. MS-Appx, MS-AppData e HTTP são suportados. As imagens web podem ter até 3 MB em ligações normais e 1 MB em ligações medidas. |
| HintCrop | AdaptiveImageCrop | falso | Controla o corte desejado da imagem. |
| HintRemoveMargin | bool? | falso | Por padrão, as imagens dentro de grupos/subgrupos têm uma margem de 8px em torno delas. Você pode remover essa margem definindo essa propriedade como true. |
| HintAlign | AdaptiveImageAlign | falso | O alinhamento horizontal da imagem. Só funciona para imagens dentro de um grupo/subgrupo. |
| AlternateText | cadeia (de caracteres) | falso | Texto alternativo descrevendo a imagem, usado para fins de acessibilidade. |
| AddImageQuery | bool? | falso | Define para "true" para permitir que o Windows anexe uma string de consulta à URL da imagem fornecida na notificação da aplicação. Use esse atributo se o servidor hospedar imagens e puder manipular cadeias de caracteres de consulta, recuperando uma variante de imagem com base nas cadeias de caracteres de consulta ou ignorando a cadeia de caracteres de consulta e retornando a imagem conforme especificado sem a cadeia de caracteres de consulta. Esta cadeia de caracteres de consulta especifica escala, configuração de contraste e idioma; Por exemplo, um valor de "www.website.com/images/hello.png" dado na notificação torna-se "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
AdaptiveImageCrop
Especifica o corte desejado da imagem.
| Valor | Meaning |
|---|---|
| Predefinição | Valor padrão. Comportamento de corte determinado pelo renderizador. |
| Nenhum | A imagem não é cortada. |
| Circle | A imagem é cortada para uma forma de círculo. |
AdaptiveImageAlign
Especifica o alinhamento horizontal de uma imagem.
| Valor | Meaning |
|---|---|
| Predefinição | Valor padrão. Comportamento de alinhamento determinado pelo renderizador. |
| Stretch | A imagem se estende para preencher a largura disponível (e a altura potencialmente disponível também, dependendo de onde a imagem é colocada). |
| Left | Alinhe a imagem à esquerda, exibindo a imagem em sua resolução nativa. |
| Center | Alinhe a imagem no centro horizontalmente, exibindo a imagem em sua resolução nativa. |
| Right | Alinhe a imagem à direita, exibindo-a em sua resolução nativa. |
AdaptiveGroup
Os grupos identificam, de forma semântica, que o conteúdo dentro do grupo deve ser exibido integralmente ou não exibido, caso não seja possível acomodá-lo. Os grupos também permitem a criação de várias colunas.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Crianças | < IList> | falso | Os subgrupos são exibidos como colunas verticais. Você deve usar subgrupos para fornecer qualquer conteúdo dentro de um AdaptiveGroup. |
AdaptiveSubgroup
Subgrupos são colunas verticais que podem conter texto e imagens.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Crianças | ILista<IAdaptiveSubgrupoElemento> | falso | AdaptiveText e AdaptiveImage são filhos válidos de subgrupos. |
| HintWeight | int? | falso | Controle a largura desta coluna de subgrupo especificando o peso, em relação aos outros subgrupos. |
| HintTextStacking | AdaptiveSubgroupTextStacking | falso | Controle o alinhamento vertical do conteúdo deste subgrupo. |
IAdaptiveSubgroupChild
Interface de marcador para crianças do subgrupo.
| Implementações |
|---|
| AdaptiveText |
| AdaptiveImage |
AdaptiveSubgroupTextStacking
TextStacking especifica o alinhamento vertical do conteúdo.
| Valor | Meaning |
|---|---|
| Predefinição | Valor padrão. O renderizador seleciona automaticamente o alinhamento vertical padrão. |
| Início | Alinhamento vertical ao topo. |
| Center | Alinhamento vertical ao centro. |
| Bottom | Alinhamento vertical à parte inferior. |
AdaptiveProgressBar
Uma barra de progresso. Só é suportado em ambiente de trabalho.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Título | string ou BindableString | falso | Obtém ou define uma cadeia de caracteres de título opcional. Suporta vinculação de dados. |
| Value | duplo ou AdaptiveProgressBarValue ou BindableProgressBarValue | falso | Obtém ou define o valor da barra de progresso. Suporta vinculação de dados. O valor padrão é 0. |
| ValueStringOverride | string ou BindableString | falso | Obtém ou define uma cadeia de caracteres opcional a ser exibida em vez da cadeia de porcentagem padrão. Se isso não for fornecido, algo como "70%" será exibido. |
| Situação | string ou BindableString | verdadeiro | Obtém ou define uma cadeia de caracteres de status (obrigatório), que é exibida abaixo da barra de progresso à esquerda. Essa cadeia de caracteres deve refletir o status da operação, como "Baixando..." ou "Instalando..." |
AdaptiveProgressBarValue
Uma classe que representa o valor da barra de progresso.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Value | duplo | falso | Obtém ou define o valor (0,0 - 1,0) que representa a porcentagem concluída. |
| IsIndeterminate | booleano | falso | Obtém ou define um valor que indica se a barra de progresso é indeterminada. Se isso for verdade, Valor será ignorado. |
BindableProgressBarValue
Um valor de barra de progresso vinculável.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| BindingName | cadeia (de caracteres) | verdadeiro | Obtém ou define o nome que mapeia para o valor de dados de vinculação. |
ToastGenericAppLogo
Um logotipo a ser exibido em vez do logotipo do aplicativo.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Source | cadeia (de caracteres) | verdadeiro | O URL para a imagem. MS-Appx, MS-AppData e HTTP são suportados. As imagens http devem ter 200 KB ou menos de tamanho. |
| HintCrop | ToastGenericAppLogoCrop | falso | Especifique como você gostaria que a imagem fosse cortada. |
| AlternateText | cadeia (de caracteres) | falso | Texto alternativo descrevendo a imagem, usado para fins de acessibilidade. |
| AddImageQuery | bool? | falso | Define para "true" para permitir que o Windows anexe uma string de consulta à URL da imagem fornecida na notificação da aplicação. Use esse atributo se o servidor hospedar imagens e puder manipular cadeias de caracteres de consulta, recuperando uma variante de imagem com base nas cadeias de caracteres de consulta ou ignorando a cadeia de caracteres de consulta e retornando a imagem conforme especificado sem a cadeia de caracteres de consulta. Esta cadeia de caracteres de consulta especifica escala, configuração de contraste e idioma; Por exemplo, um valor de "www.website.com/images/hello.png" dado na notificação torna-se "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
ToastGenericAppLogoCrop
Controla o corte da imagem do logotipo do aplicativo.
| Valor | Meaning |
|---|---|
| Predefinição | O recorte usa o comportamento padrão do renderizador. |
| Nenhum | A imagem não é cortada, exibida em formato quadrado. |
| Circle | A imagem é cortada para um círculo. |
ToastGenericHeroImage
Uma imagem de "herói" em destaque que é exibida no brinde e no Centro de Notificações.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Source | cadeia (de caracteres) | verdadeiro | O URL para a imagem. MS-Appx, MS-AppData e HTTP são suportados. As imagens http devem ter 200 KB ou menos de tamanho. |
| AlternateText | cadeia (de caracteres) | falso | Texto alternativo descrevendo a imagem, usado para fins de acessibilidade. |
| AddImageQuery | bool? | falso | Define para "true" para permitir que o Windows anexe uma string de consulta à URL da imagem fornecida na notificação da aplicação. Use esse atributo se o servidor hospedar imagens e puder manipular cadeias de caracteres de consulta, recuperando uma variante de imagem com base nas cadeias de caracteres de consulta ou ignorando a cadeia de caracteres de consulta e retornando a imagem conforme especificado sem a cadeia de caracteres de consulta. Esta cadeia de caracteres de consulta especifica escala, configuração de contraste e idioma; Por exemplo, um valor de "www.website.com/images/hello.png" dado na notificação torna-se "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us" |
ToastGenericAttributionText
O texto de atribuição é exibido no final da notificação da aplicação.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Texto | cadeia (de caracteres) | verdadeiro | O texto a ser exibido. |
| Language | cadeia (de caracteres) | falso | A localidade de destino do conteúdo visual ao utilizar recursos localizados, especificada como etiquetas de idioma BCP-47, como "en-US" ou "fr-FR". Se não for fornecida, será usada a configuração regional do sistema. |
IToastActions
Interface de marcador para ações/entradas de notificação.
| Implementações |
|---|
| ToastActionsCustom |
| ToastActionsSnoozeAndDismiss |
ToastActionsCustom
Implementa IToastActions
Crie suas próprias ações e entradas personalizadas, usando controles como botões, caixas de texto e entradas de seleção.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Entradas | IList<IToastInput> | falso | Entradas como caixas de texto e entradas de seleção. Só são permitidas até 5 entradas. |
| Botões | IList<IToastButton> | falso | Os botões são exibidos após todas as entradas (ou adjacentes a uma entrada, se o botão for usado como um botão de resposta rápida). Apenas até 5 botões são permitidos (ou menos se você também tiver itens de menu de contexto). |
| ContextMenuItems | IList<ToastContextMenuItem> | falso | Itens personalizados do menu contextual, que fornecem ações adicionais se o utilizador clicar com o botão direito na notificação. Você só pode ter até 5 botões e itens de menu de contexto combinados. |
IToastInput
Interface de marcador para entradas do sistema.
| Implementações |
|---|
| ToastTextBox |
| ToastSelectionBox |
ToastTextBox
Implementa IToastInput
Um controle de caixa de texto no qual o usuário pode digitar texto.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Id | cadeia (de caracteres) | verdadeiro | O Id é necessário e é usado para mapear o texto inserido pelo usuário em um par chave-valor de id/value que seu aplicativo consome posteriormente. |
| Título | cadeia (de caracteres) | falso | Texto do título a ser exibido acima da caixa de texto. |
| PlaceholderContent | cadeia (de caracteres) | falso | Texto de espaço reservado a ser exibido na caixa de texto quando o usuário ainda não tiver digitado nenhum texto. |
| DefaultInput | cadeia (de caracteres) | falso | O texto inicial a ser colocado na caixa de texto. Deixe isso nulo para uma caixa de texto em branco. |
ToastSelectionBox
Implementa IToastInput
Um controle de caixa de seleção, que permite que os usuários escolham a partir de uma lista suspensa de opções.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Id | cadeia (de caracteres) | verdadeiro | O Id é obrigatório. Se o usuário selecionou esse item, esse Id será passado de volta para o código do seu aplicativo, representando a seleção escolhida. |
| Content | cadeia (de caracteres) | verdadeiro | O conteúdo é obrigatório e é uma cadeia de caracteres exibida no item de seleção. |
ToastSelectionBoxItem
Um item de caixa de opções (um item que o utilizador pode selecionar na lista suspensa).
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Id | cadeia (de caracteres) | verdadeiro | O Id é necessário e é usado para mapear o texto inserido pelo usuário em um par chave-valor de id/value que seu aplicativo consome posteriormente. |
| Título | cadeia (de caracteres) | falso | Texto do título a ser exibido acima da caixa de seleção. |
| DefaultSelectionBoxItemId | cadeia (de caracteres) | falso | Isso controla qual item é selecionado por padrão e se refere à propriedade Id do ToastSelectionBoxItem. Se você não fornecer isso, a seleção padrão estará vazia (o usuário não verá nada). |
| Itens | IList<ToastSelectionBoxItem> | falso | Os itens de seleção que o usuário pode escolher nesta SelectionBox. Apenas 5 itens podem ser adicionados. |
IToastButton
Interface de marcador para botões de notificação.
| Implementações |
|---|
| ToastButton |
| ToastButtonSnooze |
| ToastButtonDismiss |
ToastButton
Implementa IToastButton
Um botão em que o usuário pode clicar.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Content | cadeia (de caracteres) | verdadeiro | Required. O texto a ser exibido no botão. |
| Argumentos | cadeia (de caracteres) | verdadeiro | Required. Cadeia de argumentos definida pelo aplicativo que o aplicativo receberá posteriormente se o usuário clicar nesse botão. |
| ActivationType | ToastActivationType | falso | Controla o tipo de ativação que esse botão usará quando clicado. Por padrão, usa o Primeiro Plano. |
| ActivationOptions | ToastActivationOptions | falso | Recebe ou define opções adicionais relacionadas à ativação do botão de notificação. |
ToastActivationType
Decide o tipo de ativação que será usado quando o usuário interage com uma ação específica.
| Valor | Meaning |
|---|---|
| Foreground | Valor padrão. A sua aplicação em primeiro plano é iniciada. |
| Contexto geral | Sua tarefa em segundo plano correspondente (supondo que você configure tudo) é acionada e você pode executar código em segundo plano (como enviar a mensagem de resposta rápida do usuário) sem interromper o usuário. |
| Protocol | Inicie um aplicativo diferente usando a ativação de protocolo. |
ToastActivationOptions
Opções adicionais relacionadas com ativação.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| AfterActivationBehavior | ToastAfterActivationBehavior | falso | Obtém ou define o comportamento que o toast deve usar quando o utilizador invoca esta ação. Isso só funciona no Desktop, para ToastButton e ToastContextMenuItem. |
| ProtocolActivationTargetApplicationPfn | cadeia (de caracteres) | falso | Se você estiver usando ToastActivationType.Protocol, você pode, opcionalmente, especificar o PFN de destino, de modo que, independentemente de vários aplicativos estarem registrados para lidar com o mesmo uri de protocolo, o aplicativo desejado sempre será iniciado. |
ToastAfterActivationBehavior
Especifica o comportamento que o toast deve adotar quando o utilizador realiza uma ação no toast.
| Valor | Meaning |
|---|---|
| Predefinição | Comportamento padrão. A notificação do sistema será descartada quando o usuário executar uma ação na notificação do sistema. |
| PendingUpdate | Depois que o utilizador clicar num botão no seu toast, a notificação permanecerá presente, num estado visual de "atualização pendente". Você deve atualizar imediatamente sua notificação do sistema a partir de uma tarefa em segundo plano para que o usuário não veja esse estado visual de "atualização pendente" por muito tempo. |
ToastButtonSnooze
Implementa IToastButton
Um botão de soneca manipulado pelo sistema que lida automaticamente com o adiamento da notificação.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| CustomContent | cadeia (de caracteres) | falso | Texto personalizado opcional exibido no botão que substitui o texto local padrão "Snooze". |
ToastButtonDismiss
Implementa IToastButton
Um botão de descarte manipulado pelo sistema que descarta a notificação quando clicado.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| CustomContent | cadeia (de caracteres) | falso | Texto personalizado opcional a ser exibido no botão que substitui o texto padrão localizado "Descartar". |
ToastActionsSnoozeAndDismiss
Implementa IToastActions
Constrói automaticamente uma caixa de seleção para intervalos de soneca e botões de soneca/descarte, todos localizados automaticamente, e a lógica de soneca é automaticamente manipulada pelo sistema.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| ContextMenuItems | IList<ToastContextMenuItem> | falso | Itens personalizados do menu contextual, que fornecem ações adicionais se o utilizador clicar com o botão direito na notificação. Você só pode ter até 5 itens. |
ToastContextMenuItem
Uma entrada de menu de contexto.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Content | cadeia (de caracteres) | verdadeiro | Required. O texto a ser exibido. |
| Argumentos | cadeia (de caracteres) | verdadeiro | Required. Cadeia de caracteres de argumentos definida pelo aplicativo que o aplicativo pode recuperar posteriormente depois de ser ativada quando o usuário clica no item de menu. |
| ActivationType | ToastActivationType | falso | Controla o tipo de ativação que este item de menu usará quando clicado. Por padrão, usa o Primeiro Plano. |
| ActivationOptions | ToastActivationOptions | falso | Opções adicionais relacionadas com a ativação do item do menu contextual toast. |
ToastAudio
Especifique o áudio a ser reproduzido quando a notificação da aplicação for recebida.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Src | URI | falso | O arquivo de mídia a ser reproduzido no lugar do som padrão. Apenas ms-appx e ms-resource são suportados. Todo o resto (ms-appdata, http, C:, etc.) não é suportado. |
| Loop | Booleano | falso | Defina como verdadeiro se o som deve ser repetido enquanto a tostão for mostrada; falso para tocar apenas uma vez (padrão). |
| Silent | Booleano | falso | Verdadeiro para silenciar o som; Falso para permitir que o som de notificação da aplicação seja reproduzido (por padrão). |
ToastHeader
Um cabeçalho personalizado que agrupa várias notificações dentro do Centro de Notificações.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Id | cadeia (de caracteres) | verdadeiro | Um identificador criado pelo desenvolvedor que identifica exclusivamente esse cabeçalho. Se duas notificações tiverem o mesmo ID de cabeçalho, elas serão exibidas por baixo do mesmo cabeçalho no Centro de Notificações. |
| Título | cadeia (de caracteres) | verdadeiro | Um título para o cabeçalho. |
| Argumentos | cadeia (de caracteres) | verdadeiro | Obtém ou define uma cadeia de caracteres de argumentos definida pelo desenvolvedor que é retornada ao aplicativo quando o usuário clica nesse cabeçalho. Não pode ser nulo. |
| ActivationType | ToastActivationType | falso | Obtém ou define o tipo de ativação que esse cabeçalho usará quando clicado. Por padrão, usa o Primeiro Plano. Observe que apenas primeiro plano e protocolo são suportados. |
| ActivationOptions | ToastActivationOptions | falso | Obtém ou define opções adicionais relacionadas à ativação do cabeçalho de notificação. |
Tópicos relacionados
Windows developer