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