ICommandUI Interface

  • Article

Manages user interface commands.

interface class ICommandUI

Members

Public Methods

Name

Description

ICommandUI::Check

Sets the user interface item for this command to the appropriate check state.

ICommandUI::ContinueRouting

Tells the command-routing mechanism to continue routing the current message down the chain of handlers.

ICommandUI::Enabled

Enables or disables the user interface item for this command.

ICommandUI::ID

Gets the ID of the user interface object represented by the ICommandUI object.

ICommandUI::Index

Gets the index of the user interface object represented by the ICommandUI object.

ICommandUI::Radio

Sets the user interface item for this command to the appropriate check state.

ICommandUI::Text

Sets the text of the user interface item for this command.

Remarks

This interface provides methods and properties that manage user interface commands. ICommandUI is similar to CCmdUI Class, except that ICommandUI is used for MFC applications that interoperate with .NET components.

ICommandUI is used within an ON_UPDATE_COMMAND_UI handler in an ICommandTarget-derived class. When a user of an application activates (selects or clicks) a menu, each menu item is displayed as enabled or disabled. The target of each menu command provides this information by implementing an ON_UPDATE_COMMAND_UI handler. For each of the command user interface objects in your application, use the Properties window to create a message-map entry and function prototype for each handler.

For more information on how the ICommandUI interface is used in command routing, see How to: Add Command Routing to the Windows Forms Control.

For more information on using Windows Forms, see Using a Windows Form User Control in MFC.

For more information on how user interface commands are managed in MFC, see CCmdUI Class.

Requirements

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

See Also

Reference

CCmdUI Class