avviso popup (XML Schema popup)

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.

Vedi anche