Функция ChangeClipboardChain (winuser.h)

Статья
03/04/2024

Удаляет указанное окно из цепочки средств просмотра буфера обмена.

Синтаксис

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

Параметры

[in] hWndRemove

Тип: HWND

Дескриптор окна, удаляемого из цепочки. Дескриптор должен быть передан в функцию SetClipboardViewer .

[in] hWndNewNext

Тип: HWND

Дескриптор окна, следующего за окном hWndRemove в цепочке средства просмотра буфера обмена. (Это дескриптор, возвращаемый SetClipboardViewer, если последовательность не была изменена в ответ на WM_CHANGECBCHAIN сообщение.)

Возвращаемое значение

Тип: BOOL

Возвращаемое значение указывает результат передачи сообщения WM_CHANGECBCHAIN в окна в цепочке средства просмотра буфера обмена. Так как окно в цепочке обычно возвращает значение FALSE при обработке WM_CHANGECBCHAIN, возвращаемое значение из цепочки ChangeClipboardChain обычно имеет значение FALSE. Если в цепочке есть только одно окно, возвращаемое значение обычно имеет значение TRUE.

Окно, определенное hWndNewNext , заменяет окно hWndRemove в цепочке. Функция SetClipboardViewer отправляет WM_CHANGECBCHAIN сообщение в первое окно в цепочке средства просмотра буфера обмена.

Пример см. в разделе Удаление окна из цепочки средства просмотра буфера обмена.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-misc-l1-5-1 (представлено в Windows 10 версии 10.0.14393)