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)