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

另请参阅

GetMessage

IOleInPlaceActiveObject

PeekMessage