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 Clipboard Methoden verwendet, um Daten in der Systemablage zu platzieren und aus der Systemablage abzurufen. Dieser Code geht davon aus, dass button1das button2textBox1textBox2 Formular erstellt und platziert wurde.

Die button1_Click Methode ruft den SetDataObject markierten Text aus dem Textfeld auf und platziert ihn in der Systemablage.

Die button2_Click Methode ruft GetDataObject daten aus der Systemablage ab. Der Code verwendet IDataObject und DataFormats extrahiert die zurückgegebenen Daten und zeigt die Daten 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

Hinweise

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

Aufrufen SetDataObject zum Einfügen von Daten in die Zwischenablage und Ersetzen des aktuellen Inhalts. Um eine dauerhafte Kopie der Daten in der Zwischenablage zu platzieren, legen Sie den copy Parameter auf true.

Rufen Sie den Aufruf GetDataObject auf, um Daten aus der Zwischenablage abzurufen. Die Daten werden als Objekt zurückgegeben, das die IDataObject Schnittstelle implementiert. Verwenden Sie die von IDataObject und Feldern DataFormats angegebenen Methoden, 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 Daten gespeichert sind. Rufen Sie dann die GetData Methode der IDataObject Schnittstelle auf, und geben Sie ein Format an, das Ihre Anwendung verwenden kann.

Die Clipboard Klasse stellt 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. Wenn Sie der Zwischenablage Daten eines bestimmten Formats hinzufügen möchten, ersetzen Sie die vorhandenen Daten, rufen Sie die entsprechende SetFormatmethode 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 rufen Sie dann die entsprechende GetFormatmethode (z GetText. B. ) auf, um die Daten abzurufen, wenn die Zwischenablage sie enthält. Rufen Sie stattdessen die ContainsData Methoden auf GetData , um das Format in diesen Vorgängen anzugeben.

Weitere Informationen

• DataObject
• DataFormats
• IDataObject
• Zusätzliche Sicherheitsüberlegungen in Windows Forms