Clipboard Klas

Definitie

public ref class Clipboard sealed

public sealed class Clipboard

type Clipboard = class

Public NotInheritable Class Clipboard

Overname

Object

Clipboard

Voorbeelden

In het volgende codevoorbeeld worden methoden gebruikt Clipboard om gegevens op het klembord van het systeem te plaatsen en op te halen. Deze code gaat ervan uit datbutton1, button2textBox1en textBox2 is gemaakt en op het formulier is geplaatst.

Met de button1_Click methode wordt geselecteerde tekst uit het tekstvak aangeroepen SetDataObject en op het klembord van het systeem geplaatst.

Met de button2_Click methode wordt aangeroepen GetDataObject om gegevens op te halen van het klembord van het systeem. De code gebruikt IDataObject en DataFormats om de geretourneerde gegevens te extraheren en de gegevens weer te geven 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

Opmerkingen

Zie de DataFormats klasse voor een lijst met vooraf gedefinieerde indelingen die u met de Clipboard klasse wilt gebruiken.

Oproep SetDataObject om gegevens op het Klembord te plaatsen, waarbij de huidige inhoud wordt vervangen. Als u een permanente kopie van de gegevens op het Klembord wilt plaatsen, stelt u de copy parameter in trueop .

Aanroepen GetDataObject om gegevens op te halen van het Klembord. De gegevens worden geretourneerd als een object waarmee de IDataObject interface wordt geïmplementeerd. Gebruik de methoden die zijn opgegeven door IDataObject en velden om DataFormats de gegevens uit het object te extraheren. Als u de indeling van de gegevens die u hebt opgehaald niet weet, roept u de GetFormats methode van de IDataObject interface aan om een lijst op te halen met alle indelingen waarin de gegevens zijn opgeslagen. Roep vervolgens de GetData methode van de IDataObject interface aan en geef een indeling op die uw toepassing kan gebruiken.

De Clipboard klasse biedt extra methoden waarmee u gemakkelijker met het klembord van het systeem kunt werken. Roep de Clear methode aan om alle gegevens van het Klembord te verwijderen. Als u gegevens van een bepaalde indeling wilt toevoegen aan het Klembord, vervangt u de bestaande gegevens, roept u de juiste Setindelingsmethode aan, zoals SetText, of roept u de SetData methode aan om de indeling op te geven. Als u gegevens van een bepaalde indeling van het Klembord wilt ophalen, roept u eerst de juiste Containsindelingsmethode (zoals ContainsText) aan om te bepalen of het Klembord gegevens in die indeling bevat en roept u vervolgens de juiste Getindelingsmethode (zoals GetText) aan om de gegevens op te halen als het Klembord deze bevat. Als u de indeling in deze bewerkingen wilt opgeven, roept u in plaats daarvan de ContainsData en GetData methoden aan.

Zie ook

• DataObject
• DataFormats
• IDataObject
• Aanvullende beveiligingsoverwegingen in Windows Forms