ICommandSource Interface

Verwaltet Befehle, die von einem Befehlsquellobjekt an ein Benutzersteuerelement gesendet werden.

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.

Siehe Vorgehensweise: Hinzufügen von Befehlsrouting zum Windows Forms-Steuerelement für ein Beispiel für die Verwendung ICommandTarget.

Weitere Informationen zur Verwendung von Windows Forms finden Sie unter Verwenden eines Windows Form-Benutzersteuerelements in MFC.

Requirements

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

ICommandSource::AddCommandHandler

Fügt einem Befehlsquellobjekt einen Befehlshandler hinzu.

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

Parameters

cmdID
Die Befehls-ID.

cmdHandler
Ein Handle für die Befehlshandlermethode.

Remarks

Diese Methode fügt dem Befehlsquellobjekt den Befehlshandler cmdHandler hinzu und ordnet den Handler cmdID zu. Siehe Vorgehensweise: Hinzufügen von Befehlsrouting zum Windows Forms-Steuerelement für ein Beispiel für die Verwendung von AddCommandHandler.

ICommandSource::AddCommandRangeHandler

Fügt einem Befehlsquellobjekt eine Gruppe von Befehlshandlern hinzu.

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

Parameters

cmdIDMin
Der Anfangsindex des Befehls-ID-Bereichs.

cmdIDMax
Der Endindex des Befehls-ID-Bereichs.

cmdHandler
Ein Handle zur Nachrichtenhandlermethode, der die Befehle zugeordnet sind.

Remarks

Diese Methode ordnet einem einzelnen Nachrichtenhandler einen zusammenhängenden Bereich von Befehls-IDs zu und fügt ihn dem Befehlsquellobjekt hinzu. Dies wird für die Behandlung einer Gruppe verwandter Schaltflächen mit einer Methode verwendet.

ICommandSource::AddCommandRangeUIHandler

Fügt einem Befehlsquellobjekt eine Gruppe von Benutzeroberflächenbefehlshandlern hinzu.

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

Parameters

cmdIDMin
Der Anfangsindex des Befehls-ID-Bereichs.

cmdIDMax
Der Endindex des Befehls-ID-Bereichs.

cmdHandler
Ein Handle zur Nachrichtenhandlermethode, der die Befehle zugeordnet sind.

Remarks

Diese Methode ordnet einen zusammenhängenden Bereich von Befehls-IDs einem einzelnen Befehlsnachrichtenhandler der Benutzeroberfläche zu und fügt ihn dem Befehlsquellobjekt hinzu. Dies wird für die Behandlung einer Gruppe verwandter Schaltflächen mit einer Methode verwendet.

ICommandSource::AddCommandUIHandler

Fügt einem Befehlsquellobjekt ein Befehlshandler für die Benutzeroberfläche hinzu.

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

Parameters

cmdID
Die Befehls-ID.

cmdUIHandler
Ein Handle für die Befehlshandlermethode für die Benutzeroberfläche.

Remarks

Diese Methode fügt den Befehlsnachrichtenhandler cmdHandler der Benutzeroberfläche dem Befehlsquellobjekt hinzu und ordnet den Handler cmdID zu.

ICommandSource::PostCommand

Veröffentlicht eine Nachricht, ohne darauf zu warten, dass sie verarbeitet wird.

void PostCommand(unsigned int command);

Parameters

command
Die Befehls-ID der nachricht, die gepostet werden soll.

Remarks

Diese Methode sendet die Nachricht asynchron, die der durch Befehl angegebenen ID zugeordnet ist. Es ruft CWnd::P ostMessage auf, um die Nachricht in der Nachrichtenwarteschlange des Fensters zu platzieren und dann zurückzugeben, ohne darauf zu warten, dass das entsprechende Fenster die Nachricht verarbeitet.

ICommandSource::RemoveCommandHandler

Entfernt einen Befehlshandler aus einem Befehlsquellobjekt.

void RemoveCommandHandler(unsigned int cmdID);

Parameters

cmdID
Die Befehls-ID.

Remarks

Diese Methode entfernt den Befehlshandler, der cmdID zugeordnet ist, aus dem Befehlsquellobjekt.

ICommandSource::RemoveCommandRangeHandler

Entfernt eine Gruppe von Befehlshandlern aus einem Befehlsquellobjekt.

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

Parameters

cmdIDMin
Der Anfangsindex des Befehls-ID-Bereichs.

cmdIDMax
Der Endindex des Befehls-ID-Bereichs.

Remarks

Mit dieser Methode wird eine Gruppe von Nachrichtenhandlern entfernt, die den befehls-IDs zugeordnet sind, die von cmdIDMin und cmdIDMax angegeben sind, aus dem Befehlsquellobjekt.

ICommandSource::RemoveCommandRangeUIHandler

Entfernt eine Gruppe von Befehlsnachrichtenhandlern der Benutzeroberfläche aus einem Befehlsquellobjekt.

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

Parameters

cmdIDMin
Der Anfangsindex des Befehls-ID-Bereichs.

cmdIDMax
Der Endindex des Befehls-ID-Bereichs.

Remarks

Diese Methode entfernt eine Gruppe von Befehlsbefehlshandlern der Benutzeroberfläche, die den Befehls-IDs zugeordnet sind, die durch cmdIDMin und cmdIDMax angegeben sind, aus dem Befehlsquellobjekt.

ICommandSource::RemoveCommandUIHandler

Entfernt einen Befehlsnachrichtenhandler der Benutzeroberfläche aus einem Befehlsquellobjekt.

void RemoveCommandUIHandler(unsigned int cmdID);

Parameters

cmdID
Die Befehls-ID.

Remarks

Mit dieser Methode wird der Befehlsnachrichtenhandler der Benutzeroberfläche entfernt, der cmdID aus dem Befehlsquellobjekt zugeordnet ist.

ICommandSource::SendCommand

Sendet eine Nachricht und wartet, bis sie verarbeitet wird, bevor sie zurückgegeben wird.

void SendCommand(unsigned int command);

Parameters

command
Die Befehls-ID der zu sendenden Nachricht.

Remarks

Diese Methode sendet die Nachricht synchron, die der durch Befehl angegebenen ID zugeordnet ist. Es ruft CWnd::SendMessage auf, um die Nachricht in der Nachrichtenwarteschlange des Fensters zu platzieren und wartet, bis diese Fensterprozedur die Nachricht vor der Rückgabe verarbeitet hat.

See also

Vorgehensweise: Hinzufügen von Befehlsrouting zum Windows Forms-Steuerelement
ICommandTarget Interface