Área de transferência

Artigo
03/13/2025

A área de transferência é um conjunto de funções e mensagens que permitem que os aplicativos transfiram dados. Como todos os aplicativos têm acesso à área de transferência, os dados podem ser facilmente transferidos entre aplicativos ou dentro de um aplicativo.

Essa visão geral não descreve como copiar e colar objetos vinculados ou inseridos. Para obter informações sobre esses assuntos, consulte a documentação do COM (Component Object Model).

Nesta seção

Nome	Descrição
sobre a área de transferência	Discute a área de transferência.
formatos de área de transferência	Discute os formatos da área de transferência. Uma janela pode colocar mais de um objeto na área de transferência, cada um representando as mesmas informações em um formato de área de transferência diferente. Os usuários não precisam estar cientes dos formatos de área de transferência usados para um objeto na área de transferência.
operações de área de transferência	Discute as operações da área de transferência. Uma janela deve usar a área de transferência ao cortar, copiar ou colar dados. Uma janela coloca dados na área de transferência para operações de recortar e copiar e recupera dados da área de transferência para operações de colagem.
de formato de área de transferência HTML	Discute o formato da área de transferência HTML.
usando a área de transferência	Uma janela do visualizador da área de transferência exibe o conteúdo atual da área de transferência e recebe mensagens quando o conteúdo da área de transferência é alterado.
Referência da área de transferência	Contém a referência de API.

Funções de área de transferência

Nome	Descrição
AddClipboardFormatListener	Coloca a janela fornecida na lista de ouvintes de formato de área de transferência mantida pelo sistema.
ChangeClipboardChain	Remove uma janela especificada da cadeia de visualizadores da área de transferência.
CloseClipboard	Fecha a área de transferência.
countClipboardFormats	Recupera o número de formatos de dados diferentes atualmente na área de transferência.
EmptyClipboard	Esvazia a área de transferência e libera identificadores para os 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.
EnumClipboardFormats	Enumera os formatos de dados disponíveis atualmente na área de transferência. Os formatos de dados da área de transferência são armazenados em uma lista ordenada. Para executar uma enumeração de formatos de dados de área de transferência, você faz uma série de chamadas para a função EnumClipboardFormats. Para cada chamada, o formato parâmetro especifica um formato de área de transferência disponível e a função retorna o próximo formato de área de transferência disponível.
GetClipboardData	Recupera dados da área de transferência em um formato especificado. A área de transferência deve ter sido aberta anteriormente.
GetClipboardFormatName	Recupera da área de transferência o nome do formato registrado especificado. A função copia o nome para o buffer especificado.
GetClipboardOwner	Recupera o identificador de janela do proprietário atual da área de transferência.
GetClipboardSequenceNumber	Recupera o número da sequência da área de transferência para a estação de janela atual.
GetClipboardViewer	Recupera o identificador para a primeira janela na cadeia de visualizadores da área de transferência.
GetOpenClipboardWindow	Recupera o identificador para a janela que atualmente tem a área de transferência aberta.
GetPriorityClipboardFormat	Recupera o primeiro formato de área de transferência disponível na lista especificada.
GetUpdatedClipboardFormats	Recupera os formatos de área de transferência com suporte no momento.
IsClipboardFormatAvailable	Determina se a área de transferência contém dados no formato especificado.
OpenClipboard	Abre a área de transferência para exame e impede que outros aplicativos modifiquem o conteúdo da área de transferência.
RegisterClipboardFormat	Registra um novo formato de área de transferência. Esse formato pode ser usado como um formato de área de transferência válido.
RemoveClipboardFormatListener	Remove a janela fornecida da lista de ouvintes de formato de área de transferência mantida pelo sistema.
SetClipboardData	Coloca dados na área de transferência em um formato de área de transferência especificado. A janela deve ser o proprietário da área de transferência atual e o aplicativo deve ter chamado a função OpenClipboard. (Ao responder à mensagem WM_RENDERFORMAT, o proprietário da área de transferência não deve chamar OpenClipboard antes de chamar SetClipboardData.)
SetClipboardViewer	Adiciona a janela especificada à cadeia de visualizadores da área de transferência. As janelas do visualizador de área de transferência recebem uma mensagem WM_DRAWCLIPBOARD sempre que o conteúdo da área de transferência for alterado.

Mensagens de área de transferência

Nome	Descrição
WM_CLEAR	Enviado para um controle de edição ou caixa de combinação para excluir (desmarcar) a seleção atual, se houver, do controle de edição.
WM_COPY	Enviado para uma caixa de combinação ou controle de edição para copiar a seleção atual para a área de transferência no formato CF_TEXT.
WM_CUT	Enviado para um controle de edição ou caixa de combinação para excluir (recortar) a seleção atual, se houver, no controle de edição e copiar o texto excluído para a área de transferência no formato CF_TEXT.
WM_PASTE	Enviado para uma caixa de combinação ou controle de edição para copiar o conteúdo atual da área de transferência para o controle de edição na posição de cursor atual. Os dados serão inseridos somente se a área de transferência contiver dados no formato CF_TEXT.

Notificações da área de transferência

Nome	Descrição
WM_ASKCBFORMATNAME	Enviado ao proprietário da área de transferência por uma janela do visualizador da área de transferência para solicitar o nome de um formato de área de transferência CF_OWNERDISPLAY.
WM_CHANGECBCHAIN	Enviado para a primeira janela na cadeia de visualizadores da área de transferência quando uma janela está sendo removida da cadeia.
WM_CLIPBOARDUPDATE	Enviado quando o conteúdo da área de transferência tiver sido alterado.
WM_DESTROYCLIPBOARD	Enviada ao proprietário da área de transferência quando uma chamada para a função EmptyClipboard esvazia a área de transferência.
WM_DRAWCLIPBOARD	Enviado para a primeira janela na cadeia de visualizadores da área de transferência quando o conteúdo da área de transferência é alterado. Isso permite que uma janela do visualizador de área de transferência exiba o novo conteúdo da área de transferência.
WM_HSCROLLCLIPBOARD	Enviado ao proprietário da área de transferência por uma janela do visualizador da área de transferência. Isso ocorre quando a área de transferência contém dados no formato CF_OWNERDISPLAY e um evento ocorre na barra de rolagem horizontal do visualizador da área de transferência. O proprietário deve rolar a imagem da área de transferência e atualizar os valores da barra de rolagem.
WM_PAINTCLIPBOARD	Enviado ao proprietário da área de transferência por uma janela do visualizador da área de transferência quando a área de transferência contém dados no formato CF_OWNERDISPLAY e a área de cliente do visualizador da área de transferência precisa ser repintada.
WM_RENDERALLFORMATS	Enviado ao proprietário da área de transferência antes de ser destruído, se o proprietário da área de transferência tiver atrasado a renderização de um ou mais formatos de área de transferência. Para que o conteúdo da área de transferência permaneça disponível para outros aplicativos, o proprietário da área de transferência deve renderizar dados em todos os formatos que ele é capaz de gerar e colocar os dados na área de transferência chamando a função SetClipboardData.
WM_RENDERFORMAT	Enviado ao proprietário da área de transferência se ele atrasou a renderização de um formato de área de transferência específico e se um aplicativo solicitou dados nesse formato. O proprietário da área de transferência deve renderizar dados no formato especificado e colocá-los na área de transferência chamando a função SetClipboardData.
WM_SIZECLIPBOARD	Enviado ao proprietário da área de transferência por uma janela do visualizador da área de transferência quando a área de transferência contém dados no formato CF_OWNERDISPLAY e a área de cliente do visualizador da área de transferência foi alterada.
WM_VSCROLLCLIPBOARD	Enviado ao proprietário da área de transferência por uma janela do visualizador de área de transferência quando a área de transferência contém dados no formato CF_OWNERDISPLAY e um evento ocorre na barra de rolagem vertical do visualizador de área de transferência. O proprietário deve rolar a imagem da área de transferência e atualizar os valores da barra de rolagem.

Estruturas

Nome	Descrição
METAFILEPICT	Define o formato de imagem de metafile usado para trocar dados de metafile por meio da área de transferência.

Compartilhar via