DataFormats Classe

Définition

Fournit des noms de formats static prédéfinis Clipboard.Provides static, predefined Clipboard format names. Utilisez ces noms pour identifier le format des données que vous stockez dans IDataObject.Use them to identify the format of data that you store in an IDataObject.

public ref class DataFormats abstract sealed
public ref class DataFormats
public static class DataFormats
public class DataFormats
type DataFormats = class
Public Class DataFormats
Héritage
DataFormats

Exemples

L’exemple de code suivant crée un nouveau format de données nommé myFormat.The following code example creates a new data format named myFormat. Le code crée ensuite un MyNewObject qu’il stocke dans un DataObject.The code then creates a MyNewObject which it stores in a DataObject. Le DataObject est copié dans le Clipboard.The DataObject is copied to the Clipboard.

Ensuite, le DataObject est récupéré à partir du Clipboard et le MyNewObject est récupéré.Next, the DataObject is retrieved from the Clipboard and the MyNewObject is recovered. La valeur de la MyNewObject est imprimée dans une zone de texte.The value of the MyNewObject is printed in a text box. Ce code requiert que textBox1 soit créé et placé sur un formulaire.This code requires that textBox1 has been created and placed on a form.

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;

// Creates a new type.

[Serializable]
public ref class MyNewObject: public Object
{
private:
   String^ myValue;

public:

   // Creates a default constructor for the class.
   MyNewObject()
   {
      myValue = "This is the value of the class";
   }


   property String^ MyObjectValue 
   {

      // Creates a property to retrieve or set the value.
      String^ get()
      {
         return myValue;
      }

      void set( String^ value )
      {
         myValue = value;
      }

   }

};

public ref class MyClass: public Form
{
protected:
   TextBox^ textBox1;

public:
   void MyClipboardMethod()
   {
      
      // Creates a new data format.
      DataFormats::Format^ myFormat = DataFormats::GetFormat( "myFormat" );
      
      /* Creates a new object and stores it in a DataObject using myFormat 
               * as the type of format. */
      MyNewObject^ myObject = gcnew MyNewObject;
      DataObject^ myDataObject = gcnew DataObject( myFormat->Name,myObject );
      
      // Copies myObject into the clipboard.
      Clipboard::SetDataObject( myDataObject );
      
      // Performs some processing steps.
      // Retrieves the data from the clipboard.
      IDataObject^ myRetrievedObject = Clipboard::GetDataObject();
      
      // Converts the IDataObject type to MyNewObject type. 
      MyNewObject^ myDereferencedObject = dynamic_cast<MyNewObject^>(myRetrievedObject->GetData( myFormat->Name ));
      
      // Prints the value of the Object in a textBox.
      textBox1->Text = myDereferencedObject->MyObjectValue;
   }

};

using System;
using System.Windows.Forms;

public class MyClass : Form {
    protected TextBox textBox1;
    
    public void MyClipboardMethod() {
       // Creates a new data format.
       DataFormats.Format myFormat = DataFormats.GetFormat("myFormat");
       
       /* Creates a new object and stores it in a DataObject using myFormat 
        * as the type of format. */
       MyNewObject myObject = new MyNewObject();
       DataObject myDataObject = new DataObject(myFormat.Name, myObject);
 
       // Copies myObject into the clipboard.
       Clipboard.SetDataObject(myDataObject);
 
       // Performs some processing steps.
 
       // Retrieves the data from the clipboard.
       IDataObject myRetrievedObject = Clipboard.GetDataObject();
 
       // Converts the IDataObject type to MyNewObject type. 
       MyNewObject myDereferencedObject = (MyNewObject)myRetrievedObject.GetData(myFormat.Name);
 
       // Prints the value of the Object in a textBox.
       textBox1.Text = myDereferencedObject.MyObjectValue;
    }
 }
 
 // Creates a new type.
 [Serializable]
 public class MyNewObject : Object {
    private string myValue;
 
    // Creates a default constructor for the class.
    public MyNewObject() {
       myValue = "This is the value of the class";
    }
 
    // Creates a property to retrieve or set the value.
    public string MyObjectValue {
       get {
          return myValue;
       }
       set {
          myValue = value;
       }
    }
 }

 
Option Explicit
Option Strict

Imports System.Windows.Forms

Public Class MyClass1
    Inherits Form
    Private textBox1 As TextBox

    Public Sub MyClipboardMethod()
        ' Creates a new data format.
        Dim myFormat As DataFormats.Format = _
            DataFormats.GetFormat("myFormat")
        
        ' Creates a new object and store it in a DataObject using myFormat 
        ' as the type of format. 
        Dim myObject As New MyNewObject()
        Dim myDataObject As New DataObject(myFormat.Name, myObject)
        
        ' Copies myObject into the clipboard.
        Clipboard.SetDataObject(myDataObject)
        
        ' Performs some processing steps.
        ' Retrieves the data from the clipboard.
        Dim myRetrievedObject As IDataObject = Clipboard.GetDataObject()
        
        ' Converts the IDataObject type to MyNewObject type. 
        Dim myDereferencedObject As MyNewObject = _
            CType(myRetrievedObject.GetData(myFormat.Name), MyNewObject)
        
        ' Print the value of the Object in a textBox.
        textBox1.Text = myDereferencedObject.MyObjectValue
    End Sub
End Class


' Creates a new type.
<Serializable()> Public Class MyNewObject
    Inherits Object
    Private myValue As String
    
    
    ' Creates a default constructor for the class.
    Public Sub New()
        myValue = "This is the value of the class"
    End Sub
    
    ' Creates a property to retrieve or set the value.
    
    Public Property MyObjectValue() As String
        Get
            Return myValue
        End Get
        Set
            myValue = value
        End Set
    End Property
End Class

Remarques

Les classes IDataObject et DataObject utilisent également la liste static format pour déterminer le type de données extraites du Clipboardsystème ou qui est transférée lors d’une opération de glisser-déplacer.The IDataObject and DataObject classes also use the static format list to determine the type of data that is retrieved from the system Clipboard, or that is transferred in a drag-and-drop operation.

La méthode GetFormat vous permet d’effectuer les opérations suivantes :The GetFormat method allows you to:

  • Obtenir un objet DataFormats.Format prédéfini pour un nom de format ou un numéro d’ID.Get a predefined DataFormats.Format object for a format name or ID number.

  • Ajoutez une nouvelle paire nom/numéro d’ID de format à la liste static dans cette classe, et pour inscrire le format dans le Registre Windows au format Clipboard lorsque vous lui transmettez le nom de format.Add a new format name/ID number pair to the static list in this class, and to register the format with the Windows registry as a Clipboard format when you pass it the format name.

Vous pouvez récupérer le Id nombre ou le format Name à partir de la propriété appropriée dans l’instance DataFormats.Format.You can get the Id number or format Name from the appropriate property in the DataFormats.Format instance.

Champs

Bitmap

Spécifie un format de bitmap Windows.Specifies a Windows bitmap format. Ce champ static est en lecture seule.This static field is read-only.

CommaSeparatedValue

Spécifie le format de valeur séparée par une virgule (CSV, Comma-Separated Value), qui correspond au format d'échange fréquemment utilisé par les feuilles de calcul.Specifies a comma-separated value (CSV) format, which is a common interchange format used by spreadsheets. Ce format n'est pas directement utilisé par les Windows Forms.This format is not used directly by Windows Forms. Ce champ static est en lecture seule.This static field is read-only.

Dib

Spécifie le format de bitmap indépendante du périphérique (DIB, Device Independent Bitmap) Windows.Specifies the Windows device-independent bitmap (DIB) format. Ce champ static est en lecture seule.This static field is read-only.

Dif

Spécifie le format d'échange de données (DIF, Data Interchange Format) Windows que les Windows Forms n'utilisent pas directement.Specifies the Windows Data Interchange Format (DIF), which Windows Forms does not directly use. Ce champ static est en lecture seule.This static field is read-only.

EnhancedMetafile

Spécifie le format de métafichier amélioré (EMF, Enhanced Metafile Format) Windows.Specifies the Windows enhanced metafile format. Ce champ static est en lecture seule.This static field is read-only.

FileDrop

Spécifie le format de déplacement de fichier Windows que les Windows Forms n'utilisent pas directement.Specifies the Windows file drop format, which Windows Forms does not directly use. Ce champ static est en lecture seule.This static field is read-only.

Html

Spécifie le texte dans le format de presse-papiers HTML.Specifies text in the HTML Clipboard format. Ce champ static est en lecture seule.This static field is read-only.

Locale

Spécifie le format de culture Windows que les Windows Forms n'utilisent pas directement.Specifies the Windows culture format, which Windows Forms does not directly use. Ce champ static est en lecture seule.This static field is read-only.

MetafilePict

Spécifie le format de métafichier Windows que les Windows Forms n'utilisent pas directement.Specifies the Windows metafile format, which Windows Forms does not directly use. Ce champ static est en lecture seule.This static field is read-only.

OemText

Spécifie le format de texte de fabricant d'équipements (OEM, Original Equipment Manufacturer) Windows standard.Specifies the standard Windows original equipment manufacturer (OEM) text format. Ce champ static est en lecture seule.This static field is read-only.

Palette

Spécifie le format de palette Windows.Specifies the Windows palette format. Ce champ static est en lecture seule.This static field is read-only.

PenData

Spécifie le format de données de stylet Windows, constitué de traits de stylet dans le cas de logiciels prenant en charge l'écriture manuscrite ; les Windows Forms n'utilisent pas ce format.Specifies the Windows pen data format, which consists of pen strokes for handwriting software; Windows Forms does not use this format. Ce champ static est en lecture seule.This static field is read-only.

Riff

Spécifie le format de fichier d'échange de ressources (RIFF, Resource Interchange File Format) que les Windows Forms n'utilisent pas directement.Specifies the Resource Interchange File Format (RIFF) audio format, which Windows Forms does not directly use. Ce champ static est en lecture seule.This static field is read-only.

Rtf

Spécifie un texte constitué de données au format de texte enrichi (RTF, Rich Text Format).Specifies text consisting of Rich Text Format (RTF) data. Ce champ static est en lecture seule.This static field is read-only.

Serializable

Spécifie un format encapsulant tout type d'objet Windows Forms.Specifies a format that encapsulates any type of Windows Forms object. Ce champ static est en lecture seule.This static field is read-only.

StringFormat

Spécifie le format de la classe de la chaîne des Windows Forms utilisé par les Windows Forms pour stocker des objets chaîne.Specifies the Windows Forms string class format, which Windows Forms uses to store string objects. Ce champ static est en lecture seule.This static field is read-only.

SymbolicLink

Spécifie le format de lien symbolique Windows que les Windows Forms n'utilisent pas directement.Specifies the Windows symbolic link format, which Windows Forms does not directly use. Ce champ static est en lecture seule.This static field is read-only.

Text

Spécifie le format de texte ANSI standard.Specifies the standard ANSI text format. Ce champ static est en lecture seule.This static field is read-only.

Tiff

Spécifie le format de fichier image avec indicateurs (TIFF, Tagged Image File Format) que les Windows Forms n'utilisent pas directement.Specifies the Tagged Image File Format (TIFF), which Windows Forms does not directly use. Ce champ static est en lecture seule.This static field is read-only.

UnicodeText

Spécifie le format de texte Unicode standard Windows.Specifies the standard Windows Unicode text format. Ce champ static est en lecture seule.This static field is read-only.

WaveAudio

Spécifie le format audio Wave que les Windows Forms n'utilisent pas directement.Specifies the wave audio format, which Windows Forms does not directly use. Ce champ static est en lecture seule.This static field is read-only.

Méthodes

GetFormat(Int32)

Retourne DataFormats.Format avec le nom et le numéro d'ID du Presse-papiers Windows correspondant à l'ID spécifié.Returns a DataFormats.Format with the Windows Clipboard numeric ID and name for the specified ID.

GetFormat(String)

Retourne DataFormats.Format avec le nom et le numéro d'ID du Presse-papiers Windows correspondant au format spécifié.Returns a DataFormats.Format with the Windows Clipboard numeric ID and name for the specified format.

S’applique à

Voir aussi