ClipboardProxy Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece métodos para manipular a Prancheta.
public ref class ClipboardProxypublic class ClipboardProxytype ClipboardProxy = classPublic Class ClipboardProxy- Herança
-
ClipboardProxy
Exemplos
Este exemplo lê texto da Prancheta para a cadeia textOnClipboard.
Dim textOnClipboard As String = My.Computer.Clipboard.GetText()
Este exemplo falhará se não houver texto na Área de Transferências.
Observações
Itens movidos ou copiados para a Área de Transferência persistem mesmo depois de a aplicação ser encerrada.
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 uma lista de formatos predefinidos a usar com a Prancheta, veja DataFormats. Quando um item é movido ou copiado para a Prancheta, itens noutros formatos são apagados. 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 outras aplicações. Coloque os dados na Área de Transferência em múltiplos formatos para maximizar a possibilidade de uma aplicação-alvo, cujos requisitos de formato pode não conhecer, conseguir recuperar os dados com sucesso.
Como todas as aplicações Windows partilham a Área de Transferência do sistema, o conteúdo pode mudar quando muda para outra aplicação.
Uma classe deve ser serializável para ser colocada na Prancheta. Para mais informações, veja Serialização - C# ou Serialização - Visual Basic.
Ao aceder remotamente à Prancheta, a ThreadStateException é lançado a a menos que a thread de acesso opere em modo STA (apartamento single-threaded). Para resolver este problema, defina o ThreadApartmentState para STA. Para obter mais informações, veja STAThreadAttribute.
Para mais informações, consulte Armazenar Dados e Ler a partir da Área de Transferências.
Disponibilidade por tipo de projeto
| Tipo de Projeto | Available |
|---|---|
| Aplicação do Windows | Sim |
| Biblioteca de Classes | Sim |
| Aplicativo de console | Sim |
| Biblioteca de Controlo do Windows | Sim |
| Biblioteca de controle da Web | No |
| Serviço Windows | Sim |
| Web site | No |
Métodos
| Name | Description |
|---|---|
| Clear() |
Limpa a prancheta. |
| 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() |
Devolve a |
| ContainsImage() |
Devolve uma |
| ContainsText() |
Determina se há texto na prancheta. |
| ContainsText(TextDataFormat) |
Determina se há texto na prancheta. |
| 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 num formato personalizado a partir do Clipboard. |
| GetDataObject() |
Recupera dados da Área de Transferência como um IDataObject. |
| GetFileDropList() |
Recupera uma coleção de cadeias que representam nomes de ficheiros a partir da Área de Transferências. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetImage() |
Recupera uma imagem da Prancheta. |
| GetText() |
Recupera texto do Clipboard. |
| GetText(TextDataFormat) |
Recupera texto do Clipboard. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| SetAudio(Byte[]) |
Grava os dados de áudio na Área de Transferência. |
| SetAudio(Stream) |
Grava os dados de áudio na Área de Transferência. |
| SetData(String, Object) |
Escreve dados num formato personalizado na Área de Transferência. |
| SetDataObject(DataObject) |
Escreve A DataObject na prancheta. |
| SetFileDropList(StringCollection) |
Escreve uma coleção de cadeias que representam os caminhos dos ficheiros para a Área de Transferências. |
| SetImage(Image) |
Escreve uma imagem no Clipboard. |
| SetText(String, TextDataFormat) |
Escreve texto na prancheta. |
| SetText(String) |
Escreve texto na prancheta. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |