Partilhar via

Área de transferência

O da á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 secção

Os tópicos a seguir fornecem informações sobre a área de transferência, formatos da área de transferência, operações da área de transferência e mensagens da área de transferência. A referência da API contém as funções e mensagens que você pode usar para trabalhar com a área de transferência.

Designação 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.
Operações da Á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 corte e cópia e recupera dados da área de transferência para operações de colagem.
de formato HTML Clipboard 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.
de referência da área de transferência Contém a referência da API.

Funções da Área de Transferência

A tabela a seguir lista as funções que você pode usar para trabalhar com a área de transferência:

Designação Descrição
AddClipboardFormatListener Coloca a janela fornecida na lista de ouvintes em 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.
CountClipboardFormatos Recupera o número de diferentes formatos de dados atualmente na área de transferência.
EsvaziarÁrea de Transferência 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.
EnumClipboardFormats 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 formato 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.
GetClipboardProprietário Recupera a alça 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 do visualizador da área de transferência.
GetOpenClipboardWindow Recupera a alça 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 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 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 os dados na área de transferência em um formato de área de transferência especificado. A janela deve ser a atual proprietária do conteúdo da área de transferência, e a aplicação deve ter invocado 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 da área de transferência recebem uma mensagem WM_DRAWCLIPBOARD sempre que o conteúdo da área de transferência é alterado.

Mensagens da área de transferência

A tabela a seguir lista as mensagens enviadas para as janelas do visualizador da área de transferência:

Designação Descrição
WM_CLEAR Enviado para um controle de edição ou caixa de combinação para excluir (limpar) 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 formato CF_TEXT .
WM_CUT Enviado para uma caixa de edição ou caixa de combinação para excluir (cortar) a seleção atual, caso haja, na caixa de edição e copiar o texto excluído para a área de transferência no formato CF_TEXT.
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 são inseridos somente se a área de transferência contiver dados em formato CF_TEXT.

Notificações da área de transferência

A tabela a seguir lista as mensagens de notificação da área de transferência enviadas para as janelas do visualizador da área de transferência:

Designação Descrição
WM_ASKCBFORMATNAME Enviado ao proprietário da área de transferência pela janela de visualização 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 do visualizador 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 foi 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 do visualizador 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 ocorre um evento 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 do Clipboard por uma janela do visualizador do Clipboard quando este contém dados no formato CF_OWNERDISPLAY e a área do cliente do visualizador requer repintura.
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 os dados no formato especificado e colocá-los na área de transferência ao chamar 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

A tabela a seguir lista as estruturas usadas com a área de transferência:

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