ICommandTarget-Schnittstelle

  • Artikel

Stellt ein Benutzersteuerelement mit einer Schnittstelle zum Empfangen von Befehlen aus einem Befehlsquellobjekt bereit.

Syntax

interface class ICommandTarget

Member

Öffentliche Methoden

Name Beschreibung
ICommandTarget::Initialize Initialisiert das Befehlszielobjekt.

Hinweise

Wenn Sie ein Benutzersteuerelement in einer MFC-Ansicht hosten, leitet CWinFormsView 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 ICommandTargetgeben 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)

ICommandTarget::Initialize

Initialisiert das Befehlszielobjekt.

void Initialize(ICommandSource^ cmdSource);

Parameter

cmdSource
Ein Handle für das Befehlsquellobjekt.

Hinweise

Wenn Sie ein Benutzersteuerelement in einer MFC-Ansicht hosten, leitet CWinFormsView Befehle weiter und aktualisiert Befehls-UI-Nachrichten an das Benutzersteuerelement, damit es MFC-Befehle verarbeiten kann.

Diese Methode initialisiert das Befehlszielobjekt und ordnet es dem angegebenen Befehlsquellobjekt cmdSource zu. Sie sollte in der Implementierung der Benutzersteuerungsklasse aufgerufen werden. Bei der Initialisierung sollten Sie Befehlshandler für das Befehlsquellobjekt registrieren, indem Sie ICommandSource::AddCommandHandler in der Initialize-Implementierung aufrufen. Weitere Informationen finden Sie unter How to: Add Command Routing to the Windows Forms Control for an example of how to use Initialize to do this.

Siehe auch

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