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。
如果 pViewToActivate 為 NULL,容器可以藉由查詢 IOleDocument 的檔來取得文件檢視的指標,然後呼叫 IOleDocument::CreateView 並傳遞其 IOleInPlaceSite 指標。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | docobj.h |