“CCmdUI”的意思、由来-中文百科全书

中文概况

CCmdUI没有基类。

它仅在一个CCmdTarget派生类的ON_UPDATE_COMMAND_UI处理程序中使用。

当用户在应用的下拉菜单时，要确定每个菜单项的显示状态——允许存取或禁止存取。菜单命令的目标通过实现一个ON_UPDATE_COMMAND_UI处理来提供这些信息。可以使用ClassWizard来浏览定位应用中的命令用户接口对象，然后为它建立一个消息映射入口，并为每个消息处理函数提供函数原型。

当菜单被下拉时，框架搜索并调用每个ON_UPDATE_COMMAND_UI处理，每个处理调用Enable和Check之类的成员函数，相应地，框架就可以正确地显示每个菜单项了。

菜单项可以用控件条按钮或者其它的命令用户接口对象替换，而在ON_UPDATE_COMMAND_UI处理中的代码不需要改动。

中文说明

下表列出了各种命令用户接口上的CCmdGUI的

成员函数

用户接口项目　Enable 　SetCheck 　SetRadio 　SetText

菜单项　启用或禁用　选取 (×) 或不选　使用圆点选取　设置项目文本

工具栏按钮　启用或禁用　（选择, 未选择或不确定）　与SetCheck相同　不可用)

状态栏窗格　使文本可见或不可见　设置弹出或是普通边框　与SetCheck相同　设置窗格文本

CDialogBar中的普通按钮　启用或禁用　选取或不选复选框　与SetCheck相同　设置按钮文本

CDialogBar中的普通控件　启用或禁用　不可用)　不可用) 　设置窗口文本

所需头文件：#include <afxwin.h>

CCmdUI

类的成员

数据成员

m_nID 　用户接口对象的ID

m_nIndex 　用户接口对象的下标

m_pMenu 　指向CCmdUI对象代表的菜单

m_pSubMenu 　指向CCmdUI对象代表的菜单的子菜单

m_pOther 　指向发送通知的窗口对象

操作

Enable 　允许或禁止本命令存取用户接口对象

SetCheck 　为本命令设置用户接口对象的选中状态

SetRadio 　与成员函数SetCheck类似，作用于单选钮组

SetText 　为本命令设置用户接口对象的文本

ContinueRouting 　通知命令路由机制继续沿处理链传送当前消息

CCmdUI::ContinueRouting

void ContinueRouting( );

说明：

本函数通知路由机制继续沿处理链传送当前消息。

本函数应该和一个返回FALSE的ON_COMMAND_EX处理函数联合使用。有关更详细的信息，请参阅“技术指南21”。

CCmdUI::Enable

virtual void Enable( BOOL bOn = TRUE );

参数：

bOn 　如果为TRUE，则把该项设置为允许存取；为FALSE，则设置为禁止存取。

说明：本函数用来设置一个命令是否可以存取用户接口项。

CCmdUI::SetCheck

virtual void SetCheck( int nCheck = 1 );

参数：

nCheck 　指定要设置的选中状态。0表示设置为未选中状态，1表示选中，2表示不确定。

说明：

本函数为命令设置用户接口项相应的选中状态。它对菜单项和工具条按钮起作用。不确定状态只适用于工具条按钮。

CCmdUI::SetRadio

virtual void SetRadio( BOOL bOn = TRUE );

参数：

bOn 　如果为TRUE，则把项设置为允许存取；为FALSE，则设置为禁止存取。

说明：

本函数用于为命令设置用户接口项的状态。作用类似于SetCheck，但对单选钮组中的成员起作用。不会自动清除组中其它项的选中状态，除非这些项自己维护了组的行为。

CCmdUI::SetText

virtual void SetText( LPCTSTR lpszText );

参数：

lpszText 　指向字符串的指针。

说明：本函数为命令设置用户接口项中的文本。

英文介绍

CCmdUI

CCmdUI does not have a base class.

The CCmdUI class is used only within an ON_UPDATE_COMMAND_UI handler in a CCmdTarget-derived class.

When a user of your application pulls down a menu, each menu item needs to know whether it should be displayed as enabled or disabled. The target of a menu command provides this information by implementing an ON_UPDATE_COMMAND_UI handler. Use ClassWizard to browse the command user-interface objects in your application and create a message-map entry and function prototype for each handler.

When the menu is pulled down, the framework searches for and calls each ON_UPDATE_COMMAND_UI handler, each handler calls CCmdUI member functions such as Enable and Check, and the framework then appropriately displays each menu item.

A menu item can be replaced with a control-bar button or other command user-interface object without changing the code within the ON_UPDATE_COMMAND_UI handler.

The following table summarizes the effect CCmdUI’s member functions have on various command user-interface items.

附录