IPreviewHandler::SetWindow 方法 (shobjidl_core.h)

设置预览程序窗口的父窗口,以及用于预览程序窗口的父窗口内的区域。

语法

HRESULT SetWindow(
  [in] HWND       hwnd,
  [in] const RECT *prc
);

参数

[in] hwnd

类型:HWND

父窗口的句柄。

[in] prc

类型: const RECT*

指向定义预览器区域的 RECT 的指针。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

预览处理程序负责绘制 由 prc 定义的整个区域。 如果预览程序窗口已创建,预览处理程序必须将预览程序窗口关联到新的父 hwnd ,并将预览程序窗口的大小调整为 由 prc 定义的区域。 如果尚未创建预览程序窗口,预览处理程序必须记住在 IPreviewHandler::D oPreview 中创建预览程序窗口时的此信息。

注意 最好在调用 IPreviewHandler::D oPreview 之前存储此信息。 对于预览未启动的任何情况,这样做可以提高设置时的性能。
 

要求

要求
最低受支持的客户端 Windows Vista、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
可再发行组件 Windows 搜索 4 或更高版本