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 。

繼承階層架構

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);

參數

邦
指出是否應該啟用或停用與 COleCmdUI 物件相關聯的命令。 非零會啟用命令;0 會停用 命令。

COleCmdUI：：SetCheck

呼叫此函式以設定開啟/關閉切換命令的狀態。

virtual void SetCheck(int nCheck);

參數

nCheck
值，決定要設定開啟/關閉切換命令的狀態。 值為：

值	名稱
1	將 命令設定為 開啟。
2	將命令設定為不確定;無法判斷狀態，因為此命令的 屬性同時處於相關選取範圍的開啟和關閉狀態。
任何其他值	將命令設定為 off。

COleCmdUI：：SetText

呼叫此函式以傳回命令的文字名稱或狀態字串。

virtual void SetText(LPCTSTR lpszText);

參數

lpszText
要與 命令搭配使用的文字指標。

另請參閱

CCmdUI 類別
階層架構圖表