ICommandUI 接口
管理用户界面命令。
语法
interface class ICommandUI
成员
公共方法
| 名称 | 描述 |
|---|---|
| icommandui__Check | 将此命令的用户界面项设置为适当的复选状态。 |
| ICommandUI::ContinueRouting | 告诉命令路由机制继续沿处理程序链路由当前消息。 |
| ICommandUI::Enabled | 启用或禁用此命令的用户界面项。 |
| ICommandUI::ID | 获取 ICommandUI 对象表示的用户界面对象的 ID。 |
| ICommandUI::Index | 获取 ICommandUI 对象表示的用户界面对象的索引。 |
| ICommandUI::Radio | 将此命令的用户界面项设置为适当的复选状态。 |
| ICommandUI::Text | 设置此命令的用户界面项的文本。 |
注解
此接口提供管理用户界面命令的方法和属性。 ICommandUI 类似于 CCmdUI 类，不同之处在于 ICommandUI 用于与 .NET 组件互操作的 MFC 应用程序。
ICommandUI 在 ICommandTarget 派生类的 ON_UPDATE_COMMAND_UI 处理程序中使用。 当应用程序的用户激活（选择或单击）菜单时，每个菜单项都显示为启用或禁用。 每个菜单命令的目标通过实现 ON_UPDATE_COMMAND_UI 处理程序来提供此信息。 对于应用程序中的每个命令用户界面对象，请使用类向导为每个处理程序创建消息映射项和函数原型。
若要详细了解如何在命令路由中使用 ICommandUI 接口，请参阅如何：向 Windows 窗体控件添加命令路由。
有关使用 Windows 窗体的详细信息，请参阅在 MFC 中使用 Windows 窗体用户控件。
若要详细了解如何在 MFC 中管理用户界面命令，请参阅 CCmdUI 类。
ICommandUI::Check
将此命令的用户界面项设置为适当的复选状态。
property UICheckState Check;
备注
此属性将此命令的用户界面项设置为适当的复选状态。 将 Check 设置为以下值：
- 0 取消选中
- 1 选中
- 2 设置不确定
ICommandUI::ContinueRouting
告诉命令路由机制继续沿处理程序链路由当前消息。
void ContinueRouting();
注解
这是一个高级成员函数，应该与返回 FALSE 的 ON_COMMAND_EX 处理程序结合使用。 有关详细信息，请参阅“技术说明 TN006：消息映射”。
ICommandUI::Enabled
启用或禁用此命令的用户界面项。
property bool Enabled;
备注
此属性启用或禁用此命令的用户界面项。 将 Enabled 设为 TRUE 表示启用该项，设为 FALSE 表示禁用该项。
ICommandUI::ID
获取 ICommandUI 对象表示的用户界面对象的 ID。
property unsigned int ID;
备注
此属性获取 ICommandUI 对象表示的菜单项、工具栏按钮或其他用户界面对象的 ID（句柄）。
ICommandUI::Index
获取 ICommandUI 对象表示的用户界面对象的索引。
property unsigned int Index;
备注
此属性获取 ICommandUI 对象表示的菜单项、工具栏按钮或其他用户界面对象的 索引（句柄）。
ICommandUI::Radio
将此命令的用户界面项设置为适当的复选状态。
property bool Radio;
备注
此属性将此命令的用户界面项设置为适当的复选状态。 将 Radio 设为 TRUE 表示启用该项；否则为 FALSE。
ICommandUI::Text
设置此命令的用户界面项的文本。
property String^ Text;
备注
此属性设置此命令的用户界面项的文本。 将 Text 设置为文本字符串句柄。
要求
标头：afxwinforms.h（在程序集 atlmfc\lib\mfcmifc80.dll 中定义）