DataFormats Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Clipboard-Formatnamen bereit, die static und vordefiniert sind. Mit diesen können Sie das Format von Daten festlegen, die Sie in IDataObject speichern.

public ref class DataFormats

public ref class DataFormats abstract sealed

public class DataFormats

public static class DataFormats

type DataFormats = class

Public Class DataFormats

Vererbung: Object
DataFormats

Beispiele

Im folgenden Codebeispiel wird ein neues Datenformat mit dem Namen myFormaterstellt. Der Code erstellt dann eine MyNewObject , die er in einer DataObjectspeichert. Der DataObject wird in die Clipboardkopiert.

Als Nächstes wird das DataObject von Clipboard abgerufen und wird MyNewObject wiederhergestellt. Der Wert von MyNewObject wird in einem Textfeld gedruckt. Dieser Code erfordert, dass textBox1 erstellt und in einem Formular platziert wurde.

#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

Hinweise

Die IDataObject Klassen und DataObject verwenden auch die static Formatliste, um den Typ der Daten zu bestimmen, die aus dem System Clipboardabgerufen oder in einem Drag-and-Drop-Vorgang übertragen werden.

Mit GetFormat der -Methode können Sie Folgendes ausführen:

Rufen Sie ein vordefiniertes DataFormats.Format Objekt für einen Formatnamen oder eine ID-Nummer ab.
Fügen Sie der static Liste in dieser Klasse ein neues Formatnamen-ID-Nummernpaar hinzu, und um das Format bei der Windows-Registrierung als Clipboard Format zu registrieren, wenn Sie den Formatnamen übergeben.

Sie können die Zahl oder das Id Format Name von der entsprechenden Eigenschaft in der DataFormats.Format Instanz abrufen.

Felder

Bitmap	Gibt ein Windows-Bitmap-Format an. Dieses `static`-Feld ist schreibgeschützt.
CommaSeparatedValue	Gibt ein CSV-Format (Comma-Separated Value) an, ein verbreitetes Austauschformat, das von Tabellenkalkulationsprogrammen verwendet wird. Dieses Format wird nicht direkt von Windows Forms verwendet. Dieses `static`-Feld ist schreibgeschützt.
Dib	Gibt das DIB-Format (Device Independent Bitmap) von Windows an. Dieses `static`-Feld ist schreibgeschützt.
Dif	Gibt das Windows-Datenaustauschformat DIF an (Data Interchange Format) an, das Windows Forms nicht direkt verwendet. Dieses `static`-Feld ist schreibgeschützt.
EnhancedMetafile	Gibt das Windows-Format Erweiterte Metadatei an. Dieses `static`-Feld ist schreibgeschützt.
FileDrop	Gibt das Dateiablageformat von Windows an, das Windows Forms nicht direkt verwendet. Dieses `static`-Feld ist schreibgeschützt.
Html	Gibt Text im HTML-Zwischenablageformat an. Dieses `static`-Feld ist schreibgeschützt.
Locale	Gibt das Windows-Kulturformat an, das Windows Forms nicht direkt verwendet. Dieses `static`-Feld ist schreibgeschützt.
MetafilePict	Gibt das Metadateiformat von Windows an, das Windows Forms nicht direkt verwendet. Dieses `static`-Feld ist schreibgeschützt.
OemText	Gibt das OEM-Standardtextformat (Original Equipment Manufacturer) von Windows an. Dieses `static`-Feld ist schreibgeschützt.
Palette	Gibt das Palettenformat von Windows an. Dieses `static`-Feld ist schreibgeschützt.
PenData	Gibt das Pen-Datenformat von Windows an, das Stiftstriche für Handschrift-Software enthält. Windows Forms verwendet dieses Format nicht. Dieses `static`-Feld ist schreibgeschützt.
Riff	Gibt das RIFF-Audioformat (Resource Interchange File Format) an, das von Windows Forms nicht direkt verwendet wird. Dieses `static`-Feld ist schreibgeschützt.
Rtf	Gibt Text an, der aus RTF-Daten (Rich Text Format) besteht. Dieses `static`-Feld ist schreibgeschützt.
Serializable	Gibt ein Format an, das beliebige Windows Forms-Objekte kapselt. Dieses `static`-Feld ist schreibgeschützt.
StringFormat	Gibt das Format der Zeichenfolgenklassen in Windows Forms an, in dem Zeichenfolgenobjekte von Windows Forms gespeichert werden. Dieses `static`-Feld ist schreibgeschützt.
SymbolicLink	Gibt das Format für symbolische Links in Windows an, das Windows Forms nicht direkt verwendet. Dieses `static`-Feld ist schreibgeschützt.
Text	Gibt das standardmäßige ANSI-Textformat an. Dieses `static`-Feld ist schreibgeschützt.
Tiff	Gibt das TIFF-Format (Tagged Image File Format) an, das von Windows Forms nicht direkt verwendet wird. Dieses `static`-Feld ist schreibgeschützt.
UnicodeText	Gibt das standardmäßige Unicode-Textformat von Windows an. Dieses `static`-Feld ist schreibgeschützt.
WaveAudio	Gibt das Wave-Audio-Format an, das Windows Forms nicht direkt verwendet. Dieses `static`-Feld ist schreibgeschützt.

Methoden

GetFormat(Int32)	Gibt ein DataFormats.Format der Windows-Zwischenablage mit der numerischen ID und dem entsprechenden Namen zurück.
GetFormat(String)	Gibt ein DataFormats.Format der Windows-Zwischenablage mit der numerischen ID und dem Namen für das angegebene Format zurück.

Gilt für: