toast (Esquema XML do Sistema)

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

• Conteúdo da notificação do sistema
• Visualizador de notificações