DataFormats Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fournit des noms de formats Clipboard prédéfinis static. Utilisez ces noms pour identifier le format des données que vous stockez dans IDataObject.

public ref class DataFormats abstract sealed

public static class DataFormats

type DataFormats = class

Public Class DataFormats

Héritage

Object

DataFormats

Exemples

L’exemple de code suivant crée un nouveau format de données nommé myFormat. Le code crée ensuite un MyNewObject qu’il stocke dans un DataObject. est DataObject copié dans .Clipboard

Ensuite, le DataObject est récupéré à partir du Clipboard et le MyNewObject est récupéré. La valeur de est MyNewObject imprimée dans une zone de texte. Ce code nécessite que ait textBox1 été créé et placé sur un formulaire.

#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 IDataObject classes et DataObject utilisent également la static liste de formats pour déterminer le type de données récupérées à partir du système Clipboardou transférées dans une opération de glisser-déplacer.

La GetFormat méthode vous permet de :

• Obtenez un objet prédéfini DataFormats.Format pour un nom de format ou un numéro d’ID.

• Ajoutez une nouvelle paire nom/numéro d’ID de format à la static liste de cette classe, puis pour inscrire le format auprès du Registre Windows en tant que Clipboard format lorsque vous lui transmettez le nom de format.

Vous pouvez obtenir le nombre ou le Id format Name à partir de la propriété appropriée dans l’instance DataFormats.Format .

Champs

Bitmap	Spécifie un format de bitmap Windows. Ce champ static est en lecture seule.
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. Ce format n'est pas directement utilisé par les Windows Forms. Ce champ static est en lecture seule.
Dib	Spécifie le format de bitmap indépendante du périphérique (DIB, Device Independent Bitmap) Windows. Ce champ static est en lecture seule.
Dif	Spécifie le format d'échange de données (DIF, Data Interchange Format) Windows que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.
EnhancedMetafile	Spécifie le format de métafichier amélioré (EMF, Enhanced Metafile Format) Windows. Ce champ static est en lecture seule.
FileDrop	Spécifie le format de déplacement de fichier Windows que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.
Html	Spécifie le texte dans le format de presse-papiers HTML. Ce champ static est en lecture seule.
Locale	Spécifie le format de culture Windows que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.
MetafilePict	Spécifie le format de métafichier Windows que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.
OemText	Spécifie le format de texte de fabricant d'équipements (OEM, Original Equipment Manufacturer) Windows standard. Ce champ static est en lecture seule.
Palette	Spécifie le format de palette Windows. Ce champ static est en lecture seule.
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. Ce champ static est en lecture seule.
Riff	Spécifie le format de fichier d'échange de ressources (RIFF, Resource Interchange File Format) que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.
Rtf	Spécifie un texte constitué de données au format de texte enrichi (RTF, Rich Text Format). Ce champ static est en lecture seule.
Serializable	Spécifie un format encapsulant tout type d'objet Windows Forms. Ce champ static est en lecture seule.
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. Ce champ static est en lecture seule.
SymbolicLink	Spécifie le format de lien symbolique Windows que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.
Text	Spécifie le format de texte ANSI standard. Ce champ static est en lecture seule.
Tiff	Spécifie le format de fichier image avec indicateurs (TIFF, Tagged Image File Format) que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.
UnicodeText	Spécifie le format de texte Unicode standard Windows. Ce champ static est en lecture seule.
WaveAudio	Spécifie le format audio Wave que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.

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é.
GetFormat(String)	Retourne DataFormats.Format avec le nom et le numéro d'ID du Presse-papiers Windows correspondant au format spécifié.

Voir aussi

• Clipboard
• DataObject
• DataFormats.Format
• IDataObject
• SetData(String, Boolean, Object)
• GetData(String, Boolean)
• GetFormats(Boolean)
• GetDataPresent(Type)
• GetData(String, Boolean)
• GetDataPresent(String, Boolean)
• GetFormats(Boolean)
• SetData(String, Boolean, Object)