CCmdUI

CCmdUI，電腦程式術語。僅在一個CCmdTarget派生類的ON_UPDATE_COMMAND_UI處理程式中使用。

基本介紹

• 中文名：CCmdUI
• 選單項：啟用或禁用
• 工具列按鈕：啟用或禁用

中文概況

當用戶在套用的下拉選單時，要確定每個選單項的顯示狀態——允許存取或禁止存取。選單命令的目標通過實現一個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 baseclass.

The CCmdUIclassis 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.