CCmdUI

CCmdUI没有基类。
它仅在一个CCmdTarget派生类的ON_UPDATE_COMMAND_UI处理程序中使用。
当用户在应用的下拉菜单时,要确定每个菜单项的显示状态——允许存取或禁止存取。菜单命令的目标通过实现一个ON_UPDATE_COMMAND_UI处理来提供这些信息。可以使用ClassWizard来浏览定位应用中的命令用户接口对象,然后为它建立一个消息映射入口,并为每个消息处理函数提供函数原型。
当菜单被下拉时,框架搜索并调用每个ON_UPDATE_COMMAND_UI处理,每个处理调用Enable和Check之类的成员函数,相应地,框架就可以正确地显示每个菜单项了。
菜单项可以用控件条按钮或者其它的命令用户接口对象替换,而在ON_UPDATE_COMMAND_UI处理中的代码不需要改动。
下表列出了各种命令用户接口上的CCmdGUI的成员函数。
用户接口项EnableSetCheckSetRadioSetText
菜单项允许或禁止存取该项选中(ⅹ)或未选中选中(有黑点)设置项的文本
工具条按钮允许或禁止存取该项选中、未选中或不定(不可用)与SetChec相同
状态条状态提示文本可见或不可见设置凸出或正常边框与SetCheck相同设置状态条的提示文本
CDialogBar中的普通按钮允许或禁止存取该项复选框选中或未选中与SetCheck相同设置按钮的文本
CDialogBar中的普通按钮允许或禁止存取该项(不可用)(不可用)设置窗口中的文本
有关使用类CCmdGUI的更详细信息,请参阅联机文档“Visual C++教程”中的“构造用户界面”部分和联机文档“Visual C++程序员指南”中的“如何更新用户界面对象”部分。
#include <afxwin.h>

请参阅:CCmdTarget


CCmdUI类的成员

数据成员
m_nID用户接口对象的ID
m_nIndex用户接口对象的下标
m_pMenu指向CCmdUI对象代表的菜单
m_pSubMenu指向CCmdUI对象代表的菜单的子菜单
m_pOther指向发送通知的窗口对象

操作
Enable允许或禁止本命令存取用户接口对象
SetCheck为本命令设置用户接口对象的选中状态
SetRadio与成员函数SetCheck类似,作用于单选钮组
SetText为本命令设置用户接口对象的文本
ContinueRouting通知命令路由机制继续沿处理链传送当前消息