IOleWindow::GetWindow 方法 (oleidl.h)
检索参与就地激活的窗口之一的句柄, (框架、文档、父窗口或就地对象窗口) 。
语法
HRESULT GetWindow(
[out] HWND *phwnd
);
parameters
[out] phwnd
指向接收窗口句柄的变量的指针。
返回值
此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。
返回代码 | 说明 |
---|---|
|
对象是无窗口的。 |
|
指定的 fEnterMode 值无效。 |
|
可用于此操作的内存不足。 |
|
发生意外错误。 |
注解
五种类型的窗口构成窗口层次结构。 当对象就地处于活动状态时,它有权访问其中部分或全部窗口。
窗口 | 说明 |
---|---|
Frame | 容器应用程序的main菜单所在的最外面的main窗口。 |
文档 | 向用户显示包含嵌入对象的复合文档的窗口。 |
窗格 | 包含对象视图的文档窗口的子窗口。 仅适用于具有拆分窗格窗口的应用程序。 |
Parent | 包含该对象的视图的容器窗口。 对象应用程序将其窗口安装为此窗口的子窗口。 |
就地 | 包含活动就地对象的窗口。 对象应用程序创建此窗口并将其安装为其阴影窗口的子窗口,该窗口是容器父窗口的子窗口。 |
每种类型的窗口在就地激活体系结构中都有不同的角色。 但是,不需要对每种类型使用单独的物理窗口。 许多容器应用程序对其框架、文档、窗格和父窗口使用相同的窗口。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | oleidl.h |