Armazenando dados e a leitura da área de transferência (Visual Basic)

Artigo
02/25/2013

A área de transferência pode ser usada para armazenar dados, como textos e imagens.Como a Área de transferência é compartilhada com todos os processos ativos, ela pode ser usada para transferir dados entre eles.O My.Computer.Clipboard objeto permite que você acesse facilmente a área de transferência e ler e gravar nela.

Leitura da área de transferência

Use o GetText método para ler o texto na área de transferência.O código a seguir lê o texto e o exibe em uma caixa de mensagem.É preciso que haja texto armazenado na área de transferência para que o exemplo seja executado corretamente.

MsgBox(My.Computer.Clipboard.GetText())

Este exemplo de código também está disponível como um trecho de código IntelliSense.No selecionador de trechos de código, ele está localizado em Windows Forms Applications > Clipboard.Para mais informações, consulte Trechos de código.

Use o método GetImage para recuperar uma imagem da área de transferência.Este exemplo verifica se há alguma imagem na Área de transferência antes de recuperá-la e atribuí-la a PictureBox1.

If My.Computer.Clipboard.ContainsImage() Then
  Dim grabpicture As System.Drawing.Image
  grabpicture = My.Computer.Clipboard.GetImage()
  picturebox1.Image = grabpicture
End If

Itens colocados na Área de transferência persistirão mesmo após o aplicativo ser encerrado.

Determinando o tipo de arquivo armazenado na área de transferência

Dados na área de transferência podem ser um número de diferentes formulários, como texto, um arquivo de áudio ou uma imagem.Em ordem para determinar que tipo de arquivo está na área de transferência, você pode usar métodos como ContainsAudio,ContainsFileDropList,ContainsImage e ContainsText.O método ContainsData pode ser usado se você tiver um formato personalizado que você deseja verificar.

Use a função ContainsImage para determinar se os dados contidos na área de transferência são uma imagem.O código a seguir verifica para ver se os dados é uma imagem e relatórios de acordo.

If My.Computer.Clipboard.ContainsImage() Then
    MsgBox("Clipboard contains an image.")
Else
    MsgBox("Clipboard does not contain an image.")
End If

Limpando a área de transferência.

O Clear método limpa a área de transferência.Como a Área de transferência é compartilhada por outros processos, limpá-la pode ter um impacto nesses processos.

O código a seguir mostra como usar o Clear método.

My.Computer.Clipboard.Clear()

Escrever para a área de transferência.

Use o método SetText para escrever texto na Área de transferência.O código a seguir grava a cadeia de caracteres "This is a test string" na Área de Transferência.

My.Computer.Clipboard.SetText("This is a test string.")

O SetText método pode aceitar um parâmetro de formato que contém um tipo de TextDataFormat.O código a seguir grava a cadeia de caracteres "This is a test string" na Área de Transferência como texto RTF.

My.Computer.Clipboard.SetText("This is a test string.", 
System.Windows.Forms.TextDataFormat.Rtf)

Use o método SetData para escrever dados na Área de transferência.Este exemplo grava a DataObjectdataChunk na Área de transferência no formato personalizadospecialFormat.

My.Computer.Clipboard.SetData("specialFormat", dataChunk)

Use o método SetAudio para escrever dados de áudio na Área de transferência.Este exemplo cria a matriz de bytes musicReader, lê o arquivo cool.wav nela e o coloca na Área de transferência.

Dim musicReader = My.Computer.FileSystem.ReadAllBytes("cool.wav")
My.Computer.Clipboard.SetAudio(musicReader)

Observação de segurança
Como a área de transferência pode ser acessada por outros usuários, não a use para armazenar informações confidenciais, como senhas ou dados confidenciais.