分享方式:


CDocObjectServerItem 類別

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

語法

class CDocObjectServerItem : public COleServerItem

成員

受保護的建構函式

名稱 描述
CDocObjectServerItem::CDocObjectServerItem 建構 CDocObjectServerItem 物件。

公用方法

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

受保護的方法

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

備註

CDocObjectServerItem 定義可覆寫的成員函式: OnHideOnDoVerbOnShow

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

如需 DocObjects 的詳細資訊,請參閱 MFC 參考中的 CDocObjectServerCOleCmdUI

繼承階層架構

CObject

CCmdTarget

CDocItem

COleServerItem

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 類別