Função EmptyClipboard (winuser.h)

Artigo
08/27/2023

Esvazia a área de transferência e libera identificadores para dados na área de transferência. Em seguida, a função atribui a propriedade da área de transferência à janela que atualmente tem a área de transferência aberta.

Sintaxe

BOOL EmptyClipboard();

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Antes de chamar EmptyClipboard, um aplicativo deve abrir a área de transferência usando a função OpenClipboard . Se o aplicativo especificar um identificador de janela NULL ao abrir a área de transferência, EmptyClipboard terá êxito, mas definirá o proprietário da área de transferência como NULL. Observe que isso faz com que SetClipboardData falhe.

Exemplos

Para obter um exemplo, consulte Copiar informações para a á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 em Windows 8.1)