Функция IsClipboardFormatAvailable (winuser.h)

Статья
08/27/2023

Определяет, содержит ли буфер обмена данные в указанном формате.

Синтаксис

BOOL IsClipboardFormatAvailable(
  [in] UINT format
);

Параметры

[in] format

Тип: UINT

Стандартный или зарегистрированный формат буфера обмена. Описание стандартных форматов буфера обмена см. в разделе Стандартные форматы буфера обмена .

Возвращаемое значение

Тип: BOOL

Если формат буфера обмена доступен, возвращается ненулевое значение.

Если формат буфера обмена недоступен, возвращаемое значение равно нулю. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Как правило, приложение, распознающее только один формат буфера обмена, вызывает эту функцию при обработке сообщения WM_INITMENU или WM_INITMENUPOPUP . Затем приложение будет включать или отключать пункт меню Вставка в зависимости от возвращаемого значения. Приложения, распознающие несколько форматов буфера обмена, должны использовать для этой цели функцию GetPriorityClipboardFormat .

Примеры

Пример см. в разделе Вставка данных из буфера обмена.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-misc-l1-2-0 (представлено в Windows 8.1)