ICommandSource Interface

Beheert opdrachten die vanuit een opdrachtbronobject naar een gebruikersbeheerobject worden verzonden.

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.

Zie Procedure: Opdrachtroutering toevoegen aan het Besturingselement Windows Forms voor een voorbeeld van het gebruik ICommandTarget.

Zie Een Windows-formuliergebruikersbesturingselement gebruiken in MFC voor meer informatie over het gebruik van Windows Forms.

Requirements

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

ICommandSource::AddCommandHandler

Hiermee voegt u een opdrachthandler toe aan een opdrachtbronobject.

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

Parameters

cmdID
De opdracht-id.

cmdHandler
Een ingang naar de opdrachthandlermethode.

Remarks

Met deze methode wordt de opdrachthandler cmdHandler toegevoegd aan het opdrachtbronobject en wordt de handler toegewezen aan cmdID. Zie Procedure: Opdrachtroutering toevoegen aan het Besturingselement Windows Forms voor een voorbeeld van het gebruik van AddCommandHandler.

ICommandSource::AddCommandRangeHandler

Hiermee voegt u een groep opdrachthandlers toe aan een opdrachtbronobject.

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

Parameters

cmdIDMin
De beginindex van het opdracht-id-bereik.

cmdIDMax
De eindindex van het opdracht-id-bereik.

cmdHandler
Een ingang naar de berichthandlermethode waaraan de opdrachten zijn toegewezen.

Remarks

Deze methode wijst een aaneengesloten bereik van opdracht-id's toe aan één berichthandler en voegt deze toe aan het opdrachtbronobject. Dit wordt gebruikt voor het verwerken van een groep gerelateerde knoppen met één methode.

ICommandSource::AddCommandRangeUIHandler

Hiermee voegt u een groep berichthandlers voor gebruikersinterfaceopdrachten toe aan een opdrachtbronobject.

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

Parameters

cmdIDMin
De beginindex van het opdracht-id-bereik.

cmdIDMax
De eindindex van het opdracht-id-bereik.

cmdHandler
Een ingang naar de berichthandlermethode waaraan de opdrachten zijn toegewezen.

Remarks

Met deze methode wordt een aaneengesloten reeks opdracht-id's toegewezen aan één opdrachthandler van de gebruikersinterface en wordt deze toegevoegd aan het opdrachtbronobject. Dit wordt gebruikt voor het verwerken van een groep gerelateerde knoppen met één methode.

ICommandSource::AddCommandUIHandler

Hiermee voegt u een berichthandler voor de gebruikersinterface toe aan een opdrachtbronobject.

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

Parameters

cmdID
De opdracht-id.

cmdUIHandler
Een ingang naar de handlermethode voor berichthandler van de gebruikersinterface.

Remarks

Met deze methode wordt de opdrachthandler cmdHandler van de gebruikersinterface toegevoegd aan het opdrachtbronobject en wordt de handler toegewezen aan cmdID.

ICommandSource::PostCommand

Hiermee wordt een bericht geplaatst zonder te wachten totdat het wordt verwerkt.

void PostCommand(unsigned int command);

Parameters

command
De opdracht-id van het bericht dat moet worden gepost.

Remarks

Met deze methode wordt het bericht asynchroon geplaatst dat is toegewezen aan de id die is opgegeven met de opdracht. CWnd::P ostMessage wordt aangeroepen om het bericht in de berichtenwachtrij van het venster te plaatsen en wordt vervolgens geretourneerd zonder te wachten tot het bijbehorende venster het bericht verwerkt.

ICommandSource::RemoveCommandHandler

Hiermee verwijdert u een opdrachthandler uit een opdrachtbronobject.

void RemoveCommandHandler(unsigned int cmdID);

Parameters

cmdID
De opdracht-id.

Remarks

Met deze methode verwijdert u de opdrachthandler die is toegewezen aan cmdID uit het opdrachtbronobject.

ICommandSource::RemoveCommandRangeHandler

Hiermee verwijdert u een groep opdrachthandlers uit een opdrachtbronobject.

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

Parameters

cmdIDMin
De beginindex van het opdracht-id-bereik.

cmdIDMax
De eindindex van het opdracht-id-bereik.

Remarks

Met deze methode verwijdert u een groep berichthandlers, toegewezen aan de opdracht-id's die zijn opgegeven door cmdIDMin en cmdIDMax, uit het opdrachtbronobject.

ICommandSource::RemoveCommandRangeUIHandler

Hiermee verwijdert u een groep berichthandlers voor opdrachten van de gebruikersinterface uit een opdrachtbronobject.

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

Parameters

cmdIDMin
De beginindex van het opdracht-id-bereik.

cmdIDMax
De eindindex van het opdracht-id-bereik.

Remarks

Met deze methode verwijdert u een groep berichthandlers voor gebruikersinterfaceopdrachten, toegewezen aan de opdracht-id's die zijn opgegeven door cmdIDMin en cmdIDMax, uit het opdrachtbronobject.

ICommandSource::RemoveCommandUIHandler

Hiermee verwijdert u een berichthandler voor de gebruikersinterface uit een opdrachtbronobject.

void RemoveCommandUIHandler(unsigned int cmdID);

Parameters

cmdID
De opdracht-id.

Remarks

Met deze methode verwijdert u de handler voor opdrachtberichten van de gebruikersinterface die is toegewezen aan cmdID uit het opdrachtbronobject.

ICommandSource::SendCommand

Hiermee wordt een bericht verzonden en wordt gewacht totdat het wordt verwerkt voordat het wordt geretourneerd.

void SendCommand(unsigned int command);

Parameters

command
De opdracht-id van het te verzenden bericht.

Remarks

Met deze methode wordt het bericht synchroon verzonden naar de id die is opgegeven met de opdracht. CWnd::SendMessage wordt aangeroepen om het bericht in de berichtenwachtrij van het venster te plaatsen en wacht totdat het bericht is verwerkt voordat het bericht wordt geretourneerd.

See also

Procedure: Opdrachtroutering toevoegen aan het Besturingselement Windows Forms
ICommandTarget Interface