IOleInPlaceObject::UIDeactivate 方法 (oleidl.h)

停用並移除作用中就地對象的使用者介面。

Syntax

HRESULT UIDeactivate();

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

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

備註

來電者附註

例如,使用者已按兩下物件外部的工作區時,對象的即時容器會呼叫這個方法。

如果容器已呼叫 IOleInPlaceObject::UIDeactivate,則稍後應該呼叫 IOleInPlaceObject::InPlaceDeactivate 以正確清除資源。 容器可以假設在必要時停止或釋放物件會清除資源。 如果尚未呼叫 IOleInPlaceObject::InPlaceDeactivate ,則必須準備物件。 但已呼叫 IOleInPlaceObject::UIDeactivateIOleObject::Close

實作者的注意事項

功能表和視窗等資源可以清除或保持隱藏狀態,直到呼叫 IOleInPlaceObject::InPlaceDeactivateIOleObject::Close,完全停用您的物件為止。 物件應用程式必須先呼叫 IOleInPlaceSite::OnUIDeactivate ,才能使用複合功能表執行任何動作,以便先從框架視窗卸離容器。 在停用就地對象的使用者介面時,物件會保持就緒狀態,以便快速重新啟用。 物件會保持此狀態,直到文件的復原狀態變更為止。 接著,容器應該呼叫 IOleInPlaceObject::InPlaceDeactivate ,告知物件捨棄其復原狀態。

規格需求

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

另請參閱

IOleInPlaceObject

IOleInPlaceObject::InPlaceDeactivate

IOleInPlaceObject::ReactivateAndUndo

IOleInPlaceSite::OnUIDeactivate

IOleObject::Close