Clipboard Classe

Definizione

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

Ereditarietà

Object

Clipboard

Esempio

Nell'esempio di codice seguente vengono Clipboard usati metodi per inserire i dati e recuperarli dagli Appunti di sistema. Questo codice presuppone che , , textBox1button2e siano stati creati e textBox2 inseriti button1nel modulo.

Il button1_Click metodo chiama SetDataObject per accettare testo selezionato dalla casella di testo e inserirlo negli Appunti di sistema.

Il button2_Click metodo chiama GetDataObject per recuperare i dati dagli Appunti di sistema. Il codice usa e DataFormats per estrarre i dati restituiti IDataObject e visualizza i dati in 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

Commenti

Per un elenco di formati predefiniti da usare con la Clipboard classe, vedere la DataFormats classe .

Chiamare SetDataObject per inserire i dati negli Appunti, sostituendo il contenuto corrente. Per inserire una copia persistente dei dati negli Appunti, impostare il copy parametro su true.

Chiamare GetDataObject per recuperare i dati dagli Appunti. I dati vengono restituiti come oggetto che implementa l'interfaccia IDataObject . Usare i metodi specificati da IDataObject e campi in DataFormats per estrarre i dati dall'oggetto. Se non si conosce il formato dei dati recuperati, chiamare il GetFormats metodo dell'interfaccia IDataObject per ottenere un elenco di tutti i formati archiviati nei dati. Chiamare quindi il GetData metodo dell'interfaccia IDataObject e specificare un formato che l'applicazione può usare.

In .NET Framework 2.0 la Clipboard classe fornisce metodi aggiuntivi che semplificano l'uso degli Appunti di sistema. Chiamare il Clear metodo per rimuovere tutti i dati dagli Appunti. Per aggiungere dati di un formato specifico agli Appunti, sostituendo i dati esistenti, chiamare il metodo Format appropriatoSet, ad esempio SetText, o chiamare il metodo per specificare il SetData formato. Per recuperare i dati di un formato specifico dagli Appunti, chiamare prima il metodo Format appropriato (ad esempio ) per determinare se gli Appunti contengono dati in tale formato e quindi chiamare il metodo Format appropriato ContainsGet (ad esempio ContainsTextGetText) per recuperare i dati se contiene gli Appunti. Per specificare il formato in queste operazioni, chiamare invece i ContainsData metodi e GetData .

Metodi

Si applica a

Vedi anche

• DataObject
• DataFormats
• IDataObject
• Considerazioni aggiuntive sulla sicurezza in Windows Form