ClipboardProxy Classe

Referência

Definição

Namespace:: Microsoft.VisualBasic.MyServices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece métodos para manipular a Área de Transferência.

public ref class ClipboardProxy

public class ClipboardProxy

type ClipboardProxy = class

Public Class ClipboardProxy

Herança: Object
ClipboardProxy

Exemplos

Este exemplo lê o texto da Área de Transferência na cadeia de caracteres textOnClipboard.

Dim textOnClipboard As String = My.Computer.Clipboard.GetText()

Este exemplo falhará se não houver texto na Área de Transferência.

Comentários

Os itens movidos ou copiados para a Área de Transferência persistem mesmo depois que o aplicativo é desligado.

Os dados na Área de Transferência podem estar em qualquer formato de dados, também chamado de formato de Área de Transferência. Para obter uma lista de formatos predefinidos a serem usados com a Área de Transferência, consulte DataFormats. Quando um item é movido ou copiado para a Área de Transferência, os itens em outros formatos são limpos. Para fazer com que outros formatos persistam, use DataObject, que copia tudo o que existe na Área de Transferência atual, incluindo itens colados de outros aplicativos. Coloque dados na Área de Transferência em vários formatos para maximizar a possibilidade de que um aplicativo de destino, cujos requisitos de formato talvez você não saiba, possa recuperar os dados com êxito.

Como todos os aplicativos do Windows compartilham a Área de Transferência do sistema, o conteúdo pode ser alterado quando você alterna para outro aplicativo.

Uma classe deve ser serializável para que ela seja colocada na Área de Transferência. Para obter mais informações, consulte Serialização – C# ou Serialização – Visual Basic.

Ao acessar a Área de Transferência remotamente, um ThreadStateException é gerado, a menos que o thread de acesso opere no modo STA (apartment de thread único). Para resolve esse problema, defina como ThreadApartmentStateSTA. Para obter mais informações, consulte STAThreadAttribute.

Para obter mais informações, confira Como armazenar dados e ler na área de transferência.

Disponibilidade por tipo de projeto

Tipo de projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo do Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controles da Web	Não
Serviço do Windows	Sim
Site	Não

Métodos

Clear()	Limpa a área de transferência.
ContainsAudio()	Indica se a área de transferência contém dados de áudio.
ContainsData(String)	Indica se a área de transferência contém dados no formato personalizado especificado.
ContainsFileDropList()	Retorna um `Boolean` que indica se a área de transferência contém uma lista suspensa de arquivos.
ContainsImage()	Retorna um `Boolean` que indica se uma imagem está armazenada na área de transferência.
ContainsText()	Determina se há texto na área de transferência.
ContainsText(TextDataFormat)	Determina se há texto na área de transferência.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetAudioStream()	Recupera um fluxo de áudio da área de transferência.
GetData(String)	Recupera dados em um formato personalizado da área de transferência.
GetDataObject()	Recupera dados da área de transferência como um IDataObject.
GetFileDropList()	Recupera uma coleção de cadeias de caracteres representando nomes de arquivo da Área de Transferência.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetImage()	Recupera uma imagem da área de transferência.
GetText()	Recupera texto da Área de Transferência.
GetText(TextDataFormat)	Recupera texto da Área de Transferência.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SetAudio(Byte[])	Grava dados de áudio na Área de Transferência.
SetAudio(Stream)	Grava dados de áudio na Área de Transferência.
SetData(String, Object)	Grava dados em um formato personalizado na área de transferência.
SetDataObject(DataObject)	Grava um DataObject na área de transferência.
SetFileDropList(StringCollection)	Grava uma coleção de cadeias de caracteres representando caminhos de arquivo na Área de Transferência.
SetImage(Image)	Grava uma imagem na Área de Transferência.
SetText(String)	Grava texto na Área de Transferência.
SetText(String, TextDataFormat)	Grava texto na Área de Transferência.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Partilhar via