action (XML Schema di tipo avviso popup)

  • Articolo

Specifica un pulsante visualizzato in un avviso popup.

Gerarchia degli elementi

<toast>
<Azioni>
<Input>

Sintassi

<action content = string
    arguments = string
    activationType? = "foreground" | "background" | "protocol"
    afterActivationBehavior? = "default" | "pendingUpdate"
    placement? = "contextMenu"
    imageUri? = string
    hint-inputid = string
    hint-buttonStyle = "Success" | "Critical"
    hint-toolTip = string
/>

Chiave

? facoltativo (zero o uno)

Attributi ed elementi

Attributi

Attributo Descrizione Tipo di dati Obbligatoria Valore predefinito
contenuto Contenuto visualizzato sul pulsante. string Sì Nessuno
argomenti Stringa definita dall'app di argomenti che l'app riceverà in un secondo momento se l'utente fa clic su questo pulsante. string Sì Nessuno
tipo Stringa di argomento che può essere passata all'app associata per fornire specifiche sull'azione che deve essere eseguita in risposta all'azione dell'utente. string Sì Nessuno
activationType Decide il tipo di attivazione che verrà usato quando l'utente interagisce con un'azione specifica.
  • "foreground" - Valore predefinito. Viene avviata l'app in primo piano.
  • "background" - Viene attivata l'attività in background corrispondente ed è possibile eseguire codice in background senza interrompere l'utente.
  • "protocollo" - Avviare un'app diversa usando l'attivazione del protocollo.
 string No "primo piano"
afterActivationBehavior Specifica il comportamento che l'avviso popup deve usare quando l'utente esegue un'azione sull'avviso popup.
  • "default" - Valore 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.
 string No "default"
selezione host Se impostato su "contextMenu", l'azione diventa un'azione del menu di scelta rapida aggiunta al menu di scelta rapida della notifica di tipo avviso popup anziché a un pulsante di tipo avviso popup tradizionale. string No nessuno
imageUri URI dell'origine dell'immagine per un'icona del pulsante di tipo avviso popup. Queste icone sono immagini trasparenti bianche di 16x16 pixel con scalabilità del 100% e non devono includere spaziatura interna nell'immagine stessa. Se si sceglie di fornire icone in una notifica di tipo avviso popup, è necessario fornire icone per TUTTI i pulsanti nella notifica, in quanto trasforma lo stile dei pulsanti in pulsanti icona. Usare uno dei gestori di protocollo seguenti:
  • http:// o https://: immagine basata sul Web.
  • ms-appx:/// - Immagine inclusa nel pacchetto dell'app.
  • ms-appdata:///local/ - Immagine salvata nell'archiviazione locale.
  • file:///: immagine locale. (Supportato solo per le app desktop. Questo protocollo non può essere usato dalle app UWP.
 string No nessuno
hint-inputId Impostare sull'ID di un input per posizionare il pulsante accanto all'input. string No nessuno
hint-buttonStyle Stile del pulsante. useButtonStyle deve essere impostato su true nell'elemento avviso popup .
  • "Operazione riuscita" - Il pulsante è verde
  • "Critico" - Il pulsante è rosso.
Si noti che questi valori distinguono tra maiuscole e minuscole.		 string No nessuno
Hint-toolTip Descrizione comando per un pulsante, se il pulsante ha una stringa di contenuto vuota. string No nessuno

Elementi figlio

Nessuno

Elementi padre

Elemento padre Descrizione
actions Elemento contenitore per dichiarare fino a cinque input e fino a cinque azioni pulsante per la notifica di tipo avviso popup.

Vedi anche