IOleInPlaceActiveObject::OnDocWindowActivate 方法 (oleidl.h)
在激活或停用容器的文档窗口时通知活动就地对象。
语法
HRESULT OnDocWindowActivate(
[in] BOOL fActivate
);
参数
[in] fActivate
MDI 子文档窗口的状态。 如果此参数为 TRUE,则窗口处于激活操作中;如果为 FALSE,则为停用行为。
返回值
此方法在成功时返回S_OK。
注解
调用方备注
激活或停用 MDI 子文档窗口且对象当前为文档的活动对象时,调用 IOleInPlaceActiveObject::OnDocWindowActivate 。实施者说明
应在此方法中包含在对象激活期间安装帧级工具的代码。 这些工具包括共享复合菜单和/或可选工具栏和框架装饰。 然后,你应该集中注意力。 停用时, 对象应删除帧级工具。 请注意,如果不在 pborderwidths 设置为 NULL 的情况下调用 IOleInPlaceUIWindow::SetBorderSpace,则可以避免重新协商边框空间。在执行 IOleInPlaceActiveObject::OnDocWindowActivate 时,不要调用 PeekMessage 或 GetMessage 函数或对话框。 这样做可能会导致系统死锁。 对可从 IOleInPlaceActiveObject::OnDocWindowActivate 中调用哪些 OLE 接口方法和函数有进一步的限制。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | oleidl.h |