Clipboard Classe

Referência

Definição

Namespace:: System.Windows

Assembly:: PresentationCore.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 estáticos que facilitam a transferência de dados de e para a Área de Transferência do sistema.

public ref class Clipboard abstract sealed

public static class Clipboard

type Clipboard = class

Public Class Clipboard

Herança: Object
Clipboard

Exemplos

O exemplo a seguir mostra como adicionar dados à Área de Transferência do sistema.


// For this example, the data to be placed on the clipboard is a simple
// string.
string textData = "I want to put this string on the clipboard.";

// After this call, the data (string) is placed on the clipboard and tagged
// with a data format of "Text".
Clipboard.SetData(DataFormats.Text, (Object)textData);

' For this example, the data to be placed on the clipboard is a simple
' string.
Dim textData As String = "I want to put this string on the clipboard."

' After this call, the data (string) is placed on the clipboard and tagged
' with a data format of "Text".
Clipboard.SetData(DataFormats.Text, CType(textData, Object))

Comentários

Todos os aplicativos para Windows compartilham a Área de Transferência do sistema, portanto, o conteúdo está sujeito a alterações quando você alterna para outro aplicativo.

Para obter uma lista de formatos predefinidos disponíveis para uso com a Clipboard classe , consulte a DataFormats classe .

Alerta de segurança: Para fins de segurança, os pontos a seguir devem ser mantidos em mente.

As operações de colagem precisam ser iniciadas pelo usuário (Ctrl-V, Menu Colar).
A cópia só pode estar no conteúdo selecionado pelo usuário.
Ao copiar ou recortar, o código de confiança parcial coloca texto não criptografado e XAML (Extensible Application Markup Language) na área de transferência. Texto sem formatação inclui texto, texto Unicode, texto OEM (Modelo do Exchange de Objeto) e CSV (valores separados por vírgula).
Ao colar, Windows Presentation Foundation (WPF) colará em XAML (Extensible Application Markup Language) se a fonte desse conteúdo for de um site igualmente confiável ou mais confiável. Especificamente:
- Um aplicativo de confiança parcial pode colar XAML (Extensible Application Markup Language) de um aplicativo de confiança total.
- Um aplicativo de confiança parcial pode colar XAML (Extensible Application Markup Language) de um aplicativo de confiança parcial.
- Um aplicativo de confiança total pode colar XAML somente de outro aplicativo totalmente confiável.
- Um aplicativo de confiança total não Windows Presentation Foundation (WPF) pode examinar o formato ApplicationTrust na área de transferência e limpar o XAML, se apropriado.

Métodos

Clear()	Limpa todos os dados da área de transferência do sistema.
ContainsAudio()	Consultas a Área de Transferência quanto à presença de dados no formato de dados WaveAudio.
ContainsData(String)	Consulta a Área de Transferência quanto à presença de dados no formato de dados especificado.
ContainsFileDropList()	Consultas a Área de Transferência quanto à presença de dados no formato de dados FileDrop.
ContainsImage()	Consultas a Área de Transferência quanto à presença de dados no formato de dados Bitmap.
ContainsText()	Consultas a Área de Transferência quanto à presença de dados no formato UnicodeText.
ContainsText(TextDataFormat)	Consultas a Área de Transferência quanto à presença de dados em um formato de dados de texto.
Flush()	Adiciona permanentemente os dados que estão no Clipboard para que eles estejam disponíveis depois que o aplicativo original dos dados for fechado.
GetAudioStream()	Retorna um fluxo de dados da Área de Transferência no formato de dados WaveAudio.
GetData(String)	Recupera dados em um formato especificado da Área de transferência.
GetDataObject()	Retorna um objeto de dados que representa todo o conteúdo da Área de Transferência.
GetFileDropList()	Retorna uma coleção de cadeia de caracteres que contém uma lista de arquivos ignorados disponíveis na Área de Transferência.
GetImage()	Retorna um objeto BitmapSource da Área de Transferência que contém dados no formato Bitmap.
GetText()	Retorna uma cadeia de caracteres que contém os dados UnicodeText na Área de Transferência.
GetText(TextDataFormat)	Retorna uma cadeia de caracteres que contém os dados de texto na Área de Transferência.
IsCurrent(IDataObject)	Compara a um objeto de dados especificado ao conteúdo da Área de Transferência.
SetAudio(Byte[])	Armazena dados de áudio (formato de dados WaveAudio) na Área de Transferência. Os dados de áudio são especificados como uma matriz de bytes.
SetAudio(Stream)	Armazena dados de áudio (formato de dados WaveAudio) na Área de Transferência. Os dados de áudio são especificados como um fluxo.
SetData(String, Object)	Armazena os dados especificados na Área de Transferência no formato especificado.
SetDataObject(Object)	Insere um objeto de dados não persistentes especificado na área de transferência do sistema.
SetDataObject(Object, Boolean)	Coloca um objeto de dados especificado na área de transferência do sistema e aceita um parâmetro booliano que indica se o objeto de dados deve ser deixado na área de transferência quando o aplicativo é encerrado.
SetFileDropList(StringCollection)	Armazena dados FileDrop na área de transferência. A lista de arquivos ignorados é especificada como uma coleção de cadeia de caracteres.
SetImage(BitmapSource)	Armazena dados Bitmap na área de transferência. Os dados da imagem são especificados como um BitmapSource.
SetText(String)	Armazena dados UnicodeText na área de transferência.
SetText(String, TextDataFormat)	Armazena dados de texto na área de transferência em um formato de dados de texto especificado. Os dados UnicodeText a serem armazenados são especificados como uma cadeia de caracteres.

Aplica-se a

Compartilhar via