toast (Esquema XML do Sistema)

  • Artigo

Elemento toast base, que contém pelo menos um único elemento visual .

Hierarquia de elementos

<Brinde>

Syntax

<toast launch?   = string
      duration? = "long" | "short" 
      displayTimeStamp? = string
      scenario? = "reminder" | "alarm" | "incomingCall" | "urgent" 
      useButtonStyle? = boolean>

  <!-- Child elements -->
  visual,
  audio?,
  commands?
  actions?
  header?
</toast>

Chave

? opcional (zero ou um)

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Valor padrão
duration

A quantidade de tempo que o sistema deve exibir.

Esse atributo pode ter um dos seguintes valores:

  • long
  • short
 Não Nenhum
launch

Uma cadeia de caracteres que é passada para o aplicativo quando ele é ativado pela notificação do sistema. O formato e o conteúdo dessa cadeia de caracteres são definidos pelo aplicativo para seu uso próprio. Quando o usuário toca ou clica na notificação do sistema para iniciar o aplicativo associado, a cadeia de caracteres de inicialização fornece o contexto ao aplicativo que o permite mostrar ao usuário uma exibição relevante para o conteúdo da notificação do sistema, em vez de inicializar em sua maneira padrão.

 string Não Nenhum
displayTimestamp

Introduzido na Atualização de Criadores: substitui o carimbo de data/hora padrão por um carimbo de data/hora personalizado que representa quando o conteúdo da notificação foi realmente entregue, em vez do momento em que a notificação foi recebida pela plataforma Windows. Esse valor deve ser uma cadeia de caracteres formatada usando o padrão ISO 8601.

 string Não Nenhum
scenario

O cenário para o qual o sistema é usado, como um alarme ou lembrete.

  • "lembrete" – uma notificação de lembrete. Isso será exibido previamente expandido e permanece na tela do usuário até ser ignorado. Observe que isso será silenciosamente ignorado, a menos que haja uma ação de botão do sistema que seja ativada em segundo plano.
  • "alarme" – uma notificação de alarme. Isso será exibido previamente expandido e permanece na tela do usuário até ser ignorado. O áudio fará um loop por padrão e usará o áudio de alarme.
  • "incomingCall" – uma notificação de chamada de entrada. Isso será exibido previamente expandido em um formato de chamada especial e permanece na tela do usuário até ser ignorado. O áudio fará um loop por padrão e usará o áudio de toque.
  • "urgente" – uma notificação importante. Isso permite que os usuários tenham mais controle sobre quais aplicativos podem enviar notificações do sistema de alta prioridade que podem interromper o Assistente de Foco (Não Incomodar). Isso pode ser modificado nas configurações de notificações.

 string Não Nenhum
useButtonStyle

Especifica se os botões estilizados devem ser usados. O estilo do botão é determinado pelo atributo **hint-buttonStyle** do elemento de ação .

 booleano No false

 

Elementos filho

Elemento filho Descrição
áudio

Especifica um som a ser reproduzido quando uma notificação do sistema é exibida. Esse elemento também permite que você ative o mudo de qualquer áudio de notificação do sistema.
commands

Especifica que a notificação do sistema está sendo usada para indicar uma chamada de entrada ou um alarme, com comandos apropriados associados a cada cenário.
Visual

Contém um único elemento de associação que define um sistema.
actions

Elemento container para declarar até cinco entradas e até cinco ações de botão para a notificação do sistema.
cabeçalho

Introduzido no Creators Update. Especifica um cabeçalho personalizado que agrupa várias notificações na Central de Ações.

 

Elementos pai

Esse elemento mais externo (documento) pode não estar contido em nenhum outro elemento.

Confira também