IOleInPlaceObject::UIDeactivate 方法 (oleidl.h)
停用並移除作用中就地對象的使用者介面。
Syntax
HRESULT UIDeactivate();
傳回值
此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
已發生未預期的錯誤。 |
備註
來電者附註
例如,使用者已按兩下物件外部的工作區時,對象的即時容器會呼叫這個方法。如果容器已呼叫 IOleInPlaceObject::UIDeactivate,則稍後應該呼叫 IOleInPlaceObject::InPlaceDeactivate 以正確清除資源。 容器可以假設在必要時停止或釋放物件會清除資源。 如果尚未呼叫 IOleInPlaceObject::InPlaceDeactivate ,則必須準備物件。 但已呼叫 IOleInPlaceObject::UIDeactivate 或 IOleObject::Close 。
實作者的注意事項
功能表和視窗等資源可以清除或保持隱藏狀態,直到呼叫 IOleInPlaceObject::InPlaceDeactivate 或 IOleObject::Close,完全停用您的物件為止。 物件應用程式必須先呼叫 IOleInPlaceSite::OnUIDeactivate ,才能使用複合功能表執行任何動作,以便先從框架視窗卸離容器。 在停用就地對象的使用者介面時,物件會保持就緒狀態,以便快速重新啟用。 物件會保持此狀態,直到文件的復原狀態變更為止。 接著,容器應該呼叫 IOleInPlaceObject::InPlaceDeactivate ,告知物件捨棄其復原狀態。規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | oleidl.h |
另請參閱
IOleInPlaceObject::InPlaceDeactivate
IOleInPlaceObject::ReactivateAndUndo