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