Freigeben über


ICommandUI-Schnittstelle

Verwaltet Benutzeroberflächenbefehle.

Syntax

interface class ICommandUI

Member

Öffentliche Methoden

Name Beschreibung
icommandui__Check Legt das Benutzeroberflächenelement für diesen Befehl auf den entsprechenden Überprüfungszustand fest.
ICommandUI::ContinueRouting Weist den Befehlsroutingmechanismus an, das Routing der aktuellen Nachricht über die Kette der Handler fortzusetzen.
ICommandUI::Enabled Aktiviert oder deaktiviert das Benutzeroberflächenelement für diesen Befehl.
ICommandUI::ID Ruft die ID des Vom Objekt dargestellten Benutzeroberflächenobjekts ab ICommandUI .
ICommandUI::Index Ruft den Index des Durch das ICommandUI Objekt dargestellten Benutzeroberflächenobjekts ab.
ICommandUI::Radio Legt das Benutzeroberflächenelement für diesen Befehl auf den entsprechenden Überprüfungszustand fest.
ICommandUI::Text Legt den Text des Benutzeroberflächenelements für diesen Befehl fest.

Hinweise

Diese Schnittstelle stellt Methoden und Eigenschaften bereit, die Benutzeroberflächenbefehle verwalten. ICommandUIähnelt der CCmdUI-Klasse, mit der Ausnahme, dass ICommandUI für MFC-Anwendungen verwendet wird, die mit .NET-Komponenten zusammenarbeiten.

ICommandUI wird in einem ON_UPDATE_COMMAND_UI Handler in einer von ICommandTarget abgeleiteten Klasse verwendet. Wenn ein Benutzer einer Anwendung ein Menü aktiviert (auswählt oder klickt), wird jedes Menüelement als aktiviert oder deaktiviert angezeigt. Das Ziel jedes Menübefehls stellt diese Informationen bereit, indem ein ON_UPDATE_COMMAND_UI-Handler implementiert wird. Verwenden Sie für jedes Der Befehlsbenutzeroberflächenobjekte in Ihrer Anwendung den Klassen-Assistenten , um einen Meldungszuordnungseintrag und Funktionsprototyp für jeden Handler zu erstellen.

Weitere Informationen zur Verwendung der ICommandUI Schnittstelle im Befehlsrouting finden Sie unter How to: Add Command Routing to the Windows Forms Control.

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

Weitere Informationen dazu, wie Benutzeroberflächenbefehle in MFC verwaltet werden, finden Sie unter CCmdUI-Klasse.

ICommandUI::Check

Legt das Benutzeroberflächenelement für diesen Befehl auf den entsprechenden Überprüfungszustand fest.

property UICheckState Check;

Hinweise

Diese Eigenschaft legt das Benutzeroberflächenelement für diesen Befehl auf den entsprechenden Überprüfungszustand fest. Legen Sie "Überprüfen" auf die folgenden Werte fest:

  • 0 Deaktivieren
  • 1 Prüfung
  • 2 Festlegen unbestimmter

ICommandUI::ContinueRouting

Weist den Befehlsroutingmechanismus an, das Routing der aktuellen Nachricht über die Kette der Handler fortzusetzen.

void ContinueRouting();

Hinweise

Dies ist eine erweiterte Memberfunktion, die in Verbindung mit einem ON_COMMAND_EX-Handler verwendet werden soll, der FALSE zurückgibt. Weitere Informationen finden Sie unter Technical Note TN006: Message Maps.

ICommandUI::Enabled

Aktiviert oder deaktiviert das Benutzeroberflächenelement für diesen Befehl.

property bool Enabled;

Hinweise

Diese Eigenschaft aktiviert oder deaktiviert das Benutzeroberflächenelement für diesen Befehl. Legen Sie "Aktiviert" auf "TRUE" fest, um das Element zu aktivieren, "FALSE", um es zu deaktivieren.

ICommandUI::ID

Ruft die ID des Benutzeroberflächenobjekts ab, das durch das ICommandUI -Objekt dargestellt wird.

property unsigned int ID;

Hinweise

Diese Eigenschaft ruft die ID (ein Handle) des Menüelements, der Symbolleistenschaltfläche oder eines anderen Benutzeroberflächenobjekts ab, das durch das ICommandUI-Objekt dargestellt wird.

ICommandUI::Index

Ruft den Index des Benutzeroberflächenobjekts ab, das durch das ICommandUI -Objekt dargestellt wird.

property unsigned int Index;

Hinweise

Diese Eigenschaft ruft den Index (ein Handle) des Menüelements, der Symbolleistenschaltfläche oder eines anderen Benutzeroberflächenobjekts ab, das durch das ICommandUI-Objekt dargestellt wird.

ICommandUI::Radio

Legt das Benutzeroberflächenelement für diesen Befehl auf den entsprechenden Überprüfungszustand fest.

property bool Radio;

Hinweise

Diese Eigenschaft legt das Benutzeroberflächenelement für diesen Befehl auf den entsprechenden Überprüfungszustand fest. "Radio" auf TRUE festlegen, um das Element zu aktivieren; andernfalls FALSE.

ICommandUI::Text

Legt den Text des Benutzeroberflächenelements für diesen Befehl fest.

property String^ Text;

Hinweise

Diese Eigenschaft legt den Text des Benutzeroberflächenelements für diesen Befehl fest. Legen Sie Text auf einen Textzeichenfolgenziehpunkt fest.

Anforderungen

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

Siehe auch

CCmdUI-Klasse