DataFormats Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataFormats.cs

Poskytuje staticpředdefinované Clipboard názvy formátů. Použijte je k identifikaci formátu dat, která ukládáte v objektu IDataObject.

public ref class DataFormats abstract sealed

public static class DataFormats

type DataFormats = class

Public Class DataFormats

Dědičnost

Object

DataFormats

Příklady

Následující příklad kódu vytvoří nový datový formát s názvem myFormat. Kód pak vytvoří MyNewObject , do kterého se DataObjectuloží . Zkopíruje se DataObject do Clipboardsouboru .

Dále se načte DataObject z objektu Clipboard a MyNewObject obnoví se. Hodnota MyNewObject se vytiskne v textovém poli. Tento kód vyžaduje textBox1 vytvoření a umístění do formuláře.

#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

Poznámky

IDataObject Třídy DataObject také používají static seznam formátů k určení typu dat, která jsou načtena ze systému Clipboardnebo které jsou přeneseny v operaci přetažení.

Metoda GetFormat umožňuje:

• Získejte předdefinovaný DataFormats.Format objekt pro název formátu nebo číslo ID.

• Přidejte do seznamu static v této třídě nový pár názvu/ID formátu a zaregistrujte formát do registru Windows jako formát Clipboard při předání názvu formátu.

Číslo nebo formát Id můžete získat Name z příslušné vlastnosti v DataFormats.Format instanci.

Pole

Name	Description
Bitmap	Určuje Windows rastrový formát. Toto static pole je jen pro čtení.
CommaSeparatedValue	Určuje formát hodnot oddělených čárkami (CSV), což je běžný formát výměny používaný tabulkami. Tento formát nepoužívá přímo model Windows Forms. Toto static pole je jen pro čtení.
Dib	Určuje formát Windows rastrového obrázku nezávislého na zařízení (DIB). Toto static pole je jen pro čtení.
Dif	Určuje formát DIF (Windows Data Interchange Format), který model Windows Forms přímo nepoužívá. Toto static pole je jen pro čtení.
EnhancedMetafile	Určuje formát Windows rozšířeného metasouboru. Toto static pole je jen pro čtení.
FileDrop	Určuje formát Windows přetažení souboru, který model Windows Forms přímo nepoužívá. Toto static pole je jen pro čtení.
Html	Určuje text ve formátu schránky HTML. Toto static pole je jen pro čtení.
Locale	Určuje formát jazykové verze Windows, který model Windows Forms přímo nepoužívá. Toto static pole je jen pro čtení.
MetafilePict	Určuje formát Windows metasouboru, který model Windows Forms přímo nepoužívá. Toto static pole je jen pro čtení.
OemText	Určuje standardní textový formát výrobce OEM (Windows originálního vybavení). Toto static pole je jen pro čtení.
Palette	Určuje formát palety Windows. Toto static pole je jen pro čtení.
PenData	Určuje Windows datový formát pera, který se skládá z tahů pera pro software pro psaní rukou; model Windows Forms tento formát nepoužívá. Toto static pole je jen pro čtení.
Riff	Určuje zvukový formát RIFF (Resource Interchange File Format), který model Windows Forms přímo nepoužívá. Toto static pole je jen pro čtení.
Rtf	Určuje text skládající se z dat ve formátu RTF (Rich Text Format). Toto static pole je jen pro čtení.
Serializable	Určuje formát, který zapouzdřuje libovolný typ model Windows Forms objektu. Toto static pole je jen pro čtení.
StringFormat	Určuje formát třídy řetězce model Windows Forms, který model Windows Forms používá k ukládání objektů řetězců. Toto static pole je jen pro čtení.
SymbolicLink	Určuje Windows symbolický formát odkazu, který model Windows Forms přímo nepoužívá. Toto static pole je jen pro čtení.
Text	Určuje standardní textový formát ANSI. Toto static pole je jen pro čtení.
Tiff	Určuje formát TIFF (Tagged Image File Format), který model Windows Forms přímo nepoužívá. Toto static pole je jen pro čtení.
UnicodeText	Určuje standardní textový formát Windows Unicode. Toto static pole je jen pro čtení.
WaveAudio	Určuje formát vlnového zvuku, který model Windows Forms přímo nepoužívá. Toto static pole je jen pro čtení.

Metody

Name	Description
GetFormat(Int32)	Vrátí DataFormats.Format s číselným ID schránky Windows a názvem zadaného ID.
GetFormat(String)	Vrátí DataFormats.Format s číselným ID schránky Windows a názvem zadaného formátu.

Viz také

• 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)