共用方式為


IOleInPlaceSiteEx::OnInPlaceActivateEx 方法 (ocidl.h)

由內嵌物件呼叫,以判斷它是否需要在啟用時重新繪製本身。

語法

HRESULT OnInPlaceActivateEx(
  [out] BOOL  *pfNoRedraw,
  [in]  DWORD dwFlags
);

參數

[out] pfNoRedraw

接收目前重繪狀態之變數的指標。 如果對象在啟用時不需要重新繪製本身,則狀態為 TRUE ,否則 為 FALSE 。 無窗口物件通常不需要此參數傳回的值,而且可能會傳遞 NULL 指標,以節省容器計算此值的負擔。

[in] dwFlags

指出物件是否啟動為無窗口物件。 此參數會從 ACTIVATEFLAGS 列舉取得值。 如需無視窗對象的詳細資訊,請參閱 IOleInPlaceSiteWindowless

傳回值

如果容器允許就地啟用,這個方法會傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 Description
E_UNEXPECTED
已發生未預期的錯誤。

備註

這個方法會取代 IOleInPlaceSite::OnInPlaceActivate。 如果使用較舊的方法,物件一律必須在啟用時重新繪製本身。

無窗口物件需要使用這個方法,而不是 IOleInPlaceSite::OnInPlaceActivate ,以通知容器是否啟用無視窗。

實作者的注意事項

容器應該仔細檢查物件的失效狀態、其 Z 順序、裁剪和任何其他相關參數,以判斷要在 pfNoRedraw 中傳回的適當值。

容器可以快取 ACTIVATEFLAGS 列舉的值,而不是在 IOleInPlaceObjectWindowless 介面中重複呼叫 GetWindow 方法。

規格需求

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

另請參閱

ACTIVATEFLAGS

IOleInPlaceObjectWindowless

IOleInPlaceSite::OnInPlaceActivate

IOleInPlaceSiteEx

IOleInPlaceSiteWindowless