Función IsClipboardFormatAvailable (winuser.h)

Artículo
03/13/2024

Determina si el Portapapeles contiene datos en el formato especificado.

Sintaxis

BOOL IsClipboardFormatAvailable(
  [in] UINT format
);

Parámetros

[in] format

Tipo: UINT

Formato estándar o registrado del Portapapeles. Para obtener una descripción de los formatos estándar del Portapapeles, consulte Formatos estándar del Portapapeles .

Valor devuelto

Tipo: BOOL

Si el formato del Portapapeles está disponible, el valor devuelto es distinto de cero.

Si el formato del Portapapeles no está disponible, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Normalmente, una aplicación que reconoce solo un formato de Portapapeles llamaría a esta función al procesar el mensaje WM_INITMENU o WM_INITMENUPOPUP . A continuación, la aplicación habilitaría o deshabilitaría el elemento de menú Pegar, en función del valor devuelto. Las aplicaciones que reconocen más de un formato de Portapapeles deben usar la función GetPriorityClipboardFormat para este fin.

Ejemplos

Para obtener un ejemplo, vea Pegar información del Portapapeles.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-misc-l1-2-0 (introducido en Windows 8.1)