Clipboard Classe

Definição

Fornece métodos estáticos que facilitam a transferência de dados de e para a Área de Transferência do sistema.Provides static methods that facilitate transferring data to and from the system Clipboard.

public ref class Clipboard abstract sealed
public static class Clipboard
type Clipboard = class
Public Class Clipboard
Herança
Clipboard

Exemplos

O exemplo a seguir mostra como adicionar dados à área de transferência do sistema.The following example shows how to add data to the system Clipboard.


// 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 WindowsWindows para compartilhar a área de transferência do sistema, portanto, o conteúdo está sujeito a alterações quando você alterna para outro aplicativo.All applications for WindowsWindows share the system Clipboard, so the contents are subject to change when you switch to another application.

Para obter uma lista de formatos predefinidos disponíveis para Clipboard uso com a classe DataFormats , consulte a classe.For a list of predefined formats available to use with the Clipboard class, see the DataFormats class.

Alerta de segurança: Para fins de segurança, os pontos a seguir devem ser mantidos em mente.Security Alert: For security purposes, the following points should be kept in mind.

  • As operações de colagem precisam ser iniciadas pelo usuário (Ctrl-V, menu colar).Paste operations need to be user initiated (Ctrl-V, Paste Menu).

  • A cópia só pode estar no conteúdo selecionado pelo usuário.Copy can only be on user selected content.

  • Ao copiar ou recortar, o código de confiança parcial XAML (linguagem XAML)Extensible Application Markup Language (XAML) coloca o texto não criptografado e fica na área de transferência.On copy or cut, partial trust code puts plaintext and XAML (linguagem XAML)Extensible Application Markup Language (XAML) on to the clipboard. O texto não criptografado inclui texto, texto Unicode, textos de OEM (modelo de troca de objetos) e CSV (valores separados por vírgula).Plaintext includes text, Unicode text, OEM (Object Exchange Model) text, and CSV (Comma-separated values).

  • Ao colar, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) o será XAML (linguagem XAML)Extensible Application Markup Language (XAML) colado se a origem desse conteúdo for de um site igualmente confiável ou confiável.On paste, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) will paste in XAML (linguagem XAML)Extensible Application Markup Language (XAML) if the source of that content is from a equally trusted or more trusted site. Especificamente:Specifically:

    • Um aplicativo de confiança parcial pode XAML (linguagem XAML)Extensible Application Markup Language (XAML) colar de um aplicativo de confiança total.A partial trust application can paste XAML (linguagem XAML)Extensible Application Markup Language (XAML) from a full trust application.

    • Um aplicativo de confiança parcial pode XAML (linguagem XAML)Extensible Application Markup Language (XAML) colar de um aplicativo de confiança parcial.A partial trust application can paste XAML (linguagem XAML)Extensible Application Markup Language (XAML) from a partial trust application.

    • Um aplicativo de confiança total pode colar XAML somente de outro aplicativo totalmente confiável.A full trust application can paste XAML only from another fully trusted application.

    • Um aplicativo deWindows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) confiança não total pode examinar o formato ApplicationTrust na área de transferência e limpar o XAML, se apropriado.A non-Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) full trust application can examine the ApplicationTrust format on the clipboard and sanitize the XAML if appropriate.

Métodos

Clear()

Limpa todos os dados da área de transferência do sistema.Clears any data from the system Clipboard.

ContainsAudio()

Consultas a Área de Transferência quanto à presença de dados no formato de dados WaveAudio.Queries the Clipboard for the presence of data in the WaveAudio data format.

ContainsData(String)

Consulta a Área de Transferência quanto à presença de dados no formato de dados especificado.Queries the Clipboard for the presence of data in a specified data format.

ContainsFileDropList()

Consultas a Área de Transferência quanto à presença de dados no formato de dados FileDrop.Queries the Clipboard for the presence of data in the FileDrop data format.

ContainsImage()

Consultas a Área de Transferência quanto à presença de dados no formato de dados Bitmap.Queries the Clipboard for the presence of data in the Bitmap data format.

ContainsText()

Consultas a Área de Transferência quanto à presença de dados no formato UnicodeText.Queries the Clipboard for the presence of data in the UnicodeText format.

ContainsText(TextDataFormat)

Consultas a Área de Transferência quanto à presença de dados em um formato de dados de texto.Queries the Clipboard for the presence of data in a text data format.

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.Permanently adds the data that is on the Clipboard so that it is available after the data's original application closes.

GetAudioStream()

Retorna um fluxo de dados da Área de Transferência no formato de dados WaveAudio.Returns a stream of Clipboard data in the WaveAudio data format.

GetData(String)

Recupera dados em um formato especificado da Área de transferência.Retrieves data in a specified format from the Clipboard.

GetDataObject()

Retorna um objeto de dados que representa todo o conteúdo da Área de Transferência.Returns a data object that represents the entire contents of the Clipboard.

GetFileDropList()

Retorna uma coleção de cadeia de caracteres que contém uma lista de arquivos ignorados disponíveis na Área de Transferência.Returns a string collection that contains a list of dropped files available on the Clipboard.

GetImage()

Retorna um objeto BitmapSource da Área de Transferência que contém dados no formato Bitmap.Returns a BitmapSource object from the Clipboard that contains data in the Bitmap format.

GetText()

Retorna uma cadeia de caracteres que contém os dados UnicodeText na Área de Transferência.Returns a string containing the UnicodeText data on the Clipboard.

GetText(TextDataFormat)

Retorna uma cadeia de caracteres que contém os dados de texto na Área de Transferência.Returns a string containing text data on the Clipboard.

IsCurrent(IDataObject)

Compara a um objeto de dados especificado ao conteúdo da Área de Transferência.Compares a specified data object to the contents of the Clipboard.

SetAudio(Byte[])

Armazena dados de áudio (formato de dados WaveAudio) na Área de Transferência.Stores audio data (WaveAudio data format) on the Clipboard. Os dados de áudio são especificados como uma matriz de bytes.The audio data is specified as a byte array.

SetAudio(Stream)

Armazena dados de áudio (formato de dados WaveAudio) na Área de Transferência.Stores audio data (WaveAudio data format) on the Clipboard. Os dados de áudio são especificados como um fluxo.The audio data is specified as a stream.

SetData(String, Object)

Armazena os dados especificados na Área de Transferência no formato especificado.Stores the specified data on the Clipboard in the specified format.

SetDataObject(Object)

Insere um objeto de dados não persistentes especificado na área de transferência do sistema.Places a specified non-persistent data object on the system Clipboard.

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.Places a specified data object on the system Clipboard and accepts a Boolean parameter that indicates whether the data object should be left on the Clipboard when the application exits.

SetFileDropList(StringCollection)

Armazena dados FileDrop na área de transferência.Stores FileDrop data on the Clipboard. A lista de arquivos ignorados é especificada como uma coleção de cadeia de caracteres.The dropped file list is specified as a string collection.

SetImage(BitmapSource)

Armazena dados Bitmap na área de transferência.Stores Bitmap data on the Clipboard. Os dados da imagem são especificados como um BitmapSource.The image data is specified as a BitmapSource.

SetText(String)

Armazena dados UnicodeText na área de transferência.Stores UnicodeText data on the Clipboard.

SetText(String, TextDataFormat)

Armazena dados de texto na área de transferência em um formato de dados de texto especificado.Stores text data on the Clipboard in a specified text data format. Os dados UnicodeText a serem armazenados são especificados como uma cadeia de caracteres.The UnicodeText data to store is specified as a string.

Aplica-se a

Veja também