ICommandSource-Schnittstelle

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

Syntax

interface class ICommandSource

Member

Öffentliche Methoden

Hinweise

Wenn Sie ein Benutzersteuerelement in einer MFC-Ansicht hosten, leitet die CWinFormsView-Klasse Befehle weiter und aktualisiert Befehls-UI-Nachrichten an das Benutzersteuerelement, damit es MFC-Befehle verarbeiten kann (z. B. Framemenüelemente und Symbolleistenschaltflächen). Durch die Implementierung der ICommandTarget-Schnittstelle geben Sie dem Benutzersteuerelement einen Verweis auf das ICommandSource Objekt.

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.

Anforderungen

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

ICommandSource::AddCommandHandler

Fügt einem Befehlsquellobjekt einen Befehlshandler hinzu.

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

Parameter

cmdID
Die Befehls-ID. cmdHandler
Ein Handle für die Befehlshandlermethode.

Hinweise

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

Parameter

cmdIDMin
Der Anfangsindex des Befehls-ID-Bereichs. cmdIDMax
Der Endindex des Befehls-ID-Bereichs. cmdHandler
Ein Handle zur Nachrichtenhandlermethode, der die Befehle zugeordnet sind.

Hinweise

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

Parameter

cmdIDMin
Der Anfangsindex des Befehls-ID-Bereichs. cmdIDMax
Der Endindex des Befehls-ID-Bereichs. cmdHandler
Ein Handle zur Nachrichtenhandlermethode, der die Befehle zugeordnet sind.

Hinweise

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

Parameter

cmdID
Die Befehls-ID. cmdUIHandler
Ein Handle für die Befehlshandlermethode für die Benutzeroberfläche.

Hinweise

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

ICommandSource::P ostCommand

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

void PostCommand(unsigned int command);

Parameter

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

Hinweise

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

Parameter

cmdID
Die Befehls-ID.

Hinweise

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

Parameter

cmdIDMin
Der Anfangsindex des Befehls-ID-Bereichs. cmdIDMax
Der Endindex des Befehls-ID-Bereichs.

Hinweise

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

Parameter

cmdIDMin
Der Anfangsindex des Befehls-ID-Bereichs. cmdIDMax
Der Endindex des Befehls-ID-Bereichs.

Hinweise

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

Parameter

cmdID
Die Befehls-ID.

Hinweise

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

Parameter

Befehl
Die Befehls-ID der zu sendenden Nachricht.

Hinweise

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.

Siehe auch

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