CDocObjectServerItem 類別

發行項
08/04/2024

實作 DocObject 伺服器專屬的 OLE 伺服器動詞命令。

語法

class CDocObjectServerItem : public COleServerItem

成員

受保護的建構函式

名稱	描述
CDocObjectServerItem：：CDocObjectServerItem	建構 `CDocObjectServerItem` 物件。

公用方法

名稱	描述
CDocObjectServerItem：：GetDocument	擷取包含項目的文件指標。

受保護的方法

名稱	描述
CDocObjectServerItem：：OnDoVerb	呼叫以執行動詞。
CDocObjectServerItem：：OnHide	如果架構嘗試隱藏 DocObject 專案，則會擲回例外狀況。
CDocObjectServerItem：：OnShow	由架構呼叫，讓 DocObject 專案處於就地作用中狀態。如果專案不是 DocObject，請呼叫 COleServerItem：：OnShow。

備註

CDocObjectServerItem 定義可覆寫的成員函式： OnHide、 OnDoVerb 和 OnShow。

若要使用 CDocObjectServerItem，請確定衍生類別中的 COleServerDocOnGetEmbeddedItem 覆寫會傳回新的 CDocObjectServerItem 物件。如果您需要變更專案中的任何功能，您可以建立自己的 CDocObjectServerItem衍生類別的新實例。

如需 DocObjects 的詳細資訊，請參閱 MFC 參考中的 CDocObjectServer 和 COleCmdUI。

繼承階層架構

CDocObjectServerItem

需求

標頭： afxdocob.h

CDocObjectServerItem：：CDocObjectServerItem

建構 CDocObjectServerItem 物件。

CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);

參數

pServerDoc
將包含新 DocObject 專案的文件指標。

bAutoDelete
指出當發行對象的連結時，是否可以刪除該物件。如果對像是文件數據不可或缺的一部分， CDocObjectServerItem 請將自變數設定為 FALSE。如果對像是用來識別檔資料中可由架構刪除的範圍，請將它設定為 TRUE。

CDocObjectServerItem：：GetDocument

擷取包含項目的文件指標。

COleServerDoc* GetDocument() const;

傳回值

包含專案的檔的指標;如果專案不是檔的一部分，則為 NULL。

備註

這可讓您存取您傳遞為 CDocObjectServerItem 建構函式之自變數的伺服器檔。

CDocObjectServerItem：：OnDoVerb

由架構呼叫以執行指定的動詞命令。

virtual void OnDoVerb(LONG iVerb);

參數

iVerb
指定要執行的動詞。如需可能的值，請參閱 Windows SDK 中的 IOleObject：:D oVerb 。

備註

如果專案是 DocObject，且已指定OLEIVERB_INPLACEACTIVATE或OLEIVERB_SHOW，則預設實作會呼叫 OnShow 成員函式。如果專案不是 DocObject 或指定不同的動詞，預設實作會呼叫 COleServerItem：：OnDoVerb。

CDocObjectServerItem：：OnHide

由架構呼叫以隱藏專案。

virtual void OnHide();

備註

如果專案是 DocObject，則預設實作會擲回例外狀況。您無法隱藏使用中的 DocObject 專案，因為它會採用整個檢視。您必須停用 DocObject 專案，使其消失。如果專案不是 DocObject，預設實作會呼叫 COleServerItem：：OnHide。

CDocObjectServerItem：：OnShow

由架構呼叫，指示伺服器應用程式讓 DocObject 專案就地作用中。

virtual void OnShow();

備註

如果專案不是 DocObject，預設實作會呼叫 COleServerItem：：OnShow。如果您想要在開啟 DocObject 專案時執行特殊處理，請覆寫此函式。

另請參閱

COleServerItem 類別
 階層架構圖表
 CDocObjectServer 類別
 COleDocObjectItem 類別

共用方式為