IOleInPlaceActiveObject::OnDocWindowActivate 方法 (oleidl.h)
啟動或停用容器的文件視窗時,通知作用中就地物件。
語法
HRESULT OnDocWindowActivate(
[in] BOOL fActivate
);
參數
[in] fActivate
MDI 子文件視窗的狀態。 如果此參數為 TRUE,則視窗處於啟動動作中;如果為 FALSE,則會在停用動作中。
傳回值
此方法會在成功時傳回S_OK。
備註
來電者附註
當 MDI 子文檔窗口啟動或停用時,呼叫 IOleInPlaceActiveObject::OnDocWindowActivate ,而且物件目前是檔的作用中物件。實作者的注意事項
您應該在此方法中包含程式碼,以在物件啟用期間安裝框架層級工具。 這些工具包括共用複合功能表和/或選擇性工具列和框架裝飾。 然後,您應該將焦點放在一起。 停用時,對象應該移除框架層級工具。 請注意,如果您未呼叫 IOleInPlaceUIWindow::SetBorderSpace 並將 pborderwidths 設定為 NULL,您可以避免重新交涉框線空間。執行 IOleInPlaceActiveObject::OnDocWindowActivate 時,請勿呼叫 PeekMessage 或 GetMessage 函式或對話框。 這樣做可能會導致系統死結。 有進一步限制可從 IOleInPlaceActiveObject::OnDocWindowActivate 內呼叫 OLE 介面方法和函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | oleidl.h |