Condividi tramite

Schema del contenuto delle notifiche dell'app

Di seguito vengono descritte tutte le proprietà e gli elementi all'interno del contenuto dell'avviso popup.

Se si preferisce usare codice XML non elaborato anziché le API del generatore di SDK per app di Windows, vedere the XML Schema.

ToastContent

ToastContent

ToastContent è l'oggetto di primo livello che descrive il contenuto di una notifica, inclusi oggetti visivi, azioni e audio.

Proprietà Tipo Obbligatorio Descrizione
Launch string falso Stringa passata all'applicazione quando viene attivata dal Toast. Il formato e il contenuto di questa stringa sono definiti dall'app per il proprio uso. Quando l'utente tocca o fa clic sul Toast per avviare l'app associata, la stringa di avvio fornisce all'app il contesto necessario per mostrare all'utente una visualizzazione pertinente al contenuto del Toast, anziché avviarla nel modo predefinito.
Visual ToastVisual true Descrive la parte visiva della notifica dell'app.
Azioni IToastActions falso Facoltativamente, creare azioni personalizzate con pulsanti e input.
Audio ToastAudio falso Descrive la parte audio della notifica dell'app.
TipoDiAttivazione ToastActivationType falso Specifica il tipo di attivazione che verrà utilizzato quando l'utente fa clic sul corpo della notifica.
ActivationOptions ToastActivationOptions falso Opzioni aggiuntive relative all'attivazione della notifica dell'app.
Scenario ToastScenario falso Dichiara lo scenario per cui viene utilizzata la notifica, come ad esempio un allarme o un promemoria.
DisplayTimestamp DateTimeOffset? falso Eseguire 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.
Intestazione ToastHeader falso Aggiungere un'intestazione personalizzata alla notifica per raggruppare più notifiche all'interno del Centro notifiche.

ToastScenario

Specifica lo scenario rappresentato dall'avviso popup.

Valore Meaning
Predefinita Il comportamento normale della notifica toast.
Reminder Una notifica di promemoria. Verrà visualizzato in modo pre-espanso e rimarrà sullo schermo dell'utente fino a quando non viene ignorato.
Alarm Una notifica di allarme. Verrà visualizzato in modo pre-espanso e rimarrà sullo schermo dell'utente fino a quando non viene ignorato. Per impostazione predefinita, l'audio si ripeterà e userà l'audio dell'allarme.
IncomingCall Notifica di chiamata in arrivo. Questa operazione verrà visualizzata in modo pre-espanso in un formato di chiamata speciale e rimarrà sullo schermo dell'utente fino a quando non viene chiusa. L'audio si ripeterà per impostazione predefinita e userà l'audio della suoneria.

ToastVisual

La parte visiva degli avvisi popup contiene le associazioni, che contengono testo, immagini, contenuto adattivo e altro ancora.

Proprietà Tipo Obbligatorio Descrizione
BindingGeneric ToastBindingGeneric true Associazione generica di tipo toast, che può essere visualizzata su tutti i dispositivi. Questa associazione è obbligatoria e non può essere nulla.
BaseUri Uri falso Un URL di base predefinito che viene combinato con URL relativi negli attributi di origine delle immagini.
AddImageQuery bool? falso Impostare su "true" per consentire Windows di aggiungere una stringa di query all'URL dell'immagine fornito nella notifica dell'app. Usare questo attributo se il server ospita immagini e può gestire le stringhe di query recuperando una variante di immagine in base alle stringhe di query o ignorando la stringa di query e restituendo l'immagine come specificato senza la stringa di query. Questa stringa di query specifica la scalabilità, l'impostazione di contrasto e il linguaggio; ad esempio, il valore "www.website.com/images/hello.png" specificato nella notifica diventa "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Language string falso La località di destinazione delle risorse visive, quando si utilizzano risorse localizzate, è specificata come tag di lingua BCP-47, ad esempio "en-US" o "fr-FR". Queste impostazioni locali vengono sostituite da tutte le impostazioni locali specificate nel vincolamento o nel testo. Se non specificato, verranno invece usate le impostazioni locali di sistema.

ToastBindingGeneric

Il binding generico è il binding predefinito per i toast ed è dove si specificano il testo, le immagini, il contenuto adattivo e altro ancora.

Proprietà Tipo Obbligatorio Descrizione
Bambini IList<IToastBindingGenericChild> falso Contenuto del corpo della notifica Toast, che può includere testo, immagini e gruppi. Gli elementi di testo devono venire prima di qualsiasi altro elemento e sono supportati solo 3 elementi di testo. Se un elemento di testo viene posizionato dopo qualsiasi altro elemento, verrà trascinato nella parte superiore o eliminato. Infine, alcune proprietà di testo come HintStyle non sono supportate negli elementi di testo figli della radice e funzionano solo all'interno di un AdaptiveSubgroup.
AppLogoOverride ToastGenericAppLogo falso Logo facoltativo per sostituire il logo dell'app.
HeroImage ToastGenericHeroImage falso Immagine "hero" facoltativa visualizzata nella notifica toast e nel Centro notifiche.
Attribution ToastGenericAttributionText falso Testo di attribuzione facoltativo che verrà visualizzato nella parte inferiore della notifica dell'app.
BaseUri Uri falso Un URL di base predefinito che viene combinato con URL relativi negli attributi di origine delle immagini.
AddImageQuery bool? falso Impostare su "true" per consentire Windows di aggiungere una stringa di query all'URL dell'immagine fornito nella notifica dell'app. Usare questo attributo se il server ospita immagini e può gestire le stringhe di query recuperando una variante di immagine in base alle stringhe di query o ignorando la stringa di query e restituendo l'immagine come specificato senza la stringa di query. Questa stringa di query specifica la scalabilità, l'impostazione di contrasto e il linguaggio; ad esempio, il valore "www.website.com/images/hello.png" specificato nella notifica diventa "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"
Language string falso La località di destinazione delle risorse visive, quando si utilizzano risorse localizzate, è specificata come tag di lingua BCP-47, ad esempio "en-US" o "fr-FR". Queste impostazioni locali vengono sostituite da tutte le impostazioni locali specificate nel vincolamento o nel testo. Se non specificato, verranno invece usate le impostazioni locali di sistema.

IToastBindingGenericChild

Interfaccia di marcatura per elementi child di tipo toast che includono testo, immagini, gruppi e altro ancora.

Implementazioni
AdaptiveText
AdaptiveImage
AdaptiveGroup
AdaptiveProgressBar

AdaptiveText

Elemento di testo adattivo. Se posizionato nel livello superiore ToastBindingGeneric.Children, verrà applicato solo HintMaxLines. Tuttavia, se viene inserito come elemento figlio di un gruppo o di un sottogruppo, è supportato lo stile full-text.

Proprietà Tipo Obbligatorio Descrizione
Text stringa o BindableString falso Testo da visualizzare. Il data binding funziona solo per gli elementi di testo di primo livello.
HintStyle AdaptiveTextStyle falso Lo stile controlla la dimensione del carattere, lo spessore e l'opacità del testo. Funziona solo per gli elementi di testo all'interno di un gruppo/sottogruppo.
HintWrap bool? falso Impostare questo su true per abilitare l'a capo automatico del testo. Gli elementi di testo di primo livello ignorano questa proprietà e incapsulano sempre (è possibile usare HintMaxLines = 1 per disabilitare il wrapping per gli elementi di testo di primo livello). Per impostazione predefinita, gli elementi di testo all'interno di gruppi/sottogruppi sono impostati su "falso" per il wrapping.
HintMaxLines int? falso Il numero massimo di righe consentite per la visualizzazione dell'elemento di testo.
HintMinLines int? falso Numero minimo di righe che l'elemento di testo deve visualizzare. Funziona solo per gli elementi di testo all'interno di un gruppo/sottogruppo.
HintAlign AdaptiveTextAlign falso Allineamento orizzontale del testo. Funziona solo per gli elementi di testo all'interno di un gruppo/sottogruppo.
Language string falso La locale di destinazione del payload XML, specificata come tag di lingua BCP-47, ad esempio "en-US" o "fr-FR". Le impostazioni locali specificate qui sostituiscono qualsiasi altra impostazione locale specificata, ad esempio quella nel contesto dell'associazione o nella visualizzazione. Se questo valore è una stringa letterale, per impostazione predefinita questo attributo corrisponde alla lingua dell'interfaccia utente dell'utente. Se questo valore è un riferimento stringa, per impostazione predefinita questo attributo corrisponde alle impostazioni locali scelte da Windows Runtime per risolvere la stringa.

BindableString

Valore di associazione per le stringhe.

Proprietà Tipo Obbligatorio Descrizione
BindingName string true Ottiene o imposta il nome che crea una corrispondenza con il tuo valore di dati di associazione.

AdaptiveTextStyle

Lo stile del testo controlla le dimensioni, lo spessore e l'opacità del carattere. La leggera opacità è 60 opaco%.

Valore Meaning
Predefinita Valore predefinito. Lo stile è determinato dal renderer.
didascalia Dimensione del carattere più piccola rispetto a quella del paragrafo.
CaptionSubtle Uguale a Caption ma con opacità sottile.
Corpo Dimensioni del carattere del paragrafo.
BodySubtle Uguale a Corpo ma con opacità sottile.
Base Dimensione del carattere del paragrafo, spessore del grassetto. Essenzialmente la versione in grassetto di Corpo.
BaseSubtle Uguale a Base ma con opacità sottile.
Subtitle Dimensioni del carattere H4.
SubtitleSubtle Uguale a Sottotitolo ma con opacità sottile.
Titolo Dimensioni del carattere H3.
TitleSubtle Uguale a Title ma con opacità sottile.
TitleNumeral Uguale al Titolo ma con i margini superiori/inferiori rimossi.
Subheader Dimensioni del carattere H2.
SubheaderSubtle Uguale a Subheader ma con opacità sottile.
SubheaderNumeral Uguale a Subheader ma con spaziatura interna superiore/inferiore rimossa.
Intestazione Dimensioni del carattere H1.
HeaderSubtle Uguale a Header ma con opacità sottile.
HeaderNumeral Uguale a Intestazione ma con spaziatura interna superiore/inferiore rimossa.

AdaptiveTextAlign

Controlla l'allineamento orizzontale del testo.

Valore Meaning
Predefinita Valore predefinito. L'allineamento viene determinato automaticamente dal renderer.
Auto Allineamento determinato dalla lingua e dalla cultura correnti.
Left Allinea orizzontalmente il testo a sinistra.
Center Allinea orizzontalmente il testo al centro.
Right Allinea orizzontalmente il testo a destra.

AdaptiveImage

Un'immagine in linea.

Proprietà Tipo Obbligatorio Descrizione
Fonte string true URL dell'immagine. ms-appx, ms-appdata e http sono supportati. Le immagini Web possono avere dimensioni fino a 3 MB per le connessioni normali e 1 MB per le connessioni a consumo.
HintCrop AdaptiveImageCrop falso Controllare il ritaglio desiderato dell'immagine.
HintRemoveMargin bool? falso Per impostazione predefinita, le immagini all'interno di gruppi/sottogruppi hanno un margine di 8 px intorno a esse. È possibile rimuovere questo margine impostando questa proprietà su true.
HintAlign AdaptiveImageAlign falso Allineamento orizzontale dell'immagine. Funziona solo per le immagini all'interno di un gruppo/sottogruppo.
AlternateText string falso Testo alternativo che descrive l'immagine, usata a scopo di accessibilità.
AddImageQuery bool? falso Impostare su "true" per consentire Windows di aggiungere una stringa di query all'URL dell'immagine fornito nella notifica dell'app. Usare questo attributo se il server ospita immagini e può gestire le stringhe di query recuperando una variante di immagine in base alle stringhe di query o ignorando la stringa di query e restituendo l'immagine come specificato senza la stringa di query. Questa stringa di query specifica la scalabilità, l'impostazione di contrasto e il linguaggio; ad esempio, il valore "www.website.com/images/hello.png" specificato nella notifica diventa "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

AdaptiveImageCrop

Specifica il ritaglio desiderato dell'immagine.

Valore Meaning
Predefinita Valore predefinito. Comportamento di ritaglio determinato dal renderer.
Nessuno L'immagine non è ritagliata.
Circle L'immagine viene ritagliata in una forma circolare.

AdaptiveImageAlign

Specifica l'allineamento orizzontale per un'immagine.

Valore Meaning
Predefinita Valore predefinito. Comportamento di allineamento determinato dal renderer.
Stretch L'immagine si estende per occupare l'intera larghezza disponibile (e potenzialmente anche l'altezza disponibile, a seconda di dove è collocata).
Left Allineare l'immagine a sinistra, visualizzandola alla sua risoluzione nativa.
Center Allineare l'immagine al centro orizzontalmente, visualizzando l'immagine alla risoluzione nativa.
Right Allineare l'immagine a destra, visualizzando l'immagine alla risoluzione nativa.

AdaptiveGroup

I gruppi identificano semanticamente che il contenuto del gruppo deve essere visualizzato nel suo complesso oppure non deve essere visualizzato se non è in grado di adattarsi. I gruppi consentono anche di creare più colonne.

Proprietà Tipo Obbligatorio Descrizione
Bambini IList<AdaptiveSubgroup> falso I sottogruppi vengono visualizzati come colonne verticali. È necessario usare i sottogruppi per fornire qualsiasi contenuto all'interno di un adaptivegroup.

AdaptiveSubgroup

I sottogruppi sono colonne verticali che possono contenere testo e immagini.

Proprietà Tipo Obbligatorio Descrizione
Bambini IList<IAdaptiveSubgroupChild> falso AdaptiveText e AdaptiveImage sono elementi figli validi dei sottogruppi.
HintWeight int? falso Controllare la larghezza della colonna di questo sottogruppo specificando il peso in relazione agli altri sottogruppi.
HintTextStacking AdaptiveSubgroupTextStacking falso Controllare l'allineamento verticale del contenuto del sottogruppo.

IAdaptiveSubgroupChild

Interfaccia di marcatura per i figli del sottogruppo.

Implementazioni
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking specifica l'allineamento verticale del contenuto.

Valore Meaning
Predefinita Valore predefinito. Il renderer seleziona automaticamente l'allineamento verticale predefinito.
Top Allinea verticalmente alla parte superiore.
Center Allinea verticalmente al centro.
Bottom Allineamento verticale verso il basso.

AdaptiveProgressBar

Barra di avanzamento. Supportato solo sul desktop.

Proprietà Tipo Obbligatorio Descrizione
Titolo stringa o BindableString falso Ottiene o imposta una stringa di titolo facoltativa. Supporta il data binding.
Valore double oppure AdaptiveProgressBarValue oppure BindableProgressBarValue falso Ottiene o imposta il valore della barra di avanzamento. Supporta il data binding. Il valore predefinito è 0.
ValueStringOverride stringa o BindableString falso Ottiene o imposta una stringa facoltativa da visualizzare anziché la stringa percentuale predefinita. Se non viene specificato, verrà visualizzato un messaggio simile a "70%".
Stato stringa o BindableString true Ottiene o imposta una stringa di stato (obbligatoria), visualizzata sotto la barra di stato a sinistra. Questa stringa deve riflettere lo stato dell'operazione, ad esempio "Download..." o "Installazione..."

AdaptiveProgressBarValue

Classe che rappresenta il valore della barra di avanzamento.

Proprietà Tipo Obbligatorio Descrizione
Valore double falso Ottiene o imposta il valore (0,0 - 1,0) che rappresenta la percentuale di completamento.
IsIndeterminate bool falso Ottiene o imposta un valore che indica se la barra di avanzamento è indeterminata. Se questo è vero, Valore verrà ignorato.

BindableProgressBarValue

Valore associabile della barra di progresso.

Proprietà Tipo Obbligatorio Descrizione
BindingName string true Ottiene o imposta il nome che crea una corrispondenza con il tuo valore di dati di associazione.

Logo da visualizzare anziché il logo dell'app.

Proprietà Tipo Obbligatorio Descrizione
Fonte string true URL dell'immagine. ms-appx, ms-appdata e http sono supportati. Le immagini HTTP devono avere dimensioni pari o inferiori a 200 KB.
HintCrop ToastGenericAppLogoCrop falso Specificare la modalità di ritaglio dell'immagine.
AlternateText string falso Testo alternativo che descrive l'immagine, usata a scopo di accessibilità.
AddImageQuery bool? falso Impostare su "true" per consentire Windows di aggiungere una stringa di query all'URL dell'immagine fornito nella notifica dell'app. Usare questo attributo se il server ospita immagini e può gestire le stringhe di query recuperando una variante di immagine in base alle stringhe di query o ignorando la stringa di query e restituendo l'immagine come specificato senza la stringa di query. Questa stringa di query specifica la scalabilità, l'impostazione di contrasto e il linguaggio; ad esempio, il valore "www.website.com/images/hello.png" specificato nella notifica diventa "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

ToastGenericAppLogoCrop

Controlla il ritaglio dell'immagine del logo dell'app.

Valore Meaning
Predefinita Il ritaglio usa il comportamento predefinito del renderer.
Nessuno L'immagine non viene ritagliata, mostrata in formato quadrato.
Circle L'immagine è ritagliata a forma di cerchio.

ToastGenericHeroImage

Immagine "hero" in primo piano visualizzata nell'avviso popup e nel Centro notifiche.

Proprietà Tipo Obbligatorio Descrizione
Fonte string true URL dell'immagine. ms-appx, ms-appdata e http sono supportati. Le immagini HTTP devono avere dimensioni pari o inferiori a 200 KB.
AlternateText string falso Testo alternativo che descrive l'immagine, usata a scopo di accessibilità.
AddImageQuery bool? falso Impostare su "true" per consentire Windows di aggiungere una stringa di query all'URL dell'immagine fornito nella notifica dell'app. Usare questo attributo se il server ospita immagini e può gestire le stringhe di query recuperando una variante di immagine in base alle stringhe di query o ignorando la stringa di query e restituendo l'immagine come specificato senza la stringa di query. Questa stringa di query specifica la scalabilità, l'impostazione di contrasto e il linguaggio; ad esempio, il valore "www.website.com/images/hello.png" specificato nella notifica diventa "www.website.com/images/hello.png?ms-scale=100&ms-contrast=standard&ms-lang=en-us"

ToastGenericAttributionText

Testo di attribuzione visualizzato nella parte inferiore della notifica dell'app.

Proprietà Tipo Obbligatorio Descrizione
Text string true Testo da visualizzare.
Language string falso La località di destinazione delle risorse visive, quando si utilizzano risorse localizzate, è specificata come tag di lingua BCP-47, ad esempio "en-US" o "fr-FR". Se non specificato, verranno invece usate le impostazioni locali di sistema.

IToastActions

Interfaccia dell'indicatore per azioni/input di tipo avviso popup.

Implementazioni
ToastActionsCustom
ToastActionsSnoozeAndDismiss

ToastActionsCustom

Implementa IToastActions

Creare azioni e input personalizzati usando controlli come pulsanti, caselle di testo e input di selezione.

Proprietà Tipo Obbligatorio Descrizione
Inputs IList<IToastInput> falso Input come ad esempio caselle di testo e di selezione. È consentito un massimo di 5 voci.
pulsanti IList<IToastButton> falso I pulsanti vengono visualizzati dopo tutti gli input (o adiacenti a un input se il pulsante viene usato come pulsante di risposta rapida). Sono consentiti solo fino a 5 pulsanti (o meno se sono presenti anche voci di menu di scelta rapida).
ContextMenuItems IList<ToastContextMenuItem> falso Voci di menu di scelta rapida personalizzate, fornendo azioni aggiuntive se l'utente fa clic con il pulsante destro del mouse sulla notifica. È possibile avere fino a 5 pulsanti e voci di menu di scelta rapida combinate.

IToastInput

Interfaccia dell'indicatore per gli input di tipo avviso popup.

Implementazioni
ToastTextBox
ToastSelectionBox

ToastTextBox

Implementa IToastInput

Controllo casella di testo in cui l'utente può digitare testo.

Proprietà Tipo Obbligatorio Descrizione
ID string true L'ID è obbligatorio e viene usato per eseguire il mapping del testo immesso dall'utente in una coppia chiave-valore di ID/valore utilizzata successivamente dall'app.
Titolo string falso Testo del titolo da visualizzare sopra la casella di testo.
PlaceholderContent string falso Testo segnaposto da visualizzare nella casella di testo quando l'utente non ha ancora digitato testo.
DefaultInput string falso Testo iniziale da inserire nella casella di testo. Lascia nullo questo campo per avere una casella di testo vuota.

ToastSelectionBox

Implementa IToastInput

Un controllo di selezione, che consente agli utenti di scegliere da un menu a tendina.

Proprietà Tipo Obbligatorio Descrizione
ID string true L'ID è obbligatorio. Se l'utente seleziona questo elemento, questo ID verrà restituito al codice della tua app, rappresentando la selezione effettuata.
Content string true Il contenuto è obbligatorio ed è una stringa visualizzata nell'elemento di selezione.

ToastSelectionBoxItem

Elemento della casella di selezione (elemento che l'utente può selezionare dall'elenco a discesa).

Proprietà Tipo Obbligatorio Descrizione
ID string true L'ID è obbligatorio e viene usato per eseguire il mapping del testo immesso dall'utente in una coppia chiave-valore di ID/valore utilizzata successivamente dall'app.
Titolo string falso Testo del titolo da visualizzare sopra la casella di selezione.
DefaultSelectionBoxItemId string falso Questo controlla quale elemento viene selezionato per impostazione predefinita e si riferisce alla proprietà Id del ToastSelectionBoxItem. Se non si specifica questa opzione, la selezione predefinita sarà vuota (l'utente non vede nulla).
Elementi IList<ToastSelectionBoxItem> falso Elementi di selezione tra cui l'utente può scegliere in questo SelectionBox. È possibile aggiungere solo 5 elementi.

IToastButton

Interfaccia segnaposto per pulsanti di notifica.

Implementazioni
ToastButton
ToastButtonSnooze
ToastButtonDismiss

ToastButton

Implementa IToastButton

Pulsante su cui l'utente può fare clic.

Proprietà Tipo Obbligatorio Descrizione
Content string true Obbligatorio. Testo da visualizzare sul pulsante.
Argomenti string true Obbligatorio. Stringa di argomenti definita dall'app che l'app riceverà successivamente se l'utente fa clic su questo pulsante.
TipoDiAttivazione ToastActivationType falso Controlla il tipo di attivazione che questo pulsante userà quando si fa clic. Il valore predefinito è Foreground.
ActivationOptions ToastActivationOptions falso Ottiene o imposta opzioni aggiuntive relative all'attivazione del pulsante di avviso toast.

ToastActivationType

Decide il tipo di attivazione che verrà usato quando l'utente interagisce con un'azione specifica.

Valore Meaning
Foreground Valore predefinito. L'app in primo piano è stata avviata.
Sfondo L'attività in background corrispondente (presupponendo che tutto sia configurato) viene attivata ed è possibile eseguire il codice in background (ad esempio l'invio del messaggio di risposta rapida dell'utente) senza interrompere l'utente.
Protocollo Avviare un'app diversa usando l'attivazione del protocollo.

ToastActivationOptions

Opzioni aggiuntive relative all'attivazione.

Proprietà Tipo Obbligatorio Descrizione
AfterActivationBehavior ToastAfterActivationBehavior falso Ottiene o imposta il comportamento che l'avviso popup deve utilizzare quando l'utente richiama questa azione. Questo funziona solo su Desktop, per ToastButton e ToastContextMenuItem.
ProtocolActivationTargetApplicationPfn string falso Se usi ToastActivationType.Protocol, puoi facoltativamente specificare il pfn di destinazione, in modo che indipendentemente dal fatto che più app siano registrate per gestire lo stesso URI di protocollo, l'app desiderata verrà sempre avviata.

ToastAfterActivationBehavior

Specifica il comportamento che l'avviso popup deve utilizzare quando l'utente esegue un'azione sull'avviso popup.

Valore Meaning
Predefinita Comportamento predefinito. L'avviso popup verrà ignorato quando l'utente esegue un'azione sull'avviso popup.
PendingUpdate Dopo che l'utente fa clic su un pulsante nel toast, la notifica resterà visibile, in uno stato di visualizzazione "aggiornamento in sospeso". È consigliabile aggiornare immediatamente la notifica da un processo in background in modo che l'utente non visualizzi lo stato "aggiornamento in sospeso" per troppo tempo.

ToastButtonSnooze

Implementa IToastButton

Pulsante di snooze gestito dal sistema che si occupa automaticamente del rinvio della notifica.

Proprietà Tipo Obbligatorio Descrizione
CustomContent string falso Testo personalizzato facoltativo visualizzato sul pulsante che sostituisce il testo "Snooze" localizzato predefinito.

ToastButtonDismiss

Implementa IToastButton

Pulsante di chiusura gestito dal sistema che ignora la notifica quando si fa clic.

Proprietà Tipo Obbligatorio Descrizione
CustomContent string falso Testo personalizzato facoltativo visualizzato sul pulsante che sostituisce il testo "Ignora" localizzato predefinito.

ToastActionsSnoozeAndDismiss

*Implementa IToastActions

Costruisce automaticamente una casella di selezione per gli intervalli di posticipo e i pulsanti di posticipo/disattiva, tutti automaticamente localizzati, e la logica del posticipo viene gestita automaticamente dal sistema.

Proprietà Tipo Obbligatorio Descrizione
ContextMenuItems IList<ToastContextMenuItem> falso Voci di menu di scelta rapida personalizzate, fornendo azioni aggiuntive se l'utente fa clic con il pulsante destro del mouse sulla notifica. È possibile avere fino a 5 elementi.

ToastContextMenuItem

Elemento di menu di scelta rapida.

Proprietà Tipo Obbligatorio Descrizione
Content string true Obbligatorio. Testo da visualizzare.
Argomenti string true Obbligatorio. Stringa definita dall'app di argomenti che l'app può recuperare in un secondo momento dopo l'attivazione quando l'utente fa clic sulla voce di menu.
TipoDiAttivazione ToastActivationType falso Controlla il tipo di attivazione che verrà usata da questa voce di menu quando si fa clic. Il valore predefinito è Foreground.
ActivationOptions ToastActivationOptions falso Opzioni aggiuntive relative all'attivazione dell'elemento del menu contestuale del toast.

ToastAudio

Specificare l'audio da riprodurre quando viene ricevuta la notifica dell'app.

Proprietà Tipo Obbligatorio Descrizione
Src URI falso Il file multimediale da riprodurre al posto del suono predefinito. Sono supportati solo ms-appx e ms-resource. Tutto il resto (ms-appdata, http, C:e così via) non è supportato.
Loop boolean falso Impostare su true se il suono deve essere ripetuto finché l'avviso Toast è mostrato; false per la riproduzione una sola volta (impostazione predefinita).
Silent boolean falso True per disattivare il suono; false per consentire la riproduzione del suono di notifica dell'app (impostazione predefinita).

ToastHeader

Intestazione personalizzata che raggruppa più notifiche all'interno del Centro notifiche.

Proprietà Tipo Obbligatorio Descrizione
ID string true Identificatore creato dallo sviluppatore che identifica questa intestazione in modo univoco. Se due notifiche hanno lo stesso ID intestazione, verranno visualizzate sotto la stessa intestazione nel Centro notifiche.
Titolo string true Titolo per l'intestazione.
Argomenti string true Ottiene o imposta una stringa di argomenti definita dallo sviluppatore restituita all'app quando l'utente fa clic su questa intestazione. Non può essere Null.
TipoDiAttivazione ToastActivationType falso Ottiene o imposta il tipo di attivazione che verrà utilizzata quando si fa clic su questa intestazione. Il valore predefinito è Foreground. Si noti che sono supportati solo Foreground e Protocol.
ActivationOptions ToastActivationOptions falso Ottiene o imposta opzioni aggiuntive relative all'attivazione dell'intestazione di tipo avviso popup.
  • Last updated on