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

Статья
03/13/2024

Добавляет указанное окно в цепочку средств просмотра буфера обмена. Окна средства просмотра буфера обмена получают сообщение 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
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-misc-l1-5-1 (появилось в Windows 10, версия 10.0.14393)