Win32 API. Буфер обмена - Функция GetClipboardData
ОГЛАВЛЕНИЕ
Функция GetClipboardData
(ПолучитьДанныеИзБуфераОбмена)
Функция GetClipboardData извлекает данные из буфера обмена в заданном формате. Буфер обмена, должен быть предварительно открыт.
Синтаксис
HANDLE GetClipboardData
(
UINT uFormat // формат буфера обмена
);
Параметры
uFormat
Определяет формат буфера обмена. За описанием форматов буфера обмена, обратитесь к статье о функции SetClipboardData.
Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - дескриптор объекта буфера обмена в заданном формате.
Если функция завершается с ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительные данные об ошибке, вызовите функцию GetLastError.
Замечания
Прикладная программа может перечислять доступные форматы заранее, используя функцию EnumClipboardFormats.
Буфер обмена, а не прикладная программа, управляет дескриптором, значение которого возвращает функция GetClipboardData. Прикладная программа должна копировать данные немедленно. Программа не может надеятся на получение возможности сделать долгосрочным использование дескриптора. Прикладная программа не должна ни освобождать дескриптор, ни оставлять его заблокированным.
CF_BITMAP CF_DIB Windows NT, Windows 95
CF_DIB CF_BITMAP Windows NT, Windows 95
CF_DIB CF_PALETTE Windows NT, Windows 95
CF_ENHMETAFILE CF_METAFILEPICT Windows NT, Windows 95
CF_METAFILEPICT CF_ENHMETAFILE Windows NT, Windows 95
CF_OEMTEXT CF_TEXT Windows NT, Windows 95
CF_OEMTEXT CF_UNICODETEXT Windows NT
CF_TEXT CF_OEMTEXT Windows NT, Windows 95
CF_TEXT CF_UNICODETEXT Windows NT
CF_UNICODETEXT CF_OEMTEXT Windows NT
CF_UNICODETEXT CF_TEXT Windows NT
Если операционная система обеспечивает автоматическое преобразование типа в собственный формат буфера обмена, не имеется какого-либо преимущества при размещении преобразованного формата(ов) в буфере обмена.
Если буфер обмена содержит данные в формате CF_PALETTE, прикладная программа должна использовать функции SelectPalette и RealizePalette, чтобы реализовать любые другие данные в буфере обмена в замен этой логической палитры.
За дальнейшей информацией о специфических форматах данных буфера обмена обратитесь к статье о функции SetClipboardData.
Смотри также
EnumClipboardFormats, SetClipboardData, RealizePalette, SelectPalette
Размещение и совместимость GetClipboardData
Windows NT Да
Win95 Да
Win32s Да
Импортируемая библиотека user32.lib
Заголовочный файл winuser.h
Unicode Нет
Замечания по платформе Не имеется