Win32 API. Буфер обмена - Функция EnumClipboardFormats
ОГЛАВЛЕНИЕ
Функция EnumClipboardFormats
(ПеречислитьФорматыБуфераОбмена)
Функция EnumClipboardFormats позволяет Вам перечислять форматы данных, которые являются в настоящее время доступными в буфере обмена.
Форматы данных буфера обмена хранятся в списке по порядку. Чтобы выполнить перечисление форматов данных буфера обмена, Вы делаете ряд обращений к функции EnumClipboardFormats. Для каждого обращения, параметр формата определяет доступный формат буфера обмена, а функция возвращает значение следующего доступного формата буфера обмена.
Синтаксис
UINT EnumClipboardFormats
(
UINT format // Определяет известный доступный формат буфера обмена
);
Параметры
format
Определяет формат буфера обмена, о котором известно, что он является доступным.
Чтобы начать перечисление форматов буфера обмена, установленный параметр formatformat устанавливается результат предыдущего обращения к EnumClipboardFormat.
Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - формат буфера обмена, который следует за заданным форматом. Другими словами, следующий доступный формат буфера обмена.
Если функция завершается с ошибкой, возвращаемое значение нулевое. Чтобы получить дополнительные данные об ошибке, вызовите функцию GetLastError. Если буфер обмена не открыт, функция завершается с ошибкой.
Если больше нет форматов буфера обмена, которые надо перечислиться, возвращаемое значение нулевое. В этом случае, функция GetLastError возвращает значение NO_ERROR. Это позволяет Вам делать различие между функциональным сбоем и концом операции перечисления.
Замечания
Перед перечислением форматов буфера обмена, Вы должны открыть его. Чтобы открыть буфер обмена, используйте функцию OpenClipboard. Если буфер обмена не открыт, функция EnumClipboardFormats завершается с ошибкой.
Функция EnumClipboardFormats перечисляет форматы по порядку, как они были помещены в буфер обмена. Если Вы копируете информацию в буфер обмена, добавляйте объекты буфера обмена в порядке от наиболее квалифицирующего формата буфера обмена к наименее квалифицирующему формату. Если Вы вставляете информацию из буфера обмена, извлекается первый формат буфера обмена, который Вы можете обрабатывать. Это будет наиболее квалифицирующий формат буфера обмена, который Вы можете обрабатывать.
Для некоторых форматов буфера обмена, операционная система обеспечивает автоматическое преобразование типов. В случае такого формата, эта функция перечисляет заданный формат, затем перечисляет форматы, в которые он может быть преобразован. Для получения дополнительной информации о форматах буфера обмена и автоматическом преобразований типов формата буфера обмена, см. функции GetClipboardData и SetClipboardData.
Смотри также
CountClipboardFormats, GetClipboardData, OpenClipboard, RegisterClipboardFormat, SetClipboardData
Размещение и совместимость EnumClipboardFormats
Windows NT Да
Win95 Да
Win32s Да
Импортируемая библиотека user32.lib
Заголовочный файл winuser.h
Unicode Нет
Замечания по платформе Не имеется