3.18.1.6 - Функция 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				Нет 
Замечания по платформе		Не имеется

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