IOleInPlaceObject::InPlaceDeactivate 方法 (oleidl.h)
停用作用中的就地物件,並捨棄對象的復原狀態。
Syntax
HRESULT InPlaceDeactivate();
傳回值
此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
發生意外錯誤。 |
備註
來電者的附註
使用中物件的立即容器會呼叫這個方法,以停用使用中對象並捨棄其復原狀態。實作者的注意事項
從 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 |
另請參閱
IOleInPlaceSite::OnInPlaceDeactivate