MessageDialog.CancelCommandIndex Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta l'indice del comando che si desidera utilizzare come comando cancel. Questo è il comando che viene attivato quando gli utenti premeno il tasto ESC.
Aggiungere i comandi prima di impostare l'indice.
public:
property unsigned int CancelCommandIndex { unsigned int get(); void set(unsigned int value); };uint32_t CancelCommandIndex();
void CancelCommandIndex(uint32_t value);public uint CancelCommandIndex { get; set; }var uInt32 = messageDialog.cancelCommandIndex;
messageDialog.cancelCommandIndex = uInt32;Public Property CancelCommandIndex As UIntegerValore della proprietà
Indice del comando cancel.
Commenti
Usare le finestre di dialogo dei messaggi per inviare messaggi critici o bloccanti e domande dall'app.
| Valore | Utilizzo |
|---|---|
| ≥ 0 | La finestra di dialogo offre una scelta predefinita sicura equivalente all'annullamento, ad esempio "Annulla" o "Chiudi". Impostare CancelCommandIndex sull'indice del gestore comandi per il comando cancel/close, in modo che quando l'utente ignora la finestra di dialogo tramite un'azione non comitale, ad esempio premendo ESC, l'API restituisce il gestore di comandi desiderato.
Nota In genere, è consigliabile evitare di creare finestre di dialogo che possono essere ignorate in questo modo e che il nuovo avvio pone la stessa domanda o inviando nuovamente lo stesso messaggio. Rendono l'app rumorosa e tendono ad infastidire gli utenti. |
| -1 | L'utente deve prendere una decisione esplicita, ad esempio toccando un pulsante specifico nella finestra di dialogo. Ciò garantisce che l'utente non possa chiudere la finestra di dialogo tramite un'azione non commotale, ad esempio premendo ESC. |
| -2 | **Non consigliato**. La finestra di dialogo non viene chiusa quando l'utente preme ESC o durante un'attivazione del contratto in ingresso; Tuttavia, se l'app usa nuovamente la finestra principale dell'app quando risponde alle attivazioni in ingresso, i gestori dei comandi del dialogo non saranno più validi. Poiché l'API non gestisce questo comportamento, è consigliabile non usare questo valore. |
Gestione degli errori in caso di chiusura da parte di un'attivazione del contrattoSe l'app riceve un'attivazione del contratto in ingresso,ad esempio da Ricerca, Condivisione, Impostazioni, Dispositivi o contratti di selezione file, mentre la finestra di dialogo viene visualizzata, la finestra di dialogo viene chiusa a livello di codice, indipendentemente dal valore della proprietà impostato per CancelCommandIndex.
Per gestire questo caso, l'API restituisce un gestore di comandi fittizi. È quindi possibile decidere come gestire e reagire all'errore.