ClipboardProxy Classe
Definição
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 ClipboardProxypublic class ClipboardProxytype ClipboardProxy = classPublic 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 após o aplicativo ser desligado.
Os dados na Área de Transferência podem estar em qualquer formato de dados, também chamado de formato á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 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 Serialization - C# ou Serialization - Visual Basic.
Ao acessar a Área de Transferência remotamente, um ThreadStateException é gerado, a menos que o thread de acesso opere no modo STA (apartamento de thread único). Para resolver esse problema, defina como ThreadApartmentStateSTA. Para obter mais informações, consulte STAThreadAttribute.
Para obter mais informações, consulte Como armazenar dados e ler da área de transferência.
Disponibilidade por tipo de projeto
| Tipo de projeto | Available |
|---|---|
| Aplicativo do Windows | Yes |
| Biblioteca de Classes | Yes |
| Aplicativo de console | Yes |
| Biblioteca de Controle do Windows | Yes |
| Biblioteca de Controles da Web | Não |
| Serviço do Windows | Yes |
| Site da web | Não |
Métodos
| Nome | Description |
|---|---|
| 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 uma |
| ContainsImage() |
Retorna uma |
| 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 que representam nomes de arquivo da Área de Transferência. |
| GetHashCode() |
Serve como a função hash predefinida. (Herdado de Object) |
| GetImage() |
Recupera uma imagem da Área de Transferência. |
| GetText() |
Recupera o texto da área de transferência. |
| GetText(TextDataFormat) |
Recupera o 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 Objectatual. (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 que representam caminhos de arquivo para a Área de Transferência. |
| SetImage(Image) |
Grava uma imagem na Área de Transferência. |
| SetText(String, TextDataFormat) |
Grava texto na Área de Transferência. |
| SetText(String) |
Grava texto na Área de Transferência. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |