На главную

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 | Скачать Вниз

EnumClipboardFormats



The EnumClipboardFormats function lets you enumerate the data formats that are currently available on the clipboard.

Clipboard data formats are stored in an ordered list. To perform an enumeration of clipboard data formats, you make a series of calls to the EnumClipboardFormats function. For each call, the format parameter specifies an available clipboard format, and the function returns the next available clipboard format.

UINT EnumClipboardFormats(

UINT format // specifies a known available clipboard format
);


Parameters

format

Specifies a clipboard format that is known to be available.
To start an enumeration of clipboard formats, set format to zero. When format is zero, the function retrieves the first available clipboard format. For subsequent calls during an enumeration, set format to the result of the previous EnumClipboardFormat call.



Return Values

If the function succeeds, the return value is the clipboard format that follows the specified format. In other words, the next available clipboard format.
If the function fails, the return value is zero. To get extended error information, call GetLastError. If the clipboard is not open, the function fails.
If there are no more clipboard formats to enumerate, the return value is zero. In this case, the GetLastError function returns the value NO_ERROR. This lets you distinguish between function failure and the end of enumeration.

Remarks

You must open the clipboard before enumerating its formats. Use the OpenClipboard function to open the clipboard. The EnumClipboardFormats function fails if the clipboard is not open.
The EnumClipboardFormats function enumerates formats in the order that they were placed on the clipboard. If you are copying information to the clipboard, add clipboard objects in order from the most descriptive clipboard format to the least descriptive clipboard format. If you are pasting information from the clipboard, retrieve the first clipboard format that you can handle. That will be the most descriptive clipboard format that you can handle.

The operating system provides automatic type conversions for certain clipboard formats. In the case of such a format, this function enumerates the specified format, then enumerates the formats to which it can be converted. For more information about clipboard formats and automatic clipboard format type conversions, see the GetClipboardData and SetClipboardData functions.

See Also

CountClipboardFormats, GetClipboardData, OpenClipboard, RegisterClipboardFormat, SetClipboardData


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

EnumClipboardFormats



Функция EnumClipboardFormats позволяет, чтобы Вы перечисляете форматы данных, которые к настоящему времени доступны в буфере.

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

UINT EnumClipboardFormats(

ФОРМАТ / UINT/ определяет известный доступный формат буфера
);


Параметры

формат

Определяет буфер формата, который известно, что будет доступно.
Для того, чтобы запускать перечисление буфера форматов, установившее формат в нуль. Когда формат является нулем, функция извлекает первый доступный формат буфера. Для последующих вызовов в течение перечисление, установивших формат в результат предшествующего вызова EnumClipboardFormat.



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

Если функция добивается успеха, обратная величина является буфером формата за которым следует определенному формату. Другими словами, следующий доступный формат буфера.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError. Если буфер не открытый, функция терпит неудачу.
Если нет более буфера форматов, чтобы перечисляться, обратная величина нулевая. В этом случае, функциональный возврат GetLastError величина NO_ERROR. Это позволяет, чтобы Вы различаете между функциональной неудачей и конец перечисления.

Замечания

Вы должны открыть буфер перед перечислять форматов. Используйте функцию OpenClipboard, чтобы открывать буфер. Функция EnumClipboardFormats терпит неудачу если буфер не открытый.
Функция EnumClipboardFormats перечисляет форматы в заказывать, чтобы они были установлены в буфере. Если Вы копируете информацию в буфер, добавьте буфер объектов в порядок из наиболее описательного формата буфера в наименее описательный формат буфера. Если Вы склеиваете информацию из буфера, извлеките первый формат буфера, который Вы можете прооперировать. Это будет наиболее описательным форматом буфера, который Вы можете прооперировать.

Операционная система обеспечивает автоматические преобразования наверняка буфер форматов типа. В случае такого формата, эта функция перечисляет определенный формат затем перечисляет форматы на которые она может быть преобразована. Более подробно о буфере форматов и типа формата автоматических преобразований буфера, смотри GetClipboardData и функции SetClipboardData.

Смотри Также

CountClipboardFormats, GetClipboardData, OpenClipboard, RegisterClipboardFormat, SetClipboardData


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz