共用方式為


IOleInPlaceObject::InPlaceDeactivate 方法 (oleidl.h)

停用作用中的就地物件,並捨棄對象的復原狀態。

Syntax

HRESULT InPlaceDeactivate();

傳回值

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

傳回碼 Description
E_UNEXPECTED
發生意外錯誤。

備註

來電者的附註

使用中物件的立即容器會呼叫這個方法,以停用使用中對象並捨棄其復原狀態。

實作者的注意事項

IOleInPlaceObject::InPlaceDeactivate 傳回時,對象會捨棄其復原狀態。 物件應用程式不應在此呼叫之後立即關閉。 相反地,它應該等候明確呼叫 IOleObject::Close 或對象的參考計數達到零。

在停用之前,物件應用程式應該呼叫 IOleInPlaceSite::OnUIDeactivate,讓容器有機會將其使用者介面放回框架視窗。

如果在呼叫 IOleInPlaceObject::InPlaceDeactivate 期間仍會顯示就地使用者介面,則物件應用程式應該呼叫自己的 IOleInPlaceObject::InPlaceDeactivate 方法來隱藏使用者介面。 就地使用者介面可以在 呼叫 IOleInPlaceObject::InPlaceDeactivate 和IOleInPlaceObject::InPlaceDeactivate 期間選擇性地終結。 但是,如果容器呼叫 IOleObject::Close 時尚未終結使用者介面,則必須在 呼叫 IOleObject::Close 期間終結。

在呼叫 IOleObject::Close 期間,對象應該檢查它是否仍在作用中。 如果是,它應該呼叫 IOleInPlaceObject::InPlaceDeactivate

規格需求

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

另請參閱

IOleInPlaceObject

IOleInPlaceSite::OnInPlaceDeactivate

IOleInPlaceSite::OnUIDeactivate

IOleObject::Close