Schema del contenuto dell'avviso popup

  • Articolo

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

Se si preferisce usare codice XML non elaborato anziché la libreria notifiche, vedere XML Schema.

ToastContent

ToastContent

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

Proprietà Type Obbligatorio Descrizione
Launch string false Stringa 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 pertinente al contenuto dell'avviso popup, anziché avviarla nel modo predefinito.
Oggetto visivo Avviso popupVisual true Descrive la parte visiva della notifica di tipo avviso popup.
Azioni IToastActions false Facoltativamente, creare azioni personalizzate con pulsanti e input.
Audio ToastAudio false Descrive la parte audio della notifica di tipo avviso popup.
Tipo di attivazione ToastActivationType false Specifica il tipo di attivazione che verrà utilizzato quando l'utente fa clic sul corpo dell'avviso popup.
ActivationOptions ToastActivationOptions false Novità di Creators Update: opzioni aggiuntive relative all'attivazione della notifica di tipo avviso popup.
Scenario ToastScenario false Dichiara lo scenario per cui viene usato l'avviso popup, ad esempio un allarme o un promemoria.
DisplayTimestamp DateTimeOffset? false Novità di Creators Update: 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 false Novità di Creators Update: aggiungere un'intestazione personalizzata alla notifica per raggruppare più notifiche all'interno del Centro notifiche.

ToastScenario

Specifica lo scenario rappresentato dall'avviso popup.

Valore Significato
Predefinita Comportamento normale dell'avviso popup.
Solleciti Notifica di promemoria. Verrà visualizzato in modo pre-espanso e rimarrà sullo schermo dell'utente fino a quando non viene ignorato.
Allarme Una notifica di allarme. Verrà visualizzato in modo pre-espanso e rimarrà sullo schermo dell'utente fino a quando non viene ignorato. L'audio eseguirà il ciclo per impostazione predefinita e userà l'audio dell'allarme.
IncomingCall Una 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 eseguirà il ciclo per impostazione predefinita e userà l'audio della suoneria.

ToastVisual

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

Proprietà Type Obbligatorio Descrizione
BindingGeneric ToastBindingGeneric true Associazione di tipo avviso popup generico, di cui è possibile eseguire il rendering in tutti i dispositivi. Questa associazione è obbligatoria e non può essere Null.
BaseUri URI false URL di base predefinito combinato con URL relativi negli attributi dell'origine dell'immagine.
AddImageQuery bool? false Impostare su "true" per consentire a Windows di aggiungere una stringa di query all'URL dell'immagine fornito nella notifica di tipo avviso popup. 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"
Lingua string false Impostazioni locali di destinazione del payload visivo quando si usano risorse localizzate, specificate come tag di lingua BCP-47, ad esempio "en-US" o "fr-FR". Queste impostazioni locali vengono sostituite da tutte le impostazioni locali specificate nell'associazione o nel testo. Se non specificato, verranno invece usate le impostazioni locali di sistema.

ToastBindingGeneric

L'associazione generica è l'associazione predefinita per gli avvisi popup ed è la posizione in cui si specifica il testo, le immagini, il contenuto adattivo e altro ancora.

Proprietà Type Obbligatorio Descrizione
Children IList<IToastBindingGenericChild> false Contenuto del corpo dell'avviso popup, che può includere testo, immagini e gruppi (aggiunti nell'aggiornamento dell'anniversario). 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 figlio radice e funzionano solo all'interno di un AdaptiveSubgroup. Se si usa AdaptiveGroup nei dispositivi senza l'aggiornamento dell'anniversario, il contenuto del gruppo verrà semplicemente eliminato.
AppLogoOverride ToastGenericAppLogo false Logo facoltativo per eseguire l'override del logo dell'app.
HeroImage ToastGenericHeroImage false Immagine "hero" opzionale in primo piano visualizzata nell'avviso popup e all'interno del Centro notifiche.
Attribution ToastGenericAttributionText false Testo di attribuzione facoltativo che verrà visualizzato nella parte inferiore della notifica di tipo avviso popup.
BaseUri URI false URL di base predefinito combinato con URL relativi negli attributi dell'origine dell'immagine.
AddImageQuery bool? false Impostare su "true" per consentire a Windows di aggiungere una stringa di query all'URL dell'immagine fornito nella notifica di tipo avviso popup. 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"
Lingua string false Impostazioni locali di destinazione del payload visivo quando si usano risorse localizzate, specificate come tag di lingua BCP-47, ad esempio "en-US" o "fr-FR". Queste impostazioni locali vengono sostituite da tutte le impostazioni locali specificate nell'associazione o nel testo. Se non specificato, verranno invece usate le impostazioni locali di sistema.

IToastBindingGenericChild

Interfaccia marcatore per elementi figlio di tipo avviso popup 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à Type Obbligatorio Descrizione
Text string o BindableString false Il testo da visualizzare. Supporto del data binding aggiunto in Creators Update, ma funziona solo per gli elementi di testo di primo livello.
HintStyle AdaptiveTextStyle false Lo stile controlla le dimensioni, lo spessore e l'opacità del testo del testo. Funziona solo per gli elementi di testo all'interno di un gruppo/sottogruppo.
HintWrap bool? false Impostare questa proprietà su true per abilitare il ritorno a capo 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 false per il wrapping.
HintMaxLines int? false Il numero massimo di righe consentite per la visualizzazione dell'elemento di testo.
HintMinLines int? false 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 false L'allineamento orizzontale del testo. Funziona solo per gli elementi di testo all'interno di un gruppo/sottogruppo.
Lingua string false Impostazioni locali di destinazione del payload XML, specificate come tag di lingua BCP-47, ad esempio "en-US" o "fr-FR". Le impostazioni locali specificate qui eseguono l'override di qualsiasi altra impostazione locale specificata, ad esempio quella nell'associazione o nell'oggetto visivo. 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 nella risoluzione della stringa.

BindableString

Valore di associazione per le stringhe.

Proprietà Type Obbligatorio Descrizione
BindingName string true Ottiene o imposta il nome mappato al valore dei dati di associazione.

AdaptiveTextStyle

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

Valore Significato
Predefinita Valore predefinito. Lo stile è determinato dal renderer.
Caption Dimensioni inferiori al carattere del paragrafo.
CaptionSubtle Uguale a Caption ma con opacità sottile.
Testo Dimensioni del carattere di paragrafo.
BodySubtle Uguale a Body ma con opacità sottile.
Base Dimensioni carattere paragrafo, spessore grassetto. Essenzialmente la versione grassetto di Body.
BaseSubtle Uguale a Base ma con opacità sottile.
Sottotitolo Font size H4.
SubtitleSubtle Uguale a Subtitle ma con opacità sottile.
Title Font size H3.
TitleSubtle Uguale a Title ma con opacità sottile.
TitleNumeral Uguale a Titolo ma con spaziatura interna superiore/inferiore rimossa.
Subheader Font size H2.
SottoheaderSubtle Uguale a Subheader ma con opacità sottile.
SottotitoloNumeral Uguale a Subheader ma con spaziatura interna superiore/inferiore rimossa.
Intestazione Font size H1.
HeaderSubtle Uguale a Header ma con opacità sottile.
HeaderNumeral Uguale a Header ma con spaziatura interna superiore/inferiore rimossa.

AdaptiveTextAlign

Controlla l'allineamento orizzontale del testo.

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

AdaptiveImage

Immagine inline.

Proprietà Type Obbligatorio Descrizione
Origine string true L'URL dell'immagine. ms-appx, ms-appdata e http sono supportati. A partire da Fall Creators Update, le immagini Web possono essere fino a 3 MB per le connessioni normali e 1 MB sulle connessioni a consumo. Nei dispositivi che non eseguono ancora Fall Creators Update, le immagini Web non devono superare i 200 KB.
HintCrop AdaptiveImageCrop false Novità dell'aggiornamento dell'anniversario: controllare il ritaglio desiderato dell'immagine.
HintRemoveMargin bool? false 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 false L'allineamento orizzontale dell'immagine. Funziona solo per le immagini all'interno di un gruppo/sottogruppo.
AlternateText string false Testo alternativo che descrive l'immagine, usata a scopo di accessibilità.
AddImageQuery bool? false Impostare su "true" per consentire a Windows di aggiungere una stringa di query all'URL dell'immagine fornito nella notifica di tipo avviso popup. 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 Significato
Predefinita Valore predefinito. Comportamento di ritaglio determinato dal renderer.
Nessuno L'immagine non viene ritagliata.
Cerchio vuoto L'immagine viene ritagliata a forma di cerchio.

AdaptiveImageAlign

Specifica l'allineamento orizzontale di un'immagine.

Valore Significato
Predefinita Valore predefinito. Comportamento di allineamento determinato dal renderer.
Estendi L'immagine si estende fino alla larghezza disponibile (e potenzialmente disponibile anche l'altezza, a seconda della posizione in cui viene posizionata l'immagine).
Left Allineare l'immagine a sinistra, visualizzando l'immagine in corrispondenza della risoluzione nativa.
Center Allineare l'immagine al centro orizzontalmente, visualizzare l'immagine alla risoluzione nativa.
Right Allineare l'immagine a destra, visualizzando l'immagine in corrispondenza della risoluzione nativa.

AdaptiveGroup

Novità in Anniversary Update: 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à Type Obbligatorio Descrizione
Children IList<AdaptiveSubgroup> false I sottogruppi vengono visualizzati come colonne verticali. È necessario usare i sottogruppi per fornire qualsiasi contenuto all'interno di un adaptivegroup.

AdaptiveSubgroup

Novità dell'aggiornamento dell'anniversario: i sottogruppi sono colonne verticali che possono contenere testo e immagini.

Proprietà Type Obbligatorio Descrizione
Children IList<IAdaptiveSubgroupChild> false AdaptiveText e AdaptiveImage sono elementi figlio validi di sottogruppi.
HintWeight int? false Controllare la larghezza di questa colonna del sottogruppo specificando il peso, rispetto agli altri sottogruppi.
HintTextStacking AdaptiveSubgroupTextStacking false Controllare l'allineamento verticale del contenuto del sottogruppo.

IAdaptiveSubgroupChild

Interfaccia del marcatore per gli elementi figlio del sottogruppo.

Implementazioni
AdaptiveText
AdaptiveImage

AdaptiveSubgroupTextStacking

TextStacking specifica l'allineamento verticale del contenuto.

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

AdaptiveProgressBar

Novità di Creators Update: indicatore di stato. Supportato solo per gli avvisi popup sul desktop, build 15063 o versione successiva.

Proprietà Type Obbligatorio Description
Title string o BindableString false Ottiene o imposta una stringa del titolo facoltativa. Supporta data binding.
valore double o AdaptiveProgressBarValue o BindableProgressBarValue false Ottiene o imposta il valore della barra di avanzamento. Supporta data binding. Il valore predefinito è 0.
ValueStringOverride string o BindableString false 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 string 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 dell'indicatore di stato.

Proprietà Type Obbligatorio Description
valore double false Ottiene o imposta il valore (0,0 - 1,0) che rappresenta la percentuale di completamento.
IsIndeterminate bool false Ottiene o imposta un valore che indica se l'indicatore di stato è indeterminato. Se è true, value verrà ignorato.

BindableProgressBarValue

Valore della barra di stato associabile.

Proprietà Type Obbligatorio Descrizione
BindingName string true Ottiene o imposta il nome mappato al valore dei dati di associazione.

Logo da visualizzare anziché il logo dell'app.

Proprietà Type Obbligatorio Descrizione
Origine string true L'URL dell'immagine. ms-appx, ms-appdata e http sono supportati. Le immagini HTTP devono avere dimensioni inferiori o inferiori a 200 KB.
HintCrop ToastGenericAppLogoCrop false Specificare la modalità di ritaglio dell'immagine.
AlternateText string false Testo alternativo che descrive l'immagine, usata a scopo di accessibilità.
AddImageQuery bool? false Impostare su "true" per consentire a Windows di aggiungere una stringa di query all'URL dell'immagine fornito nella notifica di tipo avviso popup. 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 di logo.

Valore Significato
Predefinita Il ritaglio usa il comportamento predefinito del renderer.
Nessuno L'immagine non viene ritagliata, visualizzata al quadrato.
Cerchio vuoto L'immagine viene ritagliata in un cerchio.

ToastGenericHeroImage

Immagine "hero" in primo piano visualizzata nell'avviso popup e all'interno del Centro notifiche.

Proprietà Type Obbligatorio Descrizione
Origine string true L'URL dell'immagine. ms-appx, ms-appdata e http sono supportati. Le immagini HTTP devono avere dimensioni inferiori o inferiori a 200 KB.
AlternateText string false Testo alternativo che descrive l'immagine, usata a scopo di accessibilità.
AddImageQuery bool? false Impostare su "true" per consentire a Windows di aggiungere una stringa di query all'URL dell'immagine fornito nella notifica di tipo avviso popup. 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 di tipo avviso popup.

Proprietà Type Obbligatorio Descrizione
Testo string true Il testo da visualizzare.
Lingua string false Impostazioni locali di destinazione del payload visivo quando si usano risorse localizzate, specificate 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à Type Obbligatorio Descrizione
Input IList<IToastInput> false Input come caselle di testo e input di selezione. Sono consentiti solo fino a 5 input.
Pulsanti IList<IToastButton> false 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> false Novità in Aggiornamento dell'anniversario: 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 solo 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à Type 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.
Title string false Testo del titolo da visualizzare sopra la casella di testo.
PlaceholderContent string false Testo segnaposto da visualizzare nella casella di testo quando l'utente non ha ancora digitato testo.
DefaultInput string false Testo iniziale da inserire nella casella di testo. Lasciare null per una casella di testo vuota.

ToastSelectionBox

Implementa IToastInput

Controllo casella di selezione, che consente agli utenti di scegliere da un elenco a discesa di opzioni.

Proprietà Type Obbligatorio Descrizione
Id string true È necessario l'Id. Se l'utente ha selezionato questo elemento, questo ID verrà passato al codice dell'app, che rappresenta la selezione scelta.
Contenuto 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à Type 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.
Title string false Testo del titolo da visualizzare sopra la casella di selezione.
DefaultSelectionBoxItemId string false Questo controlla l'elemento selezionato per impostazione predefinita e fa riferimento alla proprietà Id dell'oggetto ToastSelectionBoxItem. Se non si specifica questa opzione, la selezione predefinita sarà vuota (l'utente non vede nulla).
Articoli IList<ToastSelectionBoxItem> false Elementi di selezione tra cui l'utente può scegliere in questo controllo SelectionBox. È possibile aggiungere solo 5 elementi.

IToastButton

Interfaccia dell'indicatore per i pulsanti di tipo avviso popup.

Implementazioni
ToastButton
ToastButtonSnooze
ToastButtonDismiss

ToastButton

Implementa IToastButton

Un pulsante che l'utente può cliccare.

Proprietà Type Obbligatorio Descrizione
Contenuto string true Obbligatorio. Testo da visualizzare sul pulsante.
Argomenti string true Obbligatorio. Stringa definita dall'app di argomenti che l'app riceverà in un secondo momento se l'utente fa clic su questo pulsante.
Tipo di attivazione ToastActivationType false Controlla il tipo di attivazione che questo pulsante userà quando si fa clic. Il valore predefinito è Foreground.
ActivationOptions ToastActivationOptions false Novità di Creators Update: ottiene o imposta opzioni aggiuntive relative all'attivazione del pulsante di tipo avviso popup.

ToastActivationType

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

Valore Significato
Primo piano Valore predefinito. Viene avviata l'app in primo piano.
Background 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

Novità di Creators Update: opzioni aggiuntive relative all'attivazione.

Proprietà Type Obbligatorio Descrizione
AfterActivationBehavior ToastAfterActivationBehavior false Novità di Fall Creators Update: ottiene o imposta il comportamento che l'avviso popup deve usare quando l'utente richiama questa azione. Questo funziona solo su Desktop, per ToastButton e ToastContextMenuItem.
ProtocolActivationTargetApplicationPfn string false 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 Significato
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 nell'avviso popup, la notifica rimarrà presente, in uno stato di visualizzazione "aggiornamento in sospeso". È consigliabile aggiornare immediatamente l'avviso popup da un'attività in background in modo che l'utente non visualizzi lo stato di visualizzazione "aggiornamento in sospeso" per troppo tempo.

ToastButtonSnooze

Implementa IToastButton

Pulsante di sospensione gestito dal sistema che gestisce automaticamente lo snoozing della notifica.

Proprietà Type Obbligatorio Descrizione
CustomContent string false 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à Type Obbligatorio Descrizione
CustomContent string false Testo personalizzato facoltativo visualizzato sul pulsante che sostituisce il testo "Dismiss" localizzato predefinito.

ToastActionsSnoozeAndDismiss

*Implementa IToastActions

Costruisce automaticamente una casella di selezione per gli intervalli di snooze e i pulsanti di snooze/dismiss, tutti automaticamente localizzati e la logica di snoozing viene gestita automaticamente dal sistema.

Proprietà Type Obbligatorio Descrizione
ContextMenuItems IList<ToastContextMenuItem> false Novità in Aggiornamento dell'anniversario: 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

Voce di menu di scelta rapida.

Proprietà Type Obbligatorio Descrizione
Contenuto string true Obbligatorio. Il 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.
Tipo di attivazione ToastActivationType false Controlla il tipo di attivazione che questo elemento di menu userà quando si fa clic. Il valore predefinito è Foreground.
ActivationOptions ToastActivationOptions false Novità di Creators Update: opzioni aggiuntive relative all'attivazione della voce di menu di scelta rapida dell'avviso popup.

ToastAudio

Specificare l'audio da riprodurre quando viene ricevuta la notifica di tipo Avviso popup.

Proprietà Type Obbligatorio Descrizione
Src uri false 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 false Impostare su true se il suono deve essere ripetuto fino a quando viene visualizzato l'avviso popup; false per la riproduzione una sola volta (impostazione predefinita).
Automatico boolean false True per disattivare il suono; false per consentire la riproduzione del suono della notifica di tipo avviso popup (impostazione predefinita).

ToastHeader

Novità di Creators Update: un'intestazione personalizzata che raggruppa più notifiche all'interno del Centro notifiche.

Proprietà Type Obbligatorio Descrizione
Id string true Identificatore creato dallo sviluppatore che identifica in modo univoco questa intestazione. Se due notifiche hanno lo stesso ID intestazione, verranno visualizzate sotto la stessa intestazione nel Centro notifiche.
Title string true Un 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.
Tipo di attivazione ToastActivationType false 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 false Ottiene o imposta opzioni aggiuntive relative all'attivazione dell'intestazione di tipo avviso popup.