changeClipboardChain 函数 (winuser.h)

项目
03/09/2024

从剪贴板查看器链中删除指定的窗口。

语法

BOOL ChangeClipboardChain(
  [in] HWND hWndRemove,
  [in] HWND hWndNewNext
);

参数

[in] hWndRemove

类型：HWND

要从链中删除的窗口的句柄。句柄必须已传递到 SetClipboardViewer 函数。

[in] hWndNewNext

类型：HWND

剪贴板查看器链中 hWndRemove 窗口后面的窗口的句柄。 (这是 SetClipboardViewer 返回的句柄，除非序列已更改以响应 WM_CHANGECBCHAIN 消息。)

返回值

类型： BOOL

返回值指示将 WM_CHANGECBCHAIN 消息传递到剪贴板查看器链中的窗口的结果。由于链中的窗口在处理WM_CHANGECBCHAIN时通常返回 FALSE，因此 ChangeClipboardChain 的返回值通常为 FALSE。如果链中只有一个窗口，则返回值通常为 TRUE。

注解

由 hWndNewNext 标识的窗口替换链中的 hWndRemove 窗口。 SetClipboardViewer 函数将WM_CHANGECBCHAIN消息发送到剪贴板查看器链中的第一个窗口。

有关示例，请参阅从剪贴板查看器链中删除窗口。

要求

要求	值
最低受支持的客户端	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)