Função IsClipboardFormatAvailable (winuser.h)

Artigo
03/13/2024

Determina se a área de transferência contém dados no formato especificado.

Sintaxe

BOOL IsClipboardFormatAvailable(
  [in] UINT format
);

Parâmetros

[in] format

Tipo: UINT

Um formato de área de transferência padrão ou registrado. Para obter uma descrição dos formatos de área de transferência padrão, consulte Formatos de área de transferência padrão .

Retornar valor

Tipo: BOOL

Se o formato da área de transferência estiver disponível, o valor retornado será diferente de zero.

Se o formato da área de transferência não estiver disponível, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Normalmente, um aplicativo que reconhece apenas um formato de área de transferência chamaria essa função ao processar o WM_INITMENU ou WM_INITMENUPOPUP mensagem. Em seguida, o aplicativo habilitaria ou desabilitaria o item de menu Colar, dependendo do valor retornado. Os aplicativos que reconhecem mais de um formato de área de transferência devem usar a função GetPriorityClipboardFormat para essa finalidade.

Exemplos

Para obter um exemplo, consulte Colar informações da área de transferência.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-misc-l1-2-0 (introduzido no Windows 8.1)