Freigeben über


DataFormats Klasse

Definition

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
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:

Weitere Informationen