Função OpenClipboard (winuser.h)

Artigo
03/04/2024

Abre a área de transferência para exame e impede que outros aplicativos modifiquem o conteúdo da área de transferência.

Sintaxe

BOOL OpenClipboard(
  [in, optional] HWND hWndNewOwner
);

Parâmetros

[in, optional] hWndNewOwner

Digite: HWND

Um identificador para a janela a ser associada à área de transferência aberta. Se esse parâmetro for NULL, a área de transferência aberta será associada à tarefa atual.

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

O OpenClipboard falhará se outra janela tiver a área de transferência aberta.

Um aplicativo deve chamar a função CloseClipboard após cada chamada bem-sucedida para OpenClipboard.

A janela identificada pelo parâmetro hWndNewOwner não se torna o proprietário da área de transferência, a menos que a função EmptyClipboard seja chamada.

Se um aplicativo chamar OpenClipboard com hwnd definido como NULL, EmptyClipboard definirá o proprietário da área de transferência como NULL; isso faz com que SetClipboardData falhe.

Exemplos

Para obter um exemplo, consulte Copiando 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 no Windows 8.1)