Функция GetClipboardData

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

Синтаксис

HANDLE GetClipboardData(
    UINT uFormat
);

Параметры

uFormat

[in] Задает формат буфера обмена. За описанием стандартных форматов буфера обмена, обратитесь к статье Стандартные форматы буфера обмена.

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

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

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

Замечания

Приложение может перечислить доступные форматы заранее при помощи использования функция EnumClipboardFormats.

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

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

Windows 95/98/Me: Microsoft® Layer for Unicode (MSLU) поддерживается EnumClipboardFormats, чтобы обеспечить поддержку синтетических форматов буфера обмена. За подробной информацией обратитесь к статье Синтезированные форматы буфера обмена. Чтобы использовать эту версию GetClipboardData, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Пример

 Пример смотри в статье Копирование информации в буфер обмена.

Смотри также 

Обзор Буфер обмена, CloseClipboard, EmptyClipboard, EnumClipboardFormats, SetClipboardData

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz