COleCmdUI 類別
實作 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、Open、Print 等），並允許容器接收源自 DocObject 使用者介面的命令。 雖然 IDispatch 可以用來分派相同的命令， IOleCommandTarget 但提供更簡單的查詢和執行方式，因為它依賴一組標準命令，通常沒有自變數，而且不會涉及任何類型資訊。 COleCmdUI 可用來啟用、更新及設定 DocObject 使用者介面命令的其他屬性。 當您想要叫用命令時，請呼叫 COleServerDoc：：OnExecOleCmd。
如需 DocObjects 的詳細資訊，請參閱 CDocObjectServer 和 CDocObjectServerItem。
繼承階層架構
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);
參數
邦
指出是否應該啟用或停用與 COleCmdUI 對象相關聯的命令。 非零會啟用命令;0 會停用 命令。
COleCmdUI：：SetCheck
呼叫此函式以設定開啟/關閉切換命令的狀態。
virtual void SetCheck(int nCheck);
參數
nCheck
值，決定要設定開啟/關閉切換命令的狀態。 值為：
| 值 | 名稱 |
|---|---|
| 1 | 將命令設定為 開啟。 |
| 2 | 將命令設定為不確定;無法判斷狀態，因為此命令的 屬性同時處於相關選取範圍的開啟和關閉狀態。 |
| 任何其他值 | 將命令設定為 off。 |
COleCmdUI：：SetText
呼叫此函式以傳回命令的文字名稱或狀態字串。
virtual void SetText(LPCTSTR lpszText);
參數
lpszText
要與 命令搭配使用的文字指標。