Clipboard Classe

Definição

Namespace:
System.Windows
Assembly:
PresentationCore.dll

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 compartilhar 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 o texto sem formatação e a XAML (Linguagem de Marcação de Aplicativo Extensível) na área de transferência. O texto sem formatação inclui texto, texto Unicode, texto OEM (Objeto Exchange Modelo) e CSV (valores separados por vírgulas).

  • Ao colar, Windows Presentation Foundation (WPF) colará em XAML (Extensible Application Markup Language) se a origem desse conteúdo for de um site igualmente confiável ou mais confiável. Specifically:

    • 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

Nome Description
Clear()

Limpa todos os dados da área de transferência do sistema.
ContainsAudio()

Consulta a Área de Transferência quanto à presença de dados no WaveAudio formato de dados.
ContainsData(String)

Consulta a Área de Transferência para a presença de dados em um formato de dados especificado.
ContainsFileDropList()

Consulta a Área de Transferência quanto à presença de dados no FileDrop formato de dados.
ContainsImage()

Consulta a Área de Transferência quanto à presença de dados no Bitmap formato de dados.
ContainsText()

Consulta a Área de Transferência quanto à presença de dados no UnicodeText formato.
ContainsText(TextDataFormat)

Consulta a Área de Transferência para a presença de dados em um formato de dados de texto.
Flush()

Adiciona permanentemente os dados que estão no Clipboard para que fiquem disponíveis após o fechamento do aplicativo original dos dados.
GetAudioStream()

Retorna um fluxo de dados da Área de Transferência no WaveAudio formato de dados.
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 cadeias de caracteres que contém uma lista de arquivos descartados disponíveis na Área de Transferência.
GetImage()

Retorna um BitmapSource objeto da Área de Transferência que contém dados no Bitmap formato.
GetText()

Retorna uma cadeia de caracteres que contém os UnicodeText dados na Área de Transferência.
GetText(TextDataFormat)

Retorna uma cadeia de caracteres que contém dados de texto na Área de Transferência.
IsCurrent(IDataObject)

Compara um objeto de dados especificado com o conteúdo da Área de Transferência.
SetAudio(Byte[])

Armazena dados de áudio (WaveAudio formato de dados) na Área de Transferência. Os dados de áudio são especificados como uma matriz de bytes.
SetAudio(Stream)

Armazena dados de áudio (WaveAudio formato de dados) 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.
SetDataAsJson<T>(String, T)

Fornece métodos estáticos que facilitam a transferência de dados de e para a Á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.
SetDataObject(Object)

Coloca um objeto de dados não persistente especificado na área de transferência do sistema.
SetFileDropList(StringCollection)

Armazena FileDrop dados na Área de Transferência. A lista de arquivos descartada é especificada como uma coleção de cadeias de caracteres.
SetImage(BitmapSource)

Armazena Bitmap dados na Área de Transferência. Os dados da imagem são especificados como um BitmapSource.
SetText(String, TextDataFormat)

Armazena dados de texto na Área de Transferência em um formato de dados de texto especificado. Os UnicodeText dados a serem armazenados são especificados como uma cadeia de caracteres.
SetText(String)

Armazena UnicodeText dados na Área de Transferência.
TryGetData<T>(String, Func<TypeName,Type>, T)

Fornece métodos estáticos que facilitam a transferência de dados de e para a Área de Transferência do sistema.
TryGetData<T>(String, T)

Fornece métodos estáticos que facilitam a transferência de dados de e para a Área de Transferência do sistema.

Aplica-se a

Confira também