Clipboard Classe

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
PresentationCore.dll

Fornece métodos estáticos que facilitam a transferência de dados para e a partir da Prancheta 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 seguinte mostra como adicionar dados à Prancheta 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))

Observações

Todas as aplicações para Windows partilham a Área de Transferência do sistema, por isso o conteúdo está sujeito a alterações quando muda para outra aplicação.

Para uma lista de formatos pré-definidos disponíveis para uso com a Clipboard classe, consulte a DataFormats classe.

Alerta de Segurança: Por razões de segurança, os seguintes pontos devem ser tidos em conta.

  • As operações de colar precisam de ser iniciadas pelo utilizador (Ctrl-V, Menu de Colar).

  • A cópia só pode ser feita sobre conteúdos selecionados pelo utilizador.

  • Ao copiar ou cortar, o código de confiança parcial coloca texto simples e a Extensible Application Markup Language (XAML) na prancheta. O texto simples inclui texto, texto Unicode, texto OEM (Object Exchange Model) e CSV (valores separados por vírgulas).

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

    • Uma aplicação de trust parcial pode colar a Extensible Application Markup Language (XAML) de uma aplicação full trust.

    • Uma aplicação de trust parcial pode colar a Extensible Application Markup Language (XAML) a partir de uma aplicação de trust parcial.

    • Uma aplicação de confiança total só pode colar XAML de outra aplicação totalmente confiável.

    • Uma aplicação de total confiança que não seja Windows Presentation Foundation (WPF) pode examinar o formato ApplicationTrust na área de transferência e limpar o XAML, se apropriado.

Métodos

Name Description
Clear()

Apaga qualquer dado da Prancheta de Transferência do sistema.
ContainsAudio()

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

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

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

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

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

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

Adiciona permanentemente os dados que estão no Clipboard para que fiquem disponíveis após o encerramento da aplicação original dos dados.
GetAudioStream()

Devolve um fluxo de dados do Clipboard no WaveAudio formato de dados.
GetData(String)

Recupera dados num formato especificado a partir da Área de Transferências.
GetDataObject()

Devolve um objeto de dados que representa todo o conteúdo da Área de Transferências.
GetFileDropList()

Devolve uma coleção de strings que contém uma lista dos ficheiros descartados disponíveis na Área de Transferências.
GetImage()

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

Devolve uma cadeia contendo os UnicodeText dados na Área de Transferência.
GetText(TextDataFormat)

Devolve uma cadeia contendo dados de texto na Área de Transferências.
IsCurrent(IDataObject)

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

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

Armazena dados de áudio (WaveAudio formato de dados) na Área de Transferências. 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, Boolean)

Coloca um objeto de dados especificado na Área de Transferência do sistema e aceita um parâmetro Booleano que indica se o objeto de dados deve ser deixado na Área de Transferência quando a aplicação sair.
SetDataObject(Object)

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

Armazena FileDrop os dados na Prancheta. A lista de ficheiros descartada é especificada como uma coleção de strings.
SetImage(BitmapSource)

Armazena Bitmap os dados na Prancheta. Os dados da imagem são especificados como um BitmapSource.
SetText(String, TextDataFormat)

Armazena os dados de texto na Área de Transferência num formato de dados de texto especificado. Os UnicodeText dados a armazenar são especificados como uma cadeia.
SetText(String)

Armazena UnicodeText os dados na Prancheta.

Aplica-se a

Ver também