Compartilhar via


Função EmptyClipboard (winuser.h)

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)

Confira também

Área de transferência

Conceitual

Openclipboard

Referência

Setclipboarddata

WM_DESTROYCLIPBOARD