共用方式為


docobj.h (Docobj.h) IOleDocumentSite::ActivateMe 方法

要求文件網站啟動呼叫為檔物件的檔,而不是就地使用中物件,並選擇性地指定要啟動的物件文件檢視。

語法

HRESULT ActivateMe(
  [in] IOleDocumentView *pViewToActivate
);

參數

[in] pViewToActivate

IOleDocumentView 介面指標的指標,表示啟動檔物件時要使用的文件檢視。 這個參數可以是 NULL,在此情況下,容器應該呼叫 IOleDocument::CreateView 來取得文件檢視指標。

傳回值

此方法會在成功時傳回S_OK。

備註

當容器呼叫 IOleObject::D oVerb 來啟動檔時,文件物件會藉由呼叫 IOleDocumentSite::ActivateMe 來略過一般就地啟用順序。

在文件物件上呼叫 IOleObject::D oVerb 時,通常會OLEIVERB_SHOW最適當的啟用動詞。 其他允許的動詞包括OLEIVERB_PRIMARY和OLEIVERB_UIACTIVATE。 不建議OLEIVERB_OPEN,因為它表示在不同的視窗中開啟內嵌物件,這與檔物件啟用的意圖相反。

來電者附註

只有文件對象應該呼叫這個方法。 一般就地使用中文件應該藉由呼叫 IOleInPlaceSite 來回應容器對 IOleObject::D oVerb 的呼叫。

文件對象應該呼叫 IOleDocumentSite::ActivateMe 來起始其啟用。 如果容器未實作 IOleDocumentSite,則文件應該預設為一般的就地啟用順序。

支援多個檢視之數據的檔物件可以藉由將指標傳遞至 pViewToActivate 中該檢視的 IOleDocumentView 介面來指定要啟動的檢視。

不過,取得 IOleDocumentView 指標時,容器應該會在不再需要時釋放指標。

實作者的注意事項

此函式必須在檔物件容器中完全實作;E_NOTIMPL不是可接受的傳回值。

如果文件物件在 pViewToActivate 中傳遞 IOleDocumentView 指標,容器的 IOleDocumentSite::ActivateMe 實作應該呼叫 IOleDocumentView::SetInPlaceSite,並將指標傳遞給其 IOleInPlaceSite 介面回到檢視物件。 如果容器停留在 IOleDocumentView 指標上,這通常是這種情況,它應該遵循 呼叫 IOleDocumentView::SetInPlaceSite 並呼叫 IUnknown::AddRef

如果 pViewToActivateNULL,容器可以藉由查詢 IOleDocument 的檔來取得文件檢視的指標,然後呼叫 IOleDocument::CreateView 並傳遞其 IOleInPlaceSite 指標。

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 docobj.h

另請參閱

IOleClientSite

IOleDocument::CreateView

IOleDocumentSite

IOleDocumentView::SetInPlaceSite

IOleInPlaceSite

IOleObject::D oVerb