3.18.1.16 - Функция SetClipboardViewer

(УстановитьОкноПросмотраБуфераОбмена)

Функция SetClipboardViewer добавляет определяемое окно к цепочке окон просмотра буфера обмена. Окна просмотра буфера обмена принимают сообщение WM_DRAWCLIPBOARD всякий раз, когда содержание буфера обмена изменяется.

Синтаксис

HWND SetClipboardViewer
(
	HWND hWndNewViewer		// дескриптор окна просмотра буфера обмена
);

Параметры
hWndNewViewer
Идентифицирует окно, которое будет добавлено к цепочке буферов обмена.

Возвращаемые значения
Если функция завершается успешно, возвращаемое значение идентифицирует следующее окно в цепочке окон просмотра буфера обмена. Если происходит ошибка или не имеется никаких других окон в цепочке окон просмотра буфера обмена, возвращаемое значение ПУСТО (NULL). Чтобы получать дополнительные данные об ошибке, вызовите функцию GetLastError.

Замечания
Окна, которые являются частью цепочки окон просмотра буфера обмена, называемые его окнами просмотра, должны обрабатывать сообщения WM_CHANGECBCHAIN и WM_DRAWCLIPBOARD. Каждое окно окна просмотра буфера обмена вызывает функцию SendMessage, чтобы передать эти сообщения следующему окну в цепочке окон просмотра.
Окно просмотра буфера обмена должно, в конечном счете, удаляться из цепочки окон просмотра, вызовом функции ChangeClipboardChain - например, в ответ на сообщение WM_DESTROY.

Смотри также
ChangeClipboardChain, GetClipboardViewer, SendMessage, WM_CHANGECBCHAIN, WM_DRAWCLIPBOARD

Размещение и совместимость SetClipboardViewer

Windows NT			Да 
Win95				Да 
Win32s				Да 
Импортируемая библиотека		user32.lib
Заголовочный файл			winuser.h 
Unicode				Нет 
Замечания по платформе		Не имеется

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков - 16.02.2002