ICommandUI 接口

项目
10/12/2023

管理用户界面命令。

语法

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 中定义）

另请参阅

CCmdUI 类

通过