Русский справочник по Win32 API
Шрифт:
hWndNewNext– дескриптор окна, которое следует за окном, определяемым значением параметра hWndRemove, в цепочке просмотра буфера обмена. (Это дескриптор, возвращенный функцией SetClipboardViewer , если только последовательность не была изменена в ответ на сообщение WM_CHANGECBCHAIN .)
Возвращаемые значения
Возвращаемое значение показывает результат передачи сообщения WM_CHANGECBCHAIN окну в цепочке просмотра буфера обмена. Поскольку окно в цепочке
Комментарии
Окно, идентифицируемое значением параметра hWndNewNext, заменяет окно, идентифицируемое значением параметра hWndRemove , в цепочке просмотра. Функция SetClipboardViewer отправляет сообщение WM_CHANGECBCHAIN первому окну в цепочке просмотра буфера обмена.
Требования
Windows NT/2000/XP: Включена в Windows NT 3.1 и выше.
Windows 95/98/Me: Включена в Windows 95 и выше.
Заголовок: Объявлена в Winuser.h ; подключатьWindows.h.
Библиотека: Используйте User32.lib .
См . также
SetClipboardViewer, WM_CHANGECBCHAIN.
CloseClipboard
Функция CloseClipboard закрывает буфер обмена.
BOOL CloseClipboard (VOID)
Параметры
Функция не имеет параметров.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Когда окно закончило проверку или изменение содержимого буфера обмена, закройте его, вызвав CloseClipboard . Это позволит другим окнам получить доступ к буферу обмена.
Не помещайте объект в буфер обмена после вызова CloseClipboard .
См. также
GetOpenClipboardWindow, OpenClipboard .
CountClipboardFormats
Функция CountClipboardFormats извлекает число различных форматов данных в буфере обмена в настоящий момент
int CountClipboardFormats ( VOID )
Функция не имеет параметров.
Возвращаемые значения
В случае успеха возвращается количество различных форматов данных в буфере обмена в настоящий момент.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
См. также
EnumClipboardFormats, RegisterClipboardFormat .
GetClipboardFormatName
Функция GetClipboardFormatName извлекает из буфера обмена имя указанного зарегистрированного формата. Функция копирует имя в указанный буфер.
int GetClipboardFormatName (
UINT format , // извлекаемый формат буфера обмена
LPTSTR lpszFormatName , // адрес буфера для имени
int cchMaxCount // длина строки имени в символах
);
Параметры
format– определяет тип извлекаемого формата. Значение этого параметра не должно указывать на один из ранее предопределенных форматов.
lpszFormatName– указывает на буфер, который получает имя формата.
cchMaxCount– определяет максимальную длину строки, скопированной в буфер, в символах. Если имя превышает этот предел, лишние символы строки отбрасываются.
Возвращаемые значения
В случае успеха возвращается длина скопированной в буфер строки в символах.
В случае неудачи возвращается нуль, указывая, что затребованный формат не существует или является ранее предопределенным форматом. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
См. также
EnumClipboardFormats, RegisterClipboardFormat .
GetClipboardOwner
Функция GetClipboardOwner извлекает дескриптор окна, являющегося текущим владельцем буфера обмена.
HWND GetClipboardOwner ( VOID )
Параметры
Функция не имеет параметров.
Возвращаемые значения
В случае успеха возвращается дескриптор окна, которое владеет буфером обмена.