MessageDialog.CancelCommandIndex Eigenschaft

Definition

Namespace:

Windows.UI.Popups

Ruft den Index des Befehls ab, den Sie als Cancel-Befehl verwenden möchten, oder legt diesen fest. Dies ist der Befehl, der ausgelöst wird, wenn Benutzer die ESC-TASTE drücken.

Fügen Sie die Befehle hinzu, bevor Sie den Index festlegen.

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 UInteger

Eigenschaftswert

UInt32

unsigned int

uint32_t

Der Index des Cancel-Befehls.

Hinweise

Verwenden Sie Nachrichtendialoge, um kritische oder blockierende Nachrichten und Fragen aus der App zu senden.

Wert	Verwendung
≥ 0	Das Dialogfeld bietet eine sichere Standardauswahl, die dem Abbruch entspricht, z. B. "Abbrechen" oder "Schließen". Legen Sie CancelCommandIndex auf den Index des Befehlshandlers für diesen cancel/close-Befehl fest, sodass die API den gewünschten Befehlshandler zurückgibt, wenn der Benutzer den Dialog durch eine nichtmittielle Aktion wie das Drücken von ESC schließt. Hinweis Im Allgemeinen sollten Sie es vermeiden, Dialoge zu erstellen, die auf diese Weise geschlossen werden können und die die gleiche Frage erneut starten oder immer wieder dieselbe Nachricht senden. Sie machen die App laut und neigen dazu, Benutzer zu verärchigen.
-1	Der Benutzer muss eine explizite Entscheidung treffen, z. B. durch Tippen auf eine bestimmte Schaltfläche im Dialogfeld. Dadurch wird sichergestellt, dass der Benutzer den Dialog nicht durch eine unverbindliche Aktion wie drücken von ESC schließen kann.
-2	**Nicht empfohlen**. Der Dialog wird nicht geschlossen, wenn der Benutzer ESC drückt oder während einer eingehenden Vertragsaktivierung. Wenn die App jedoch das Standard App-Fenster erneut verwendet, wenn sie auf eingehende Aktivierungen reagiert, sind die Befehlshandler des Dialogfelds nicht mehr gültig. Da die API dieses Verhalten nicht behandelt, wird empfohlen, diesen Wert nicht zu verwenden.

Fehlerbehandlung bei Kündigung durch eine VertragsaktivierungWenn die App während der Anzeige des Dialogfelds eine eingehende Vertragsaktivierung empfängt (z. B. von Search, Share, Settings, Devices oder der Dateiauswahlverträge), wird das Dialogfeld programmgesteuert geschlossen, unabhängig vom Eigenschaftswert, der für CancelCommandIndex festgelegt wurde.

Damit Sie diesen Fall behandeln können, gibt die API einen Dummy-Befehlshandler zurück. Sie können dann entscheiden, wie sie den Fehler behandeln und darauf reagieren.