Função GetClipboardData (winuser.h)

Recupera dados da área de transferência em um formato especificado. A área de transferência deve ter sido aberta anteriormente.

Sintaxe

HANDLE GetClipboardData(
  [in] UINT uFormat
);

Parâmetros

[in] uFormat

Tipo: UINT

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

Valor retornado

Tipo: HANDLE

Se a função for bem-sucedida, o valor retornado será o identificador para um objeto de área de transferência no formato especificado.

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

Comentários

A área de transferência controla o identificador que a função GetClipboardData retorna, não o aplicativo. O aplicativo deve copiar os dados imediatamente. O aplicativo não deve liberar o identificador nem deixá-lo bloqueado. O aplicativo não deve usar o identificador depois que a função EmptyClipboard ou CloseClipboard for chamada ou depois que a função SetClipboardData for chamada com o mesmo formato de área de transferência.

O sistema executa conversões implícitas de formato de dados entre determinados formatos de área de transferência quando um aplicativo chama a função GetClipboardData . Por exemplo, se o formato CF_OEMTEXT estiver na área de transferência, uma janela poderá recuperar dados no formato CF_TEXT . O formato na área de transferência é convertido no formato solicitado sob demanda. Para obter mais informações, consulte Formatos de área de transferência sintetizados.

Exemplos

Para obter um exemplo, consulte Copiando informações para a área de transferência.

Requisitos

Confira também

Área de transferência

Closeclipboard

Conceitual

Emptyclipboard

Enumclipboardformats

Referência

Setclipboarddata