Partager via


MessageDialog.CancelCommandIndex Propriété

Définition

Obtient ou définit l’index de la commande que vous souhaitez utiliser comme commande cancel. Il s’agit de la commande qui se déclenche lorsque les utilisateurs appuient sur la touche Échap.

Ajoutez les commandes avant de définir l’index.

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

Valeur de propriété

UInt32

unsigned int

uint32_t

Index de la commande cancel.

Remarques

Utilisez des boîtes de dialogue de message pour envoyer des messages critiques ou bloquants et des questions à partir de l’application.

ValeurQuand l’utiliser
≥ 0La boîte de dialogue offre un choix par défaut sécurisé qui est l’équivalent de l’annulation, comme « Annuler » ou « Fermer ». Définissez CancelCommandIndex sur l’index du gestionnaire de commandes pour cette commande cancel/close, de sorte que lorsque l’utilisateur ferme la boîte de dialogue par le biais d’une action non commerciale, par exemple en appuyant sur Échap, l’API retourne le gestionnaire de commandes souhaité.

Notes

En règle générale, vous devez éviter de créer des boîtes de dialogue qui peuvent être ignorées de cette façon et qui relancent en posant la même question ou en envoyant le même message encore et encore. Ils rendent l’application bruyante et ont tendance à embêter les utilisateurs.

-1L’utilisateur doit prendre une décision explicite, comme appuyer sur un bouton spécifique dans la boîte de dialogue. Cela garantit que l’utilisateur ne peut pas ignorer la boîte de dialogue par le biais d’une action non commerciale comme appuyer sur Échap.
-2**Non recommandé**. La boîte de dialogue n’est pas ignorée lorsque l’utilisateur appuie sur Échap ou lors d’une activation de contrat entrant ; Toutefois, si l’application réutilisent la fenêtre d’application main lors de la réponse aux activations entrantes, les gestionnaires de commandes de la boîte de dialogue ne sont plus valides. Étant donné que l’API ne gère pas ce comportement, nous vous recommandons de ne pas utiliser cette valeur.

Gestion des erreurs en cas de licenciement par une activation de contratSi l’application reçoit une activation de contrat entrante (par exemple à partir de la recherche, du partage, des paramètres, des appareils ou des contrats du sélecteur de fichiers) pendant que la boîte de dialogue s’affiche, la boîte de dialogue est ignorée par programmation, quelle que soit la valeur de propriété qui a été définie pour cancelCommandIndex.

Pour vous aider à gérer ce cas, l’API retourne un gestionnaire de commandes factice. Vous pouvez alors décider comment gérer et réagir à l’erreur.

S’applique à