IOleDocumentView：：UIActivate 方法 (docobj.h)

發行項
08/23/2023

啟動或停用檔檢視的使用者介面元素，例如功能表、工具列和快速鍵。

語法

HRESULT UIActivate(
  [in] BOOL fUIActivate
);

參數

[in] fUIActivate

如果 為 TRUE，則檢視會啟用其使用者介面。如果 為 FALSE，則檢視會停用其使用者介面。

傳回值

此方法會在成功時傳回S_OK。其他可能的傳回值包括下列專案。

傳回碼	描述
E_FAIL	作業失敗。
E_OUTOFMEMORY	記憶體不足，無法運作。
E_UNEXPECTED	發生意外錯誤。

備註

來電者的附注

呼叫 IOleDocumentView：：SetInPlaceSite 之前呼叫這個方法會傳回E_UNEXPECTED，因為檢視必須與檢視網站相關聯，才能啟動本身。

當 IOleDocumentView：：UIActivate呼叫為啟用順序的一部分時，呼叫應該在呼叫 IOleDocumentView：：SetRect 或 IOleDocumentView ：：SetRectComplex之前，因為檢視維度不會考慮工具列空間。

若要停用檢視，容器應該呼叫IOleDocumentView：：Show with FALSE，後面接著使用FALSE的IOleDocumentView：：UIActivate。

實作者的注意事項

此方法的實作應該包含下列虛擬程式碼。

if (fActivate)
    {
    UI activate the view (do menu merging, show frame level tools, process accelerators)
    Take focus, and bring the view window forward.
    }
else
    call IOleInPlaceObject::UIDeactivate on this view

此外，檢視也可以參與延伸 的說明 功能表合併。

檔物件的所有檢視都必須支援就地啟用。 E_NOTIMPL不是可接受的傳回值。

需求


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