Clipboard Classe

Definição

public ref class Clipboard sealed

public ref class Clipboard abstract sealed

public sealed class Clipboard

public static class Clipboard

type Clipboard = class

Public NotInheritable Class Clipboard

Public Class Clipboard

Herança

Object

Clipboard

Exemplos

O exemplo de código a seguir usa métodos Clipboard para colocar dados e recuperá-los da Área de Transferência do sistema. Esse código pressupõe button1, button2, textBox1e textBox2 foram criados e colocados no formulário.

O button1_Click método chama SetDataObject para tirar o texto selecionado da caixa de texto e colocá-lo na Área de Transferência do sistema.

O button2_Click método chama GetDataObject para recuperar dados da Área de Transferência do sistema. O código usa IDataObject e DataFormats para extrair os dados retornados e exibe os dados em textBox2.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Takes the selected text from a text box and puts it on the clipboard.
      if ( !textBox1->SelectedText->Equals( "" ) )
      {
         Clipboard::SetDataObject( textBox1->SelectedText );
      }
      else
      {
         textBox2->Text = "No text selected in textBox1";
      }
   }

   void button2_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Declares an IDataObject to hold the data returned from the clipboard.
      // Retrieves the data from the clipboard.
      IDataObject^ iData = Clipboard::GetDataObject();
      
      // Determines whether the data is in a format you can use.
      if ( iData->GetDataPresent( DataFormats::Text ) )
      {
         // Yes it is, so display it in a text box.
         textBox2->Text = (String^)(iData->GetData( DataFormats::Text ));
      }
      else
      {
         // No it is not.
         textBox2->Text = "Could not retrieve data off the clipboard.";
      }
   }

private void button1_Click(object sender, System.EventArgs e) {
    // Takes the selected text from a text box and puts it on the clipboard.
    if(textBox1.SelectedText != "")
       Clipboard.SetDataObject(textBox1.SelectedText);
    else
       textBox2.Text = "No text selected in textBox1";
 }
 
 private void button2_Click(object sender, System.EventArgs e) {
    // Declares an IDataObject to hold the data returned from the clipboard.
    // Retrieves the data from the clipboard.
    IDataObject iData = Clipboard.GetDataObject();
 
    // Determines whether the data is in a format you can use.
    if(iData.GetDataPresent(DataFormats.Text)) {
       // Yes it is, so display it in a text box.
       textBox2.Text = (String)iData.GetData(DataFormats.Text); 
    }
    else {
       // No it is not.
       textBox2.Text = "Could not retrieve data off the clipboard.";
    }
 }

Private Sub button1_Click(sender As Object, e As System.EventArgs)
    ' Takes the selected text from a text box and puts it on the clipboard.
    If textBox1.SelectedText <> "" Then
        Clipboard.SetDataObject(textBox1.SelectedText)
    Else
        textBox2.Text = "No text selected in textBox1"
    End If
End Sub
 
Private Sub button2_Click(sender As Object, e As System.EventArgs)
    ' Declares an IDataObject to hold the data returned from the clipboard.
    ' Retrieves the data from the clipboard.
    Dim iData As IDataObject = Clipboard.GetDataObject()
    
    ' Determines whether the data is in a format you can use.
    If iData.GetDataPresent(DataFormats.Text) Then
        ' Yes it is, so display it in a text box.
        textBox2.Text = CType(iData.GetData(DataFormats.Text), String)
    Else
        ' No it is not.
        textBox2.Text = "Could not retrieve data off the clipboard."
    End If
End Sub

Comentários

Para obter uma lista de formatos predefinidos a serem usados com a Clipboard classe , consulte a DataFormats classe .

Chame SetDataObject para colocar dados na Área de Transferência, substituindo seu conteúdo atual. Para colocar uma cópia persistente dos dados na Área de Transferência, defina o copy parâmetro como true.

Chame GetDataObject para recuperar dados da Área de Transferência. Os dados são retornados como um objeto que implementa a IDataObject interface . Use os métodos especificados por IDataObject campos e em DataFormats para extrair os dados do objeto . Se você não souber o formato dos dados recuperados, chame o GetFormats método da IDataObject interface para obter uma lista de todos os formatos nos quais os dados são armazenados. Em seguida, chame o GetData método da IDataObject interface e especifique um formato que seu aplicativo possa usar.

No .NET Framework 2.0, a Clipboard classe fornece métodos adicionais que facilitam o trabalho com a Área de Transferência do sistema. Chame o Clear método para remover todos os dados da Área de Transferência. Para adicionar dados de um formato específico à Área de Transferência, substituindo os dados existentes, chame o método Format apropriadoSet, como SetText, ou chame o SetData método para especificar o formato. Para recuperar dados de um formato específico da Área de Transferência, primeiro chame o método Format apropriado Contains (como ContainsText) para determinar se a Área de Transferência contém dados nesse formato e, em seguida, chame o método Format apropriado Get (como GetText) para recuperar os dados se a Área de Transferência os contiver. Para especificar o formato nessas operações, chame os ContainsData métodos e GetData .

Métodos

Aplica-se a

Confira também

• DataObject
• DataFormats
• IDataObject
• Considerações adicionais sobre Segurança do Windows Forms