Функция IsClipboardFormatAvailable выясняет, содержит ли буфер обмена данные в заданном формате.
Синтаксис
BOOL IsClipboardFormatAvailable( UINT format ); |
Параметры
format
[in] Задает стандартный или зарегистрированный формат буфера обмена. Описание стандартных форматов буфера обмена, см. в статье Стандартные форматы буфера обмена.Возвращаемые значения
Если формат буфера обмена доступен, величина возвращаемого значения - не нуль.
Если формат буфера обмена не доступен, величина возвращаемого значения - нуль. Чтобы получать дополнительные сведения об ошибке, вызовите GetLastError.
Замечания
Обычно, приложение, которое распознает только один формат буфера обмена, должно вызывать эту функцию при обработке сообщения WM_INITMENU или WM_INITMENUPOPUP . Затем прикладная программа должна разрешить или запретить работу пункта меню Paste (Вставить), в зависимости от возвращаемого значения. Приложения, которые распознают больше чем один формат буфера обмена, для этой цели должны использовать функцию GetPriorityClipboardFormat .
Windows 95/98/Me: Подпрограмма Microsoft® Layer for Unicode (MSLU) поддерживает функцию IsClipboardFormatAvailable, чтобы обеспечить поддержку синтезируемых форматов буфера обмена. Дополнительную информацию смотри в статье Синтезируемые форматы буфера обмена. Чтобы использовать эту версию функции IsClipboardFormatAvailable, Вы должны добавить некоторые файлы в ваше приложение, как того требует описание Microsoft Layer for Unicode для систем Windows 95/98/Me.
Пример
Пример смотри в статье Вставка информации из буфера обмена.
Смотри также
Обзор Буфер обмена, CountClipboardFormats, EnumClipboardFormats, GetPriorityClipboardFormat, RegisterClipboardFormat, WM_INITMENU, WM_INITMENUPOPUP
|
Размещение и совместимость IsClipboardFormatAvailable |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |