avviso popup (XML Schema popup)

Articolo
09/03/2023

Elemento avviso popup di base, che contiene almeno un singolo elemento visivo .

Gerarchia degli elementi

<toast>

Sintassi

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

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

Chiave

? facoltativo (zero o uno)

Attributi ed elementi

Attributi

Attributo	Descrizione	Tipo di dati	Obbligatoria	Valore predefinito
duration	Il tempo di visualizzazione dell'avviso popup.	Questo attributo può avere uno dei valori seguenti: long short	No	nessuno
avvio	Stringa che viene passata all'applicazione quando viene attivata dall'avviso popup. Il formato e il contenuto di questa stringa sono definiti dall'app per il proprio uso. Quando l'utente tocca o fa clic sull'avviso popup per avviare l'app associata, la stringa di avvio fornisce il contesto all'app che consente di mostrare all'utente una visualizzazione rilevante per il contenuto dell'avviso popup, invece di eseguire l'avvio nel modo predefinito.	string	No	nessuno
displayTimestamp	Introdotta in Creators Update: esegue l'override del timestamp predefinito con un timestamp personalizzato che rappresenta quando il contenuto della notifica è stato effettivamente recapitato, anziché l'ora in cui la notifica è stata ricevuta dalla piattaforma Windows. Questo valore deve essere formattato con lo standard ISO 8601.	string	No	nessuno
Scenario	Lo scenario per cui viene usato l'avviso popup, ad esempio un allarme o un promemoria. "promemoria" - Notifica di promemoria. Questa operazione verrà visualizzata in modo pre-espanso e rimarrà sullo schermo dell'utente fino a quando non viene ignorata. Si noti che questa operazione verrà ignorata in modo automatico, a meno che non sia presente un'azione del pulsante popup che attiva in background. "allarme" - Notifica di allarme. Questa operazione verrà visualizzata in modo pre-espanso e rimarrà sullo schermo dell'utente fino a quando non viene ignorata. L'audio verrà eseguito per impostazione predefinita e userà l'audio dell'allarme. "incomingCall" - Notifica di chiamata in ingresso. Verrà visualizzato in modo pre-espanso in un formato di chiamata speciale e rimanere sullo schermo dell'utente fino a quando non viene ignorato. L'audio verrà eseguito per impostazione predefinita e userà l'audio del suoneria. "urgente" - Una notifica importante. Ciò consente agli utenti di avere un maggiore controllo sulle app che possono inviare notifiche di tipo avviso popup con priorità elevata che possono superare Focus Assist (Non disturbare). Questa operazione può essere modificata nelle impostazioni delle notifiche.	string	No	nessuno
useButtonStyle	Specifica se devono essere usati pulsanti in stile. Lo stile del pulsante è determinato dall'attributo hint-buttonStyle dell'elemento action .	boolean	No	false

Elementi figlio

Elemento figlio	Descrizione
Audio	Specifica un suono da riprodurre quando viene visualizzata una notifica di tipo avviso popup. Questo elemento consente anche di disattivare qualsiasi audio di notifica popup.
Comandi	Specifica che la notifica di tipo avviso popup viene usata per indicare una chiamata in ingresso o un allarme, con comandi appropriati associati a ogni scenario.
Visual	Contiene un singolo elemento di associazione che definisce un avviso popup.
actions	Elemento Contenitore per dichiarare fino a cinque input e fino a cinque azioni pulsante per la notifica di tipo avviso popup.
Intestazione	Introdotta in Creators Update. Specifica un'intestazione personalizzata che raggruppa più notifiche all'interno del Centro azioni.

Elementi padre

Questo elemento più esterno (documento) potrebbe non essere contenuto da altri elementi.