Partilhar via

Esquema de conteúdo do toast

O seguinte descreve todas as propriedades e elementos no conteúdo de notificação de ‘toast’.

Se preferir utilizar XML bruto em vez de usar a biblioteca de Notificações , consulte o esquema XML.

ToastContent

ToastContent

ToastContent é o objeto de nível superior que descreve o conteúdo de uma notificação, incluindo elementos visuais, ações e áudio.

Property Tipo Required Description
Launch cadeia (de caracteres) false 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 true Descreve a parte gráfica da notificação toast.
Actions IToastActions false Opcionalmente, crie ações personalizadas com botões e entradas.
Audio ToastAudio false Descreve a parte de áudio da notificação toast.
ActivationType ToastActivationType false Especifica qual tipo de ativação será usado quando o usuário clicar no corpo deste Toast.
ActivationOptions ToastActivationOptions false Novidades na Atualização dos Criadores: opções adicionais relacionadas a ativação da notificação toast.
Scenario ToastScenario false Declara o cenário para o qual o seu toast é utilizado, como um alarme ou lembrete.
DisplayTimestamp DateTimeOffset? false Novo na Atualização para criadores: substitua o carimbo de data/hora padrão por um carimbo de data/hora personalizado que represente quando o conteúdo da notificação foi realmente entregue, em vez da hora em que a notificação foi recebida pela plataforma Windows.
Header ToastHeader false Novo na Atualização para criadores: adicione um cabeçalho personalizado à sua notificação para agrupar várias notificações na Central de Ações.

ToastScenario

Especifica o cenário que a notificação representa.

Value Meaning
Default 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.

Property Tipo Required Description
BindingGeneric ToastBindingGeneric true 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 false Uma URL base predefinida que é combinada com URLs relativos em atributos de origem de imagem.
AddImageQuery bool? false Defina como "true" para permitir que o Windows adicione uma string de consulta à URL da imagem fornecida na notificação toast. 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) false 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.

Property Tipo Required Description
Children IList<IToastBindingGenericChild> false O conteúdo do corpo do Brinde, que pode incluir texto, imagens e grupos (adicionado na Atualização de aniversário). 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. Se você usar o AdaptiveGroup em dispositivos sem a Atualização de Aniversário, o conteúdo do grupo será simplesmente descartado.
AppLogoOverride ToastGenericAppLogo false Um logotipo opcional para substituir o logotipo do aplicativo.
HeroImage ToastGenericHeroImage false Uma imagem opcional de "herói" em destaque que é exibida no brinde e na Central de Ações.
Attribution ToastGenericAttributionText false Texto de atribuição opcional que será exibido na parte inferior da notificação do tipo toast.
BaseUri Uri false Uma URL base predefinida que é combinada com URLs relativos em atributos de origem de imagem.
AddImageQuery bool? false Defina como "true" para permitir que o Windows adicione uma string de consulta à URL da imagem fornecida na notificação toast. 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) false 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.

Implementations
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.

Property Tipo Required Description
Text string ou BindableString false O texto a ser exibido. Suporte à vinculação de dados adicionado na Atualização para criadores, mas só funciona para elementos de texto de nível superior.
HintStyle AdaptiveTextStyle false 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? false 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? false O número máximo de linhas que o elemento de texto pode exibir.
HintMinLines int? false 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 false O alinhamento horizontal do texto. Só funciona para elementos de texto dentro de um grupo/subgrupo.
Language cadeia (de caracteres) false 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 esse valor for uma referência de cadeia de caracteres, esse atributo assumirá como padrão a localidade escolhida pelo Tempo de Execução do Windows na resolução da cadeia de caracteres.

BindableString

Um valor de vinculação para cadeias de caracteres.

Property Tipo Required Description
BindingName cadeia (de caracteres) true 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.

Value Meaning
Default 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.
Body 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.
Title 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.
Header 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.

Value Meaning
Default Valor padrão. O alinhamento é determinado automaticamente pelo renderizador.
Auto 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.

Property Tipo Required Description
Source cadeia (de caracteres) true O URL para a imagem. MS-Appx, MS-AppData e HTTP são suportados. A partir da Fall Creators Update, as imagens da Web podem ter até 3 MB em conexões normais e 1 MB em conexões limitadas. Em dispositivos que ainda não executam a Atualização para Criadores de Outono, as imagens na web não devem ter mais de 200 KB.
HintCrop AdaptiveImageCrop false Novo na atualização de aniversário: controle o corte desejado da imagem.
HintRemoveMargin bool? false 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 false O alinhamento horizontal da imagem. Só funciona para imagens dentro de um grupo/subgrupo.
AlternateText cadeia (de caracteres) false Texto alternativo descrevendo a imagem, usado para fins de acessibilidade.
AddImageQuery bool? false Defina como "true" para permitir que o Windows adicione uma string de consulta à URL da imagem fornecida na notificação toast. 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.

Value Meaning
Default Valor padrão. Comportamento de corte determinado pelo renderizador.
None A imagem não é cortada.
Circle A imagem é cortada para uma forma de círculo.

AdaptiveImageAlign

Especifica o alinhamento horizontal de uma imagem.

Value Meaning
Default 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

Novo na Atualização de aniversário: os grupos identificam semanticamente que o conteúdo do grupo deve ser exibido como um todo ou não deve ser exibido se não for adequado. Os grupos também permitem a criação de várias colunas.

Property Tipo Required Description
Children < IList> false Os subgrupos são exibidos como colunas verticais. Você deve usar subgrupos para fornecer qualquer conteúdo dentro de um AdaptiveGroup.

AdaptiveSubgroup

Novo na Atualização de aniversário: os subgrupos são colunas verticais que podem conter texto e imagens.

Property Tipo Required Description
Children ILista<IAdaptiveSubgrupoElemento> false AdaptiveText e AdaptiveImage são filhos válidos de subgrupos.
HintWeight int? false Controle a largura desta coluna de subgrupo especificando o peso, em relação aos outros subgrupos.
HintTextStacking AdaptiveSubgroupTextStacking false Controle o alinhamento vertical do conteúdo deste subgrupo.

IAdaptiveSubgroupChild

Interface de marcador para crianças do subgrupo.

Implementations
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking especifica o alinhamento vertical do conteúdo.

Value Meaning
Default Valor padrão. O renderizador seleciona automaticamente o alinhamento vertical padrão.
Top Alinhamento vertical ao topo.
Center Alinhamento vertical ao centro.
Bottom Alinhamento vertical à parte inferior.

AdaptiveProgressBar

Novo na Atualização para criadores: uma barra de progresso. Suportado apenas em notificações do sistema na área de trabalho, compilação 15063 ou posterior.

Property Tipo Required Description
Title string ou BindableString false Obtém ou define uma cadeia de caracteres de título opcional. Suporta vinculação de dados.
Value duplo ou AdaptiveProgressBarValue ou BindableProgressBarValue false Obtém ou define o valor da barra de progresso. Suporta vinculação de dados. O valor padrão é 0.
ValueStringOverride string ou BindableString false 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.
Status string ou BindableString true 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.

Property Tipo Required Description
Value double false Obtém ou define o valor (0,0 - 1,0) que representa a porcentagem concluída.
IsIndeterminate bool false 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.

Property Tipo Required Description
BindingName cadeia (de caracteres) true Obtém ou define o nome que mapeia para o valor de dados de vinculação.

Um logotipo a ser exibido em vez do logotipo do aplicativo.

Property Tipo Required Description
Source cadeia (de caracteres) true 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 false Especifique como você gostaria que a imagem fosse cortada.
AlternateText cadeia (de caracteres) false Texto alternativo descrevendo a imagem, usado para fins de acessibilidade.
AddImageQuery bool? false Defina como "true" para permitir que o Windows adicione uma string de consulta à URL da imagem fornecida na notificação toast. 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.

Value Meaning
Default O recorte usa o comportamento padrão do renderizador.
None 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 na Central de Ações.

Property Tipo Required Description
Source cadeia (de caracteres) true 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) false Texto alternativo descrevendo a imagem, usado para fins de acessibilidade.
AddImageQuery bool? false Defina como "true" para permitir que o Windows adicione uma string de consulta à URL da imagem fornecida na notificação toast. 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

Texto de atribuição exibido na parte inferior da notificação do sistema.

Property Tipo Required Description
Text cadeia (de caracteres) true O texto a ser exibido.
Language cadeia (de caracteres) false 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.

Implementations
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.

Property Tipo Required Description
Inputs IList<IToastInput> false Entradas como caixas de texto e entradas de seleção. Só são permitidas até 5 entradas.
Buttons IList<IToastButton> false 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> false Novo na Atualização de Aniversário: itens de menu de contexto personalizados, fornecendo ações adicionais se o usuário clicar com o botão direito do mouse 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.

Implementations
ToastTextBox
ToastSelectionBox

ToastTextBox

Implementa IToastInput

Um controle de caixa de texto no qual o usuário pode digitar texto.

Property Tipo Required Description
Id cadeia (de caracteres) true 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.
Title cadeia (de caracteres) false Texto do título a ser exibido acima da caixa de texto.
PlaceholderContent cadeia (de caracteres) false 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) false O texto inicial a ser colocado na caixa de texto. Deixe isso nulo para uma caixa de texto em branco.

ToastSelectionBox

Implementa o IToastInput

Um controle de caixa de seleção, que permite que os usuários escolham a partir de uma lista suspensa de opções.

Property Tipo Required Description
Id cadeia (de caracteres) true 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) true 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).

Property Tipo Required Description
Id cadeia (de caracteres) true 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.
Title cadeia (de caracteres) false Texto do título a ser exibido acima da caixa de seleção.
DefaultSelectionBoxItemId cadeia (de caracteres) false 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).
Items IList<ToastSelectionBoxItem> false 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.

Implementations
ToastButton
ToastButtonSnooze
ToastButtonDismiss

ToastButton

Implementa IToastButton

Um botão em que o usuário pode clicar.

Property Tipo Required Description
Content cadeia (de caracteres) true Required. O texto a ser exibido no botão.
Arguments cadeia (de caracteres) true Required. Cadeia de argumentos definida pelo aplicativo que o aplicativo receberá posteriormente se o usuário clicar nesse botão.
ActivationType ToastActivationType false Controla o tipo de ativação que esse botão usará quando clicado. Por padrão, usa o Primeiro Plano.
ActivationOptions ToastActivationOptions false Novo no Creators Update: obtém 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.

Value Meaning
Foreground Valor padrão. A sua aplicação em primeiro plano é iniciada.
Background 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

Novo na Atualização para criadores: opções adicionais relacionadas à ativação.

Property Tipo Required Description
AfterActivationBehavior ToastAfterActivationBehavior false Novo na Atualização do Windows Fall Creators: Obtém ou define o comportamento que a notificação de alerta deve usar quando o utilizador invoca essa ação. Isso só funciona no Desktop, para ToastButton e ToastContextMenuItem.
ProtocolActivationTargetApplicationPfn cadeia (de caracteres) false 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.

Value Meaning
Default 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.

Property Tipo Required Description
CustomContent cadeia (de caracteres) false 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.

Property Tipo Required Description
CustomContent cadeia (de caracteres) false 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.

Property Tipo Required Description
ContextMenuItems IList<ToastContextMenuItem> false Novo na Atualização de Aniversário: itens de menu de contexto personalizados, fornecendo ações adicionais se o usuário clicar com o botão direito do mouse na notificação. Você só pode ter até 5 itens.

ToastContextMenuItem

Uma entrada de menu de contexto.

Property Tipo Required Description
Content cadeia (de caracteres) true Required. O texto a ser exibido.
Arguments cadeia (de caracteres) true 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 false Controla o tipo de ativação que este item de menu usará quando clicado. Por padrão, usa o Primeiro Plano.
ActivationOptions ToastActivationOptions false Novo na Atualização para Criadores: opções adicionais relacionadas à ativação do elemento de menu de contexto toast.

ToastAudio

Especifique o áudio a ser reproduzido quando a notificação Toast for recebida.

Property Tipo Required Description
Src uri false 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 boolean false Defina como verdadeiro se o som deve ser repetido enquanto a tostão for mostrada; falso para tocar apenas uma vez (padrão).
Silent boolean false Verdadeiro para silenciar o som; Falso para permitir que o som da notificação toast seja reproduzido (padrão).

ToastHeader

Novo na Atualização para criadores: um cabeçalho personalizado que agrupa várias notificações na Central de Ações.

Property Tipo Required Description
Id cadeia (de caracteres) true 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 abaixo do mesmo cabeçalho na Central de Ações.
Title cadeia (de caracteres) true Um título para o cabeçalho.
Arguments cadeia (de caracteres) true 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 false 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 false Obtém ou define opções adicionais relacionadas à ativação do cabeçalho de notificação.
  • Last updated on