Русский справочник по Win32 API - страница 32

Шрифт
Интервал

стр.

Значение GM _ ADVANCED не поддерживается.


В противном случае, возвращается нуль.


Комментарии


Приложение может установить графический режим для контекста устройства, вызвав функцию SetGraphicsMode .


См. также


SetGraphicsMode .


Буфер обмена

ChangeClipboardChain


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


BOOL ChangeClipboardChain (

HWND hWndRemove ,

HWND hWndNewNext

);


Параметры


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

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


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


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


Комментарии


Окно, идентифицируемое значением параметра 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 извлекает дескриптор окна, являющегося текущим владельцем буфера обмена.


стр.

Похожие книги