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

另請參閱

GetMessage

IOleInPlaceActiveObject

PeekMessage