Nyelv

DataFormats Osztály

Definíció

Névtér:
System.Windows.Forms
Szerelvény:
System.Windows.Forms.dll
Forrás:
DataFormats.cs
Forrás:
DataFormats.cs
Forrás:
DataFormats.cs
Forrás:
DataFormats.cs
Forrás:
DataFormats.cs

Előre definiált static formátumneveket biztosítClipboard. Ezek segítségével azonosíthatja a tárolóban tárolt adatok formátumát IDataObject.

public ref class DataFormats
public ref class DataFormats abstract sealed
public class DataFormats
public static class DataFormats
type DataFormats = class
Public Class DataFormats
Öröklődés
Object
DataFormats

Példák

Az alábbi példakód egy új adatformátumot hoz létre.myFormat A kód ezután létrehoz egy MyNewObject olyan kódot, amelyet egy DataObject. A DataObject program a program a programba másolja a program.Clipboard

Ezután a DataObject rendszer lekéri a lekérést a Clipboard rendszerből, és a MyNewObject rendszer helyreállítja. Az érték MyNewObject egy szövegdobozban lesz kinyomtatva. Ehhez a kódhoz létre kell hozni és el kell textBox1 helyezni egy űrlapot.

#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

Megjegyzések

Az IDataObject osztályok a DataObject formátumlistát is használják a static rendszerből Clipboardlekért vagy húzással átvitt adatok típusának meghatározására.

A GetFormat módszer lehetővé teszi, hogy:

  • Előre definiált DataFormats.Format objektum lekérése formátumnévhez vagy azonosítószámhoz.

  • Adjon hozzá egy új formátumnév-/azonosítószámpárt az osztály static listájához, és ha a formátumot a formátumnév átadásakor Clipboard formátumban szeretné regisztrálni a Windows beállításjegyzékben.

A példány megfelelő tulajdonságából lekérheti a Id számot vagy a formátumot NameDataFormats.Format .

Mezők

Név Description
Bitmap

Windows bitképformátumot ad meg. Ez static a mező írásvédett.
CommaSeparatedValue

Vesszővel tagolt érték (CSV) formátumot ad meg, amely a számolótáblák által használt gyakori csereformátum. Ezt a formátumot a Windows Forms nem használja közvetlenül. Ez static a mező írásvédett.
Dib

A Windows eszközfüggetlen bitkép (DIB) formátumát adja meg. Ez static a mező írásvédett.
Dif

Megadja a Windows adatcserés formátumot (DIF), amelyet Windows Forms nem használ közvetlenül. Ez static a mező írásvédett.
EnhancedMetafile

A Windows továbbfejlesztett metafájlformátumot adja meg. Ez static a mező írásvédett.
FileDrop

Megadja a Windows fájlcsepp formátumát, amelyet Windows Forms közvetlenül nem használ. Ez static a mező írásvédett.
Html

HTML-vágólap formátumú szöveget ad meg. Ez static a mező írásvédett.
Locale

Megadja a Windows kulturális formátumot, amelyet Windows Forms nem használ közvetlenül. Ez static a mező írásvédett.
MetafilePict

Megadja a Windows metafájl formátumát, amelyet Windows Forms nem használ közvetlenül. Ez static a mező írásvédett.
OemText

Megadja a szabványos Windows eredeti berendezésgyártó (OEM) szövegformátumát. Ez static a mező írásvédett.
Palette

A Windows palettaformátumot adja meg. Ez static a mező írásvédett.
PenData

Megadja a tolladatok Windows formátumát, amely tollvonásokból áll a kézírási szoftverekhez; Windows Forms nem használja ezt a formátumot. Ez static a mező írásvédett.
Riff

Megadja a Resource Interchange File Format (RIFF) hangformátumot, amelyet Windows Forms nem használ közvetlenül. Ez static a mező írásvédett.
Rtf

Rich Text Format (RTF) adatokból álló szöveget ad meg. Ez static a mező írásvédett.
Serializable

Olyan formátumot ad meg, amely bármilyen típusú Windows Forms objektumot beágyaz. Ez static a mező írásvédett.
StringFormat

Megadja az Windows Forms sztringosztály formátumát, amelyet Windows Forms sztringobjektumok tárolására használ. Ez static a mező írásvédett.
SymbolicLink

A Windows szimbolikus hivatkozásformátumot adja meg, amelyet Windows Forms közvetlenül nem használ. Ez static a mező írásvédett.
Text

A szabványos ANSI-szövegformátumot adja meg. Ez static a mező írásvédett.
Tiff

Megadja a címkézett képfájl formátumát (TIFF), amelyet Windows Forms közvetlenül nem használ. Ez static a mező írásvédett.
UnicodeText

Megadja a szabványos Windows Unicode-szövegformátumot. Ez static a mező írásvédett.
WaveAudio

Megadja a hanghullám formátumát, amelyet Windows Forms nem használ közvetlenül. Ez static a mező írásvédett.

Metódusok

Név Description
GetFormat(Int32)

Egy DataFormats.Format ad vissza a Windows vágólap numerikus azonosítójával és a megadott azonosító nevével.
GetFormat(String)

Egy DataFormats.Format ad vissza a megadott formátumhoz tartozó Windows vágólap numerikus azonosítójával és nevével.

A következőre érvényes:

Lásd még