Partilhar via


ClipboardProxy Classe

Definição

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
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

Confira também