Freigeben über

COleCmdUI-Klasse

  • Artikel

Implementiert eine Methode, die es MFC ermöglicht, den Zustand von Benutzeroberflächenobjekten zu aktualisieren, die in Bezug zu den IOleCommandTarget-gesteuerten Funktionen der Anwendung stehen.

Syntax

class COleCmdUI : public CCmdUI

Member

Öffentliche Konstruktoren

Name Beschreibung
COleCmdUI::COleCmdUI Erstellt ein COleCmdUI-Objekt.

Öffentliche Methoden

Name Beschreibung
COleCmdUI::Enable Legt die Aktivierungsbefehlskennzeichnung fest oder löscht sie.
COleCmdUI::SetCheck Legt den Status eines Ein/Aus-Umschaltbefehls fest.
COleCmdUI::SetText Gibt einen Textnamen oder eine Statuszeichenfolge für einen Befehl zurück.

Hinweise

In einer Anwendung, die für DocObjects nicht aktiviert ist, verarbeitet MFC UPDATE_COMMAND_UI Benachrichtigungen, wenn der Benutzer ein Menü in der Anwendung anzeigt. Jede Benachrichtigung erhält ein CCmdUI-Objekt , das bearbeitet werden kann, um den Status eines bestimmten Befehls widerzuspiegeln. Wenn Ihre Anwendung jedoch für DocObjects aktiviert ist, verarbeitet MFC UPDATE_OLE_COMMAND_UI Benachrichtigungen und weist Objekte zu COleCmdUI .

COleCmdUI ermöglicht es einem DocObject, Befehle zu empfangen, die auf der Benutzeroberfläche des Containers (z. B. FileNew, Open, Print usw.) stammen, und ermöglicht es einem Container, Befehle zu empfangen, die auf der Benutzeroberfläche von DocObject stammen. Obwohl IDispatch sie zum Verteilen der gleichen Befehle verwendet werden können, IOleCommandTarget bietet sie eine einfachere Möglichkeit zum Abfragen und Ausführen, da sie auf einem Standardsatz von Befehlen basiert, in der Regel ohne Argumente und keine Typinformationen beteiligt sind. COleCmdUI kann verwendet werden, um andere Eigenschaften von DocObject-Benutzeroberflächenbefehlen zu aktivieren, zu aktualisieren und festzulegen. Wenn Sie den Befehl aufrufen möchten, rufen Sie COleServerDoc::OnExecOleCmd auf.

Weitere Informationen zu DocObjects finden Sie unter CDocObjectServer und CDocObjectServerItem.

Vererbungshierarchie

CCmdUI

COleCmdUI

Anforderungen

Kopfzeile: afxdocob.h

COleCmdUI::COleCmdUI

Erstellt ein COleCmdUI Objekt, das einem bestimmten Benutzeroberflächenbefehl zugeordnet ist.

COleCmdUI(
    OLECMD* rgCmds,
    ULONG cCmds,
    const GUID* m_pGroup);

Parameter

rgCmds
Eine Liste der unterstützten Befehle, die der angegebenen GUID zugeordnet sind. Die OLECMD Struktur ordnet Befehle Befehlskennzeichnungen zu.

cCmds
Die Anzahl der Befehle in rgCmds.

pGroup
Ein Zeiger auf eine GUID, die einen Satz von Befehlen identifiziert.

Hinweise

Das COleCmdUI Objekt stellt eine programmgesteuerte Schnittstelle zum Aktualisieren von DocObject-Benutzeroberflächenobjekten wie Menüelementen oder Steuerelementleistenschaltflächen bereit. Die Benutzeroberflächenobjekte können über das COleCmdUI Objekt aktiviert, deaktiviert, überprüft und/oder gelöscht werden.

COleCmdUI::Enable

Rufen Sie diese Funktion auf, um die Befehlskennzeichnung des COleCmdUI Objekts auf OLECOMDF_ENABLED festzulegen, wodurch die Schnittstelle mitgeteilt wird, dass der Befehl verfügbar und aktiviert ist, oder um die Befehlskennzeichnung zu löschen.

virtual void Enable(BOOL bOn);

Parameter

Bön
Gibt an, ob der dem Objekt zugeordnete COleCmdUI Befehl aktiviert oder deaktiviert werden soll. Nonzero aktiviert den Befehl; 0 deaktiviert den Befehl.

COleCmdUI::SetCheck

Rufen Sie diese Funktion auf, um den Status eines Ein/Aus-Befehls festzulegen.

virtual void SetCheck(int nCheck);

Parameter

nCheck
Ein Wert, der den Zustand bestimmt, um einen Ein-/Aus-Befehl festzulegen. Gültige Werte:

Wert Beschreibung des Dataflows
1 Legt den Befehl auf "Ein" fest.
2 Legt den Befehl auf unbestimmt fest; der Zustand kann nicht bestimmt werden, da sich das Attribut dieses Befehls in den Status "Ein" und "Aus" in der relevanten Auswahl befindet.
beliebiger anderer Wert Legt den Befehl auf "Aus" fest.

COleCmdUI::SetText

Rufen Sie diese Funktion auf, um einen Textnamen oder eine Statuszeichenfolge für einen Befehl zurückzugeben.

virtual void SetText(LPCTSTR lpszText);

Parameter

lpszText
Ein Zeiger auf den Text, der mit dem Befehl verwendet werden soll.

Siehe auch

CCmdUI-Klasse
Hierarchiediagramm