IOleInPlaceSiteEx::RequestUIActivate 方法 (ocidl.h)
通知容器对象即将进入 UI 活动状态。
语法
HRESULT RequestUIActivate();
返回值
如果对象可以继续激活过程并调用 IOleInPlaceSite::OnUIActivate,则此方法返回S_OK。 其他可能的返回值包括以下内容。
返回代码 | 说明 |
---|---|
|
对象无法进入 UI 活动状态。 对象必须调用 IOleInPlaceSite::OnUIDeactivate ,以便容器可以执行还原焦点的必要处理。 |
|
此操作失败。 |
注解
对象调用此方法以确定它是否可以进入 UI 活动状态,并通知容器它即将进行此转换。 容器可以返回拒绝此请求S_FALSE,例如,如果最终用户已取消操作,或者当前活动对象不会放弃其活动状态。
如果对象不调用 IOleInPlaceSiteEx::RequestUIActivate,容器将处理数据验证,并从 IOleInPlaceSite::OnUIActivate 触发 Enter 和 Exit 事件。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | ocidl.h |