IOleInPlaceObject::InPlaceDeactivate 方法 (oleidl.h)
停用活动的就地对象并放弃对象的撤消状态。
语法
HRESULT InPlaceDeactivate();
返回值
此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。
返回代码 | 说明 |
---|---|
|
发生了意外错误。 |
注解
给调用方的说明
此方法由活动对象的直接容器调用,以停用活动对象并放弃其撤消状态。实施者说明
从 IOleInPlaceObject::InPlaceDeactivate 返回时,对象将放弃其撤消状态。 对象应用程序不应在此调用后立即关闭。 相反,它应等待对 IOleObject::Close 的显式调用或对象的引用计数达到零。在停用之前,对象应用程序应通过调用 IOleInPlaceSite::OnUIDeactivate,让容器有机会将其用户界面放回框架窗口。
如果在调用 IOleInPlaceObject::InPlaceDeactivate 期间仍显示就地用户界面,则对象应用程序应调用自己的 IOleInPlaceObject::InPlaceDeactivate 方法以隐藏用户界面。 在调用 IOleInPlaceObject::InPlaceDeactivate 和 IOleInPlaceObject::InPlaceDeactivate 期间,可以选择销毁就地用户界面。 但是,如果在容器调用 IOleObject::Close 时用户界面尚未销毁,则必须在调用 IOleObject::Close 期间销毁该用户界面。
在调用 IOleObject::Close 期间,对象应检查以查看它是否仍然处于活动状态。 如果是这样,它应调用 IOleInPlaceObject::InPlaceDeactivate。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | oleidl.h |
另请参阅
IOleInPlaceSite::OnInPlaceDeactivate