ICommandSource Interface

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

Syntax

interface class ICommandSource

Members

Public Methods

Remarks

When you host a user control in an MFC View, CWinFormsView Class routes commands and update command UI messages to the user control to allow it to handle MFC commands (for example, frame menu items and toolbar buttons). By implementing ICommandTarget Interface, you give the user control a reference to the ICommandSource object.

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.

Requirements

Header: afxwinforms.h (defined in assembly atlmfc\lib\mfcmifc80.dll)

ICommandSource::AddCommandHandler

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

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

Parameters

cmdID
ID de la commande.

cmdHandler
Handle de la méthode du gestionnaire de commandes.

Remarks

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);

Parameters

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.

Remarks

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);

Parameters

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.

Remarks

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);

Parameters

cmdID
ID de la commande.

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

Remarks

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::PostCommand

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

void PostCommand(unsigned int command);

Parameters

command
ID de commande du message à publier.

Remarks

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);

Parameters

cmdID
ID de la commande.

Remarks

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);

Parameters

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

cmdIDMax
Index de fin de la plage d’ID de commande.

Remarks

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);

Parameters

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

cmdIDMax
Index de fin de la plage d’ID de commande.

Remarks

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);

Parameters

cmdID
ID de la commande.

Remarks

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);

Parameters

command
ID de commande du message à envoyer.

Remarks

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.

See also

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