ICommandSource, interface

Gère les commandes envoyées à partir d’un objet source de commande à un contrôle utilisateur.

Syntaxe

interface class ICommandSource

Membres

Méthodes publiques

Notes

Lorsque vous hébergez un contrôle utilisateur dans une vue MFC, la classe CWinFormsView achemine les commandes et met à jour les messages de l’interface utilisateur vers le contrôle utilisateur pour lui permettre de gérer les commandes MFC (par exemple, les éléments de menu frame et les boutons de barre d’outils). En implémentant l’interface ICommandTarget, vous donnez au contrôle utilisateur une référence à l’objet ICommandSource .

Découvrez comment : ajouter le routage des commandes au contrôle Windows Forms pour obtenir un exemple d’utilisation ICommandTarget.

Pour plus d’informations sur l’utilisation de Windows Forms, consultez Utilisation d’un contrôle utilisateur Windows Form dans MFC.

Spécifications

En-tête : afxwinforms.h (défini dans l’assembly atlmfc\lib\mfcmifc80.dll)

ICommandSource ::AddCommandHandler

Ajoute un gestionnaire de commandes à un objet source de commande.

void AddCommandHandler(
    unsigned int cmdID,
    CommandHandler^ cmdHandler);

Paramètres

cmdID
ID de commande. cmdHandler
Handle de la méthode du gestionnaire de commandes.

Notes

Cette méthode ajoute le gestionnaire de commandes cmdHandler à l’objet source de commande et mappe le gestionnaire à cmdID. Découvrez comment : ajouter un routage de commandes au contrôle Windows Forms pour obtenir un exemple d’utilisation de AddCommandHandler.

ICommandSource ::AddCommandRangeHandler

Ajoute un groupe de gestionnaires de commandes à un objet source de commande.

void AddCommandRangeHandler(
    unsigned int cmdIDMin,
    unsigned int cmdIDMax,
    CommandHandler^ cmdHandler);

Paramètres

cmdIDMin
Index de début de la plage d’ID de commande. cmdIDMax
Index de fin de la plage d’ID de commande. cmdHandler
Handle de la méthode de gestionnaire de messages à laquelle les commandes sont mappées.

Notes

Cette méthode mappe une plage contiguë d’ID de commande à un seul gestionnaire de messages et l’ajoute à l’objet source de commande. Cela est utilisé pour gérer un groupe de boutons associés avec une méthode.

ICommandSource ::AddCommandRangeUIHandler

Ajoute un groupe de gestionnaires de messages de commande d’interface utilisateur à un objet source de commande.

void AddCommandRangeUIHandler(
    unsigned int cmdIDMin,
    unsigned int cmdIDMax,
    CommandUIHandler^ cmdUIHandler);

Paramètres

cmdIDMin
Index de début de la plage d’ID de commande. cmdIDMax
Index de fin de la plage d’ID de commande. cmdHandler
Handle de la méthode de gestionnaire de messages à laquelle les commandes sont mappées.

Notes

Cette méthode mappe une plage contiguë d’ID de commandes à un seul gestionnaire de messages de commande d’interface utilisateur et l’ajoute à l’objet source de commande. Cela est utilisé pour gérer un groupe de boutons associés avec une méthode.

ICommandSource ::AddCommandUIHandler

Ajoute un gestionnaire de messages de commande d’interface utilisateur à un objet source de commande.

void AddCommandUIHandler(
    unsigned int cmdID,
    CommandUIHandler^ cmdUIHandler);

Paramètres

cmdID
ID de commande. cmdUIHandler
Handle de la méthode de gestionnaire de messages de commande de l’interface utilisateur.

Notes

Cette méthode ajoute le gestionnaire de messages de commande de l’interface utilisateur cmdHandler à l’objet source de commande et mappe le gestionnaire à cmdID.

ICommandSource ::P ostCommand

Publie un message sans attendre qu’il soit traité.

void PostCommand(unsigned int command);

Paramètres

commande
ID de commande du message à publier.

Notes

Cette méthode publie de façon asynchrone le message mappé à l’ID spécifié par la commande. Il appelle CWnd ::P ostMessage pour placer le message dans la file d’attente des messages de la fenêtre, puis retourne sans attendre que la fenêtre correspondante traite le message.

ICommandSource ::RemoveCommandHandler

Supprime un gestionnaire de commandes d’un objet source de commande.

void RemoveCommandHandler(unsigned int cmdID);

Paramètres

cmdID
ID de la commande.

Notes

Cette méthode supprime le gestionnaire de commandes mappé à cmdID de l’objet source de commande.

ICommandSource ::RemoveCommandRangeHandler

Supprime un groupe de gestionnaires de commandes d’un objet source de commande.

void RemoveCommandRangeUIHandler(
    unsigned int cmdIDMin,
    unsigned int cmdIDMax);

Paramètres

cmdIDMin
Index de début de la plage d’ID de commande. cmdIDMax
Index de fin de la plage d’ID de commande.

Notes

Cette méthode supprime un groupe de gestionnaires de messages, mappé aux ID de commande spécifiés par cmdIDMin et cmdIDMax, de l’objet source de commande.

ICommandSource ::RemoveCommandRangeUIHandler

Supprime un groupe de gestionnaires de messages de commande d’interface utilisateur d’un objet source de commande.

void RemoveCommandRangeUIHandler(
    unsigned int cmdIDMin,
    unsigned int cmdIDMax);

Paramètres

cmdIDMin
Index de début de la plage d’ID de commande. cmdIDMax
Index de fin de la plage d’ID de commande.

Notes

Cette méthode supprime un groupe de gestionnaires de messages de commande d’interface utilisateur, mappés aux ID de commande spécifiés par cmdIDMin et cmdIDMax, de l’objet source de commande.

ICommandSource ::RemoveCommandUIHandler

Supprime un gestionnaire de messages de commande d’interface utilisateur d’un objet source de commande.

void RemoveCommandUIHandler(unsigned int cmdID);

Paramètres

cmdID
ID de la commande.

Notes

Cette méthode supprime le gestionnaire de messages de commande de l’interface utilisateur mappé à cmdID de l’objet source de commande.

ICommandSource ::SendCommand

Envoie un message et attend qu’il soit traité avant de retourner.

void SendCommand(unsigned int command);

Paramètres

commande
ID de commande du message à envoyer.

Notes

Cette méthode envoie de façon synchrone le message mappé à l’ID spécifié par la commande. Il appelle CWnd ::SendMessage pour placer le message dans la file d’attente de messages de la fenêtre et attend que cette procédure de fenêtre ait traité le message avant de retourner.

Voir aussi

Guide pratique pour ajouter le routage des commandes au contrôle Windows Forms
ICommandTarget, interface