SetClipboardViewer 函数 (winuser.h)
将指定的窗口添加到剪贴板查看器链。 每当剪贴板内容发生更改时，剪贴板查看器窗口都会收到 WM_DRAWCLIPBOARD 消息。 此函数用于向后兼容早期版本的 Windows。
语法
HWND SetClipboardViewer(
[in] HWND hWndNewViewer
);
参数
[in] hWndNewViewer
类型：HWND
要添加到剪贴板链的窗口的句柄。
返回值
类型：HWND
如果函数成功，则返回值将标识剪贴板查看器链中的下一个窗口。 如果发生错误或剪贴板查看器链中没有其他窗口，则返回值为 NULL。 要获得更多的错误信息，请调用 GetLastError。
注解
属于剪贴板查看器链的窗口（称为剪贴板查看器窗口）必须 WM_CHANGECBCHAIN 和 WM_DRAWCLIPBOARD处理剪贴板消息。 每个剪贴板查看器窗口调用 SendMessage 函数，以将这些消息传递到剪贴板查看器链中的下一个窗口。
剪贴板查看器窗口必须最终通过调用 ChangeClipboardChain 函数（例如，响应 WM_DESTROY 消息）从剪贴板查看器链中删除自身。
SetClipboardViewer 函数的存在可提供与早期版本的 Windows 的向后兼容性。 无法正确处理剪贴板链消息的应用程序可能会破坏剪贴板查看器链。 新应用程序应使用更可靠的技术，例如剪贴板序列号或剪贴板格式侦听器的注册。 有关这些替代方法的更多详细信息，请参阅 监视剪贴板内容。
示例
有关示例，请参阅 将窗口添加到剪贴板查看器链。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | winuser.h (包括 Windows.h) |
| Library | User32.lib |
| DLL | User32.dll |
| API 集 | 在 (Windows 10 版本 10.0.14393 中引入的 ext-ms-win-ntuser-misc-l1-5-1) |
另请参阅
概念性
引用