Clipboard Classe

Definição

public ref class Clipboard sealed

public sealed class Clipboard

type Clipboard = class

Public NotInheritable Class Clipboard

Herança

Object

Clipboard

Exemplos

O exemplo de código seguinte utiliza Clipboard métodos para colocar dados e recuperá-los da Área de Transferência do sistema. Este código assume button1, button2, textBox1, e textBox2 foram criados e colocados no formulário.

O button1_Click método chama SetDataObject para pegar no texto selecionado da caixa de texto e colocá-lo na Prancheta do sistema.

O button2_Click método chama GetDataObject para recuperar dados do Clipboard do sistema. O código usa IDataObject e DataFormats para extrair os dados retornados e apresenta 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

Observações

Para uma lista de formatos pré-definidos a usar com a Clipboard classe, veja a DataFormats classe.

Pedido SetDataObject para colocar dados na Prancheta, substituindo o seu conteúdo atual. Para colocar uma cópia persistente dos dados na Prancheta, defina o copy parâmetro para true.

Chamar GetDataObject para recuperar dados da Prancheta. Os dados são devolvidos como um objeto que implementa a IDataObject interface. Use os métodos especificados por IDataObject campos e para DataFormats extrair os dados do objeto. Se não souber o formato dos dados que recuperou, chame o GetFormats método da IDataObject interface para obter uma lista de todos os formatos em que os dados estão armazenados. Depois chama o GetData método da IDataObject interface e especifica um formato que a tua aplicação possa usar.

A Clipboard classe fornece métodos adicionais que facilitam o trabalho com o sistema Clipboard. Chama o Clear método para remover todos os dados da Área de Transferência. Para adicionar dados de um determinado formato ao Clipboard, 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 determinado formato da Área de Transferências, primeiro chame o método Formato apropriado Contains (como ContainsText) para determinar se a Área de Transferência contém dados nesse formato, e depois chame o método Formato apropriado Get (como GetText) para recuperar os dados se a Área de Transferência os conter. Para especificar o formato nestas operações, chame os ContainsData métodos e GetData em vez disso.

Ver também

• DataObject
• DataFormats
• IDataObject
• Considerações adicionais de segurança no Windows Forms