Поделиться через


Функция GetClipboardData (winuser.h)

Извлекает данные из буфера обмена в указанном формате. Буфер обмена должен быть открыт ранее.

Синтаксис

HANDLE GetClipboardData(
  [in] UINT uFormat
);

Параметры

[in] uFormat

Тип: UINT

Формат буфера обмена. Описание стандартных форматов буфера обмена см. в разделе Стандартные форматы буфера обмена.

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

Тип: HANDLE

Если функция выполняется успешно, возвращаемое значение является дескриптором для объекта буфера обмена в указанном формате.

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Осторожностью Данные буфера обмена не являются доверенными. Тщательно проанализируйте данные, прежде чем использовать их в приложении.
 
Приложение может перечислить доступные форматы заранее с помощью функции EnumClipboardFormats .

Буфер обмена управляет дескриптором, возвращаемым функцией GetClipboardData , а не приложением. Приложение должно немедленно скопировать данные. Приложение не должно освобождать дескриптор и не оставлять его заблокированным. Приложение не должно использовать дескриптор после вызова функции EmptyClipboard или CloseClipboard или после вызова функции SetClipboardData с тем же форматом буфера обмена.

Система выполняет неявное преобразование формата данных между определенными форматами буфера обмена, когда приложение вызывает функцию GetClipboardData . Например, если формат CF_OEMTEXT находится в буфере обмена, окно может получить данные в формате CF_TEXT . Формат в буфере обмена преобразуется в запрошенный формат по запросу. Дополнительные сведения см. в разделе Синтезированные форматы буфера обмена.

Примеры

Пример см. в разделе Копирование данных в буфер обмена.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-misc-l1-2-0 (представлено в Windows 8.1)

См. также раздел

Буфер обмена

CloseClipboard

Основные понятия

EmptyClipboard

EnumClipboardFormats

Справочные материалы

SetClipboardData