Área de transferência

Artigo
02/14/2024

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.

Esta visão geral não descreve como copiar e colar objetos vinculados ou incorporados. 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 da Á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 diferente da área de transferência. Os usuários não precisam estar cientes dos formatos da área de transferência usados para um objeto na área de transferência.
Opçõ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 posiciona dados na área de transferência em operações para recortar e copiar e recupera dados da área de transferência em operações para colar.
Formato de área de transferência HTML	Discute o formato da área de transferência HTML.
Como usar 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 da área de transferência

Nome	Descrição
AddClipboardFormatListener	Coloca a janela fornecida na lista de ouvintes de formato da área de transferência mantida pelo sistema.
ChangeClipboardChain	Remove uma janela especificada da cadeia de visualizadores da área de transferência.
FecharÁrea de transferência	Fecha a área de transferência.
CountClipboardFormats	Recupera o número de formatos de dados diferentes atualmente na área de transferência.
EsvaziarÁrea de transferência	Esvazia a área de transferência e libera alças 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.
EnumClipboardFormatos	Enumera os formatos de dados atualmente disponíveis 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 da área de transferência, faça uma série de chamadas para a função EnumClipboardFormats. Para cada chamada, o parâmetro format 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 de 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 da Área de Transferência atualmente suportados.
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 então ser usado como um formato de área de transferência válido.
RemoveClipboardFormatListener	Remove a janela fornecida da lista de ouvintes de formato da á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 atual da área de transferência e o aplicativo deve ter chamado a função OpenClipboard. (Ao responder ao WM_RENDERFORMAT mensagem, 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 da área de transferência recebem uma mensagem de WM_DRAWCLIPBOARD sempre que o conteúdo da área de transferência é alterado.

Mensagens da á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 um controle de edição ou caixa de combinação para copiar a seleção atual para a área de transferência em CF_TEXT formato.
WM_CUT	Enviado para um controle de edição ou caixa de combinação para excluir (cortar) a seleção atual, se houver, no controle de edição e copiar o texto excluído para a área de transferência em CF_TEXT formato.
WM_PASTE	Enviado para um controle de edição ou caixa de combinaçã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 em CF_TEXT formato.

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	Enviado 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 da á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 do 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 da á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 é 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 tiver atrasado a renderização de um formato específico da área de transferência e se um aplicativo tiver solicitado 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 do cliente do visualizador da área de transferência mudou de tamanho.
WM_VSCROLLCLIPBOARD	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 ocorre um evento na barra de rolagem vertical 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.

Estruturas

Nome	Descrição
METAFILEPICT	Define o formato de imagem de metarquivo usado para trocar dados de metarquivo através da área de transferência.