Udostępnij za pośrednictwem


DataFormats Klasa

Definicja

Udostępnia staticwstępnie zdefiniowane Clipboard nazwy formatów. Użyj ich, aby zidentyfikować format danych przechowywanych w obiekcie IDataObject.

public ref class DataFormats
public ref class DataFormats abstract sealed
public class DataFormats
public static class DataFormats
type DataFormats = class
Public Class DataFormats
Dziedziczenie
DataFormats

Przykłady

Poniższy przykład kodu tworzy nowy format danych o nazwie myFormat. Następnie kod tworzy, MyNewObject który przechowuje w obiekcie DataObject. Element DataObject jest kopiowany do pliku Clipboard.

Następnie element DataObject zostanie pobrany z obiektu Clipboard , a element MyNewObject zostanie odzyskany. Wartość elementu MyNewObject jest drukowana w polu tekstowym. Ten kod wymaga textBox1 utworzenia i umieszczenia go w formularzu.

#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

Uwagi

Klasy IDataObject i DataObject używają static również listy formatów, aby określić typ danych pobranych z systemu Clipboardlub przesyłanych w operacji przeciągania i upuszczania.

Metoda GetFormat umożliwia:

  • Pobierz wstępnie zdefiniowany DataFormats.Format obiekt dla nazwy formatu lub numeru identyfikatora.

  • Dodaj nową parę nazwa/numer identyfikacyjny formatu do static listy w tej klasie i zarejestrować format w rejestrze Windows jako Clipboard format podczas przekazywania nazwy formatu.

Możesz pobrać Id liczbę lub format Name z odpowiedniej właściwości w wystąpieniu DataFormats.Format .

Pola

Bitmap

Określa format mapy bitowej Windows. To static pole jest tylko do odczytu.

CommaSeparatedValue

Określa format wartości rozdzielanych przecinkami (CSV), który jest typowym formatem wymiany używanym przez arkusze kalkulacyjne. Ten format nie jest używany bezpośrednio przez Windows Forms. To static pole jest tylko do odczytu.

Dib

Określa format mapy bitowej niezależnej od urządzenia (DIB) Windows. To static pole jest tylko do odczytu.

Dif

Określa format Windows Data Interchange (DIF), który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.

EnhancedMetafile

Określa Windows rozszerzony format metapliku. To static pole jest tylko do odczytu.

FileDrop

Określa format upuszczania pliku Windows, który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.

Html

Określa tekst w formacie Schowka HTML. To static pole jest tylko do odczytu.

Locale

Określa format kultury Windows, który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.

MetafilePict

Określa format metapliku Windows, który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.

OemText

Określa standardowy format tekstowy Windows producenta sprzętu oryginalnego (OEM). To static pole jest tylko do odczytu.

Palette

Określa format palety Windows. To static pole jest tylko do odczytu.

PenData

Określa format danych pióra Windows, który składa się z pociągnięć pióra do oprogramowania pisma ręcznego; Windows Forms nie używa tego formatu. To static pole jest tylko do odczytu.

Riff

Określa format audio formatu pliku wymiany zasobów (RIFF), który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.

Rtf

Określa tekst składający się z danych RTF (Rich Text Format). To static pole jest tylko do odczytu.

Serializable

Określa format hermetyzujący dowolny typ obiektu Windows Forms. To static pole jest tylko do odczytu.

StringFormat

Określa format klasy ciągów Windows Forms, który Windows Forms używa do przechowywania obiektów ciągów. To static pole jest tylko do odczytu.

SymbolicLink

Określa format linku symbolicznego Windows, który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.

Text

Określa standardowy format tekstu ANSI. To static pole jest tylko do odczytu.

Tiff

Określa format otagowanych plików obrazów (TIFF), który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.

UnicodeText

Określa standardowy format tekstu Windows Unicode. To static pole jest tylko do odczytu.

WaveAudio

Określa format dźwięku falowego, który Windows Forms nie jest używany bezpośrednio. To static pole jest tylko do odczytu.

Metody

GetFormat(Int32)

Zwraca element DataFormats.Format z identyfikatorem liczbowym Windows Schowka i nazwą dla określonego identyfikatora.

GetFormat(String)

Zwraca obiekt DataFormats.Format z identyfikatorem liczbowym Windows Schowka i nazwą dla określonego formatu.

Dotyczy

Zobacz też