IOleInPlaceSiteEx::RequestUIActivate 方法 (ocidl.h)
通知容器物件即將進入UI作用中狀態。
Syntax
HRESULT RequestUIActivate();
傳回值
如果物件可以繼續啟用程式並呼叫 IOleInPlaceSite::OnUIActivate,這個方法會傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
對象無法進入UI作用中狀態。 對象必須呼叫 IOleInPlaceSite::OnUIDeactivate ,讓容器可以執行還原焦點所需的處理。 |
|
作業失敗。 |
備註
物件會呼叫這個方法來判斷它是否可以進入UI作用中狀態,並通知容器它即將進行這項轉換。 容器可以傳回S_FALSE來拒絕此要求,例如,如果使用者已取消作業,或目前使用中物件不會放棄其作用中狀態。
如果物件未呼叫 IOleInPlaceSiteEx::RequestUIActivate,容器會處理數據驗證,並引發 IOleInPlaceSite::OnUIActivate 的 Enter 和 Exit 事件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | ocidl.h |