Clipboard Klasse

Definition

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

Vererbung

Object

Clipboard

Beispiele

Im folgenden Codebeispiel werden Methoden verwendet Clipboard , um Daten in zu platzieren und aus der Systemablage abzurufen. Bei diesem Code wird davon ausgegangen, dass button1, button2textBox1, und textBox2 erstellt und im Formular platziert wurden.

Die button1_Click -Methode ruft auf SetDataObject , um ausgewählten Text aus dem Textfeld zu übernehmen und ihn in der Systemablage zu platzieren.

Die button2_Click -Methode ruft auf GetDataObject , um Daten aus der Systemablage abzurufen. Der Code verwendet IDataObject und DataFormats , um die zurückgegebenen Daten zu extrahieren und zeigt die Daten in textBox2an.

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

Hinweise

Eine Liste der vordefinierten Formate, die mit der Clipboard -Klasse verwendet werden sollen, finden Sie in der DataFormats -Klasse.

Rufen Sie auf SetDataObject , um Daten in die Zwischenablage zu verschieben, wobei der aktuelle Inhalt ersetzt wird. Um eine persistente Kopie der Daten in der Zwischenablage zu platzieren, legen Sie den copy Parameter auf fest true.

Rufen Sie auf GetDataObject , um Daten aus der Zwischenablage abzurufen. Die Daten werden als Objekt zurückgegeben, das die IDataObject -Schnittstelle implementiert. Verwenden Sie die methoden, die in den Feldern DataFormats und angegeben sindIDataObject, um die Daten aus dem -Objekt zu extrahieren. Wenn Sie das Format der abgerufenen Daten nicht kennen, rufen Sie die GetFormats -Methode der IDataObject -Schnittstelle auf, um eine Liste aller Formate abzurufen, in denen die Daten gespeichert sind. Rufen Sie dann die GetData -Methode der IDataObject -Schnittstelle auf, und geben Sie ein Format an, das Ihre Anwendung verwenden kann.

In .NET Framework 2.0 stellt die Clipboard -Klasse zusätzliche Methoden bereit, die das Arbeiten mit der Systemablage vereinfachen. Rufen Sie die Clear -Methode auf, um alle Daten aus der Zwischenablage zu entfernen. Um der Zwischenablage Daten eines bestimmten Formats hinzuzufügen, indem Sie die vorhandenen Daten ersetzen, rufen Sie die entsprechende SetFormat-Methode auf, z SetText. B. , oder rufen Sie die SetData -Methode auf, um das Format anzugeben. Um Daten eines bestimmten Formats aus der Zwischenablage abzurufen, rufen Sie zuerst die entsprechende ContainsFormat-Methode (z ContainsText. B. ) auf, um zu bestimmen, ob die Zwischenablage Daten in diesem Format enthält, und dann die entsprechende GetFormat-Methode (z GetText. B. ), um die Daten abzurufen, wenn die Zwischenablage sie enthält. Um das Format in diesen Vorgängen anzugeben, rufen Sie stattdessen die ContainsData Methoden und auf GetData .

Methoden

Gilt für:

Weitere Informationen

• DataObject
• DataFormats
• IDataObject
• Weitere Überlegungen zur Sicherheit in Windows Forms