IOleInPlaceSiteEx::RequestUIActivate 方法 (ocidl.h)

通知容器物件即將進入UI作用中狀態。

Syntax

HRESULT RequestUIActivate();

傳回值

如果物件可以繼續啟用程式並呼叫 IOleInPlaceSite::OnUIActivate,這個方法會傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 Description
S_FALSE
對象無法進入UI作用中狀態。 對象必須呼叫 IOleInPlaceSite::OnUIDeactivate ,讓容器可以執行還原焦點所需的處理。
E_FAIL
作業失敗。

備註

物件會呼叫這個方法來判斷它是否可以進入UI作用中狀態,並通知容器它即將進行這項轉換。 容器可以傳回S_FALSE來拒絕此要求,例如,如果使用者已取消作業,或目前使用中物件不會放棄其作用中狀態。

如果物件未呼叫 IOleInPlaceSiteEx::RequestUIActivate,容器會處理數據驗證,並引發 IOleInPlaceSite::OnUIActivate 的 Enter 和 Exit 事件。

規格需求

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

另請參閱

IOleInPlaceSite::OnUIActivate

IOleInPlaceSite::OnUIDeactivate

IOleInPlaceSiteEx