On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

GetClipboardData

The GetClipboardData function retrieves data from the clipboard in a specified format. The clipboard must have been opened previously.

HANDLE GetClipboardData(

UINT uFormat // clipboard format
);

Parameters

uFormat

Specifies a clipboard format. For a description of the clipboard formats, see the SetClipboardData function.

Return Values

If the function succeeds, the return value is the handle of a clipboard object in the specified format.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

An application can enumerate the available formats in advance by using the EnumClipboardFormats function.
The clipboard controls the handle that the GetClipboardData function returns, not the application. The application should copy the data immediately. The application cannot rely on being able to make long-term use of the handle. The application must not free the handle nor leave it locked.
The operating system performs implicit data format conversions between certain clipboard formats when an application calls the GetClipboardData function. For example, if the CF_OEMTEXT format is on the clipboard, a window can retrieve data in the CF_TEXT format. The format on the clipboard is converted to the requested format on demand. The following table shows the clipboard data type conversions that are available. Note that some of these automatic type conversions are not available on all platforms.

Clipboard Format Conversion Format Platform Support
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

If the operating system provides an automatic type conversion for a particular clipboard format, there is no advantage to placing the conversion format(s) on the clipboard.
If the system provides an automatic type conversion for a particular clipboard format, and you call EnumClipboardFormats to enumerate the clipboard data formats, the operating system first enumerates the format that is on the clipboard, followed by the formats to which it can be converted.

If the clipboard contains data in the CF_PALETTE format, the application should use the SelectPalette and RealizePalette functions to realize any other data in the clipboard against that logical palette.
See SetClipboardData for further information on specific clipboard data formats.

See Also

EnumClipboardFormats, SetClipboardData, RealizePalette, SelectPalette

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetClipboardData

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

РУЧКА GetClipboardData(

ФОРМАТ буфера UINT uFormat //
);

Параметры

uFormat

Определяет буфер формата. Для описания буфера форматов, смотри функцию SetClipboardData.

Обратные Величины

Если функция добивается успеха, обратная величина является ручкой буфера объекта в определенном формате.
Если функция терпит неудачу, обратная величина НЕДЕЙСТВИТЕЛЬНА. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

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

Поддержка Платформы Конверсионного Формата Clipboard Format 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

Если операционная система обеспечивает автоматическое преобразование типа для конкретного формата буфера, нет преимущества на размещение конверсионного формата(s) в буфере.
Если система обеспечивает автоматическое преобразование типа для конкретного формата буфера, и Вы называете EnumClipboardFormats, чтобы перечислять буфер форматов данных, операционная система сначала перечисляет формат, который находится в буфере, сопровожденном форматами на которые он может быть преобразован.

Если буфер содержит данные в формате CF_PALETTE, приложение должно использовать SelectPalette и функции RealizePalette, чтобы реализовывать любые другие данные в буфере против этой логической палитры.
Смотри SetClipboardData для дальнейшей информации о форматах данных специфического буфера.

Смотри Также

EnumClipboardFormats, SetClipboardData, RealizePalette, SelectPalette

Используются технологии uCoz