Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

DataFormats, classe

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.

System.Object
  System.Windows.Forms.DataFormats

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

public class DataFormats

Le type DataFormats expose les membres suivants.

  NomDescription
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueMembre statiqueGetFormat(Int32)Retourne DataFormats.Format avec le nom et le numéro d'ID du Presse-papiers Windows correspondant à l'ID spécifié.
Méthode publiqueMembre statiqueGetFormat(String)Retourne DataFormats.Format avec le nom et le numéro d'ID du Presse-papiers Windows correspondant au format spécifié.
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Début

  NomDescription
Champ publicMembre statiqueBitmapSpécifie un format de bitmap Windows. Ce champ static est en lecture seule.
Champ publicMembre statiqueCommaSeparatedValueSpé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.
Champ publicMembre statiqueDibSpécifie le format de bitmap indépendante du périphérique (DIB, Device Independent Bitmap) Windows. Ce champ static est en lecture seule.
Champ publicMembre statiqueDifSpé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.
Champ publicMembre statiqueEnhancedMetafileSpécifie le format de métafichier amélioré (EMF, Enhanced Metafile Format) Windows. Ce champ static est en lecture seule.
Champ publicMembre statiqueFileDropSpécifie le format de déplacement de fichier Windows que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.
Champ publicMembre statiqueHtmlSpécifie le texte dans le format de presse-papiers HTML. Ce champ static est en lecture seule.
Champ publicMembre statiqueLocaleSpécifie le format de culture Windows que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.
Champ publicMembre statiqueMetafilePictSpécifie le format de métafichier Windows que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.
Champ publicMembre statiqueOemTextSpécifie le format de texte de fabricant d'équipements (OEM, Original Equipment Manufacturer) Windows standard. Ce champ static est en lecture seule.
Champ publicMembre statiquePaletteSpécifie le format de palette Windows. Ce champ static est en lecture seule.
Champ publicMembre statiquePenDataSpé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.
Champ publicMembre statiqueRiffSpé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.
Champ publicMembre statiqueRtfSpécifie un texte constitué de données au format de texte enrichi (RTF, Rich Text Format). Ce champ static est en lecture seule.
Champ publicMembre statiqueSerializableSpécifie un format encapsulant tout type d'objet Windows Forms. Ce champ static est en lecture seule.
Champ publicMembre statiqueStringFormatSpé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.
Champ publicMembre statiqueSymbolicLinkSpécifie le format de lien symbolique Windows que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.
Champ publicMembre statiqueTextSpécifie le format de texte ANSI standard. Ce champ static est en lecture seule.
Champ publicMembre statiqueTiffSpé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.
Champ publicMembre statiqueUnicodeTextSpécifie le format de texte Unicode standard Windows. Ce champ static est en lecture seule.
Champ publicMembre statiqueWaveAudioSpécifie le format audio Wave que les Windows Forms n'utilisent pas directement. Ce champ static est en lecture seule.
Début

Les classes IDataObject et DataObject font également appel à la liste de formats static pour déterminer le type de données récupérées du Clipboard système ou transférées au cours d'une opération de glisser-déplacer.

La méthode GetFormat vous permet d'effectuer les opérations suivantes :

  • obtenir un objet DataFormats.Format prédéfini se rapportant à un numéro d'identification ou à un nom de format ;

  • ajouter une nouvelle paire nom de format/numéro d'identification à la liste static figurant dans cette classe et inscrire le format dans le Registre Windows en tant que format Clipboard lorsque vous lui passez le nom de format.

Vous pouvez obtenir le numéro Id ou le Name de format dans la propriété correspondante de l'instance de DataFormats.Format.

L'exemple de code suivant illustre la création d'un nouveau format de données nommé myFormat. Le code crée ensuite MyNewObject qui est stocké dans DataObject. DataObject est copiée dans Clipboard.

DataObject est ensuite extrait de Clipboard et MyNewObject est récupéré. La valeur de MyNewObject s'inscrit dans une zone de texte. Ce code requiert que textBox1 ait été créé et placé dans un formulaire.


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;
       }
    }
 }

 


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft