Win32 API. Буфер обмена
Страница 28. Функция GetClipboardData


Функция GetClipboardData

(ПолучитьДанныеИзБуфераОбмена)

Функция GetClipboardData извлекает данные из буфера обмена в заданном формате. Буфер обмена, должен быть предварительно открыт.

Синтаксис

HANDLE GetClipboardData
(
UINT uFormat// формат буфера обмена
);

Параметры
uFormat
Определяет формат буфера обмена. За описанием форматов буфера обмена, обратитесь к статье о функции SetClipboardData.

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

Замечания
Прикладная программа может перечислять доступные форматы заранее, используя функцию EnumClipboardFormats.
Буфер обмена, а не прикладная программа, управляет дескриптором, значение которого возвращает функция GetClipboardData. Прикладная программа должна копировать данные немедленно. Программа не может надеятся на получение возможности сделать долгосрочным использование дескриптора. Прикладная программа не должна ни освобождать дескриптор, ни оставлять его заблокированным.

CF_BITMAPCF_DIBWindows NT, Windows 95
CF_DIBCF_BITMAPWindows NT, Windows 95
CF_DIBCF_PALETTEWindows NT, Windows 95
CF_ENHMETAFILECF_METAFILEPICTWindows NT, Windows 95
CF_METAFILEPICTCF_ENHMETAFILEWindows NT, Windows 95
CF_OEMTEXTCF_TEXTWindows NT, Windows 95
CF_OEMTEXTCF_UNICODETEXTWindows NT
CF_TEXTCF_OEMTEXTWindows NT, Windows 95
CF_TEXTCF_UNICODETEXTWindows NT
CF_UNICODETEXTCF_OEMTEXTWindows NT
CF_UNICODETEXTCF_TEXTWindowsNT

Если операционная система обеспечивает автоматическое преобразование типа в собственный формат буфера обмена, не имеется какого-либо преимущества при размещении преобразованного формата(ов) в буфере обмена.

Если буфер обмена содержит данные в формате CF_PALETTE, прикладная программа должна использовать функции SelectPalette и RealizePalette, чтобы реализовать любые другие данные в буфере обмена в замен этой логической палитры.

За дальнейшей информацией о специфических форматах данных буфера обмена обратитесь к статье о функции SetClipboardData.

Смотри также
EnumClipboardFormats, SetClipboardData, RealizePalette, SelectPalette

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

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

 
« Предыдущая статья   Следующая статья »