COleCmdUI 类

项目
12/06/2023

实现 MFC 方法以更新与应用程序的 IOleCommandTarget驱动功能相关的用户界面对象的状态。

语法

class COleCmdUI : public CCmdUI

成员

公共构造函数

名称	描述
COleCmdUI::COleCmdUI	构造 `COleCmdUI` 对象。

公共方法

名称	描述
COleCmdUI::Enable	设置或清除启用命令标志。
COleCmdUI::SetCheck	设置打开/关闭切换命令的状态。
COleCmdUI::SetText	返回命令的文本名称或状态字符串。

注解

在没有为 DocObjects 启用的应用程序中，当用户查看应用程序中的菜单时，MFC 会处理 UPDATE_COMMAND_UI 通知。每个通知都有一个 CCmdUI 对象，可以对其进行操作以反映特定命令的状态。但当应用程序启用 DocObjects 后，MFC 会处理 UPDATE_OLE_COMMAND_UI 通知并分配 COleCmdUI 对象。

COleCmdUI 允许 DocObject 接收源自其容器的用户界面的命令（如“FileNew”、“打开”、“打印”等），并允许容器接收源自 DocObject 的用户界面的命令。尽管 IDispatch 可用于调度相同的命令，但 IOleCommandTarget 提供了一种更简单的查询和执行方法，因为它依赖于一组标准命令，通常没有参数，并且不涉及类型信息。 COleCmdUI 可用于启用、更新和设置 DocObject 用户界面命令的其他属性。如果要调用命令，请调用 OleServerDoc::OnExecOleCmd。

有关 DocObjects 的详细信息，请参阅 CDocObjectServer 和 CDocObjectServerItem。

继承层次结构

CCmdUI

COleCmdUI

要求

标头：afxdocob.h

COleCmdUI::COleCmdUI

构造与特定用户界面命令关联的 COleCmdUI 对象。

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

参数

rgCmds
与给定 GUID 关联的受支持命令的列表。 OLECMD 结构将命令与命令标志相关联。

cCmds
rgCmds 中的命令计数。

pGroup
一个指针，指向标识一组命令的 GUID。

注解

COleCmdUI 对象提供用于更新 DocObject 用户界面对象（如菜单项或控件条按钮）的编程接口。可以通过 COleCmdUI 对象启用、禁用、检查和/或清除用户界面对象。

COleCmdUI::Enable

调用此函数可将 COleCmdUI 对象的命令标志设置为 OLECOMDF_ENABLED，这指示接口命令可用且已启用，或者可清除命令标志。

virtual void Enable(BOOL bOn);

参数

bOn
指示是应启用还是禁用与 COleCmdUI 对象关联的命令。非零表示启用该命令；0 表示禁用该命令。

COleCmdUI::SetCheck

调用此函数可设置打开/关闭切换命令的状态。

virtual void SetCheck(int nCheck);

参数

nCheck
确定设置打开/关闭切换命令的状态的值。值为：

值	说明
1	将命令设置为打开。
2	将命令设置为不确定；无法确定状态，因为此命令的属性在相关选择中同时处于打开和关闭状态。
任何其他值	将命令设置为关闭。

COleCmdUI::SetText

调用此函数可返回命令的文本名称或状态字符串。

virtual void SetText(LPCTSTR lpszText);

参数

lpszText
指向要与命令一起使用的文本的指针。

另请参阅

CCmdUI 类
 层次结构图

通过