IOleInPlaceSiteEx::OnInPlaceActivateEx 方法 (ocidl.h)
由內嵌物件呼叫,以判斷它是否需要在啟用時重新繪製本身。
語法
HRESULT OnInPlaceActivateEx(
[out] BOOL *pfNoRedraw,
[in] DWORD dwFlags
);
參數
[out] pfNoRedraw
接收目前重繪狀態之變數的指標。 如果對象在啟用時不需要重新繪製本身,則狀態為 TRUE ,否則 為 FALSE 。 無窗口物件通常不需要此參數傳回的值,而且可能會傳遞 NULL 指標,以節省容器計算此值的負擔。
[in] dwFlags
指出物件是否啟動為無窗口物件。 此參數會從 ACTIVATEFLAGS 列舉取得值。 如需無視窗對象的詳細資訊,請參閱 IOleInPlaceSiteWindowless 。
傳回值
如果容器允許就地啟用,這個方法會傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
已發生未預期的錯誤。 |
備註
這個方法會取代 IOleInPlaceSite::OnInPlaceActivate。 如果使用較舊的方法,物件一律必須在啟用時重新繪製本身。
無窗口物件需要使用這個方法,而不是 IOleInPlaceSite::OnInPlaceActivate ,以通知容器是否啟用無視窗。
實作者的注意事項
容器應該仔細檢查物件的失效狀態、其 Z 順序、裁剪和任何其他相關參數,以判斷要在 pfNoRedraw 中傳回的適當值。容器可以快取 ACTIVATEFLAGS 列舉的值,而不是在 IOleInPlaceObjectWindowless 介面中重複呼叫 GetWindow 方法。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | ocidl.h |