Clipboard Classe

Définition

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

Héritage

Object

Clipboard

Exemples

L’exemple de code suivant utilise des Clipboard méthodes pour placer des données et les récupérer à partir du Presse-papiers système. Ce code suppose que , button2, textBox1et textBox2 ont été créés button1et placés sur le formulaire.

La button1_Click méthode appelle SetDataObject pour prendre le texte sélectionné de la zone de texte et le placer dans le Presse-papiers système.

La button2_Click méthode appelle GetDataObject pour récupérer des données du Presse-papiers système. Le code utilise IDataObject et DataFormats pour extraire les données retournées et affiche les données dans 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

Remarques

Pour obtenir la liste des formats prédéfinis à utiliser avec la Clipboard classe, consultez la DataFormats classe .

Appelez SetDataObject pour placer des données dans le Presse-papiers, en remplaçant son contenu actuel. Pour placer une copie persistante des données dans le Presse-papiers, définissez le paramètre sur copytrue.

Appelez GetDataObject pour récupérer des données à partir du Presse-papiers. Les données sont retournées en tant qu’objet qui implémente l’interface IDataObject . Utilisez les méthodes spécifiées par IDataObject et les champs dans DataFormats pour extraire les données de l’objet. Si vous ne connaissez pas le format des données que vous avez récupérées, appelez la GetFormats méthode de l’interface IDataObject pour obtenir la liste de tous les formats dans lesquels les données sont stockées. Appelez ensuite la GetData méthode de l’interface IDataObject et spécifiez un format que votre application peut utiliser.

Dans .NET Framework 2.0, la Clipboard classe fournit des méthodes supplémentaires qui facilitent l’utilisation du Presse-papiers système. Appelez la Clear méthode pour supprimer toutes les données du Presse-papiers. Pour ajouter des données d’un format particulier au Presse-papiers, en remplaçant les données existantes, appelez la méthode Format appropriéeSet, telle que SetText, ou appelez la SetData méthode pour spécifier le format. Pour récupérer des données d’un format particulier à partir du Presse-papiers, appelez d’abord la méthode Format appropriée Contains (telle que ContainsText) pour déterminer si le Presse-papiers contient des données dans ce format, puis appelez la méthode Format appropriée Get (telle que GetText) pour récupérer les données si le Presse-papiers les contient. Pour spécifier le format dans ces opérations, appelez les méthodes et GetData à la ContainsData place.

Méthodes

S’applique à

Voir aussi

• DataObject
• DataFormats
• IDataObject
• Considérations supplémentaires sur la sécurité des Windows Forms