DataFormats Kelas

Definisi

Menyediakan static, nama format yang telah Clipboard ditentukan sebelumnya. Gunakan untuk mengidentifikasi format data yang Anda simpan di IDataObject.

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

Contoh

Contoh kode berikut membuat format data baru bernama myFormat. Kode kemudian membuat MyNewObject yang disimpannya dalam DataObject. disalin DataObject ke Clipboard.

Selanjutnya, DataObject diambil dari Clipboard dan dipulihkan MyNewObject . Nilai dicetak MyNewObject dalam kotak teks. Kode ini mengharuskan yang textBox1 telah dibuat dan ditempatkan pada formulir.

#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

Keterangan

Kelas IDataObject dan DataObject juga menggunakan static daftar format untuk menentukan jenis data yang diambil dari sistem Clipboard, atau yang ditransfer dalam operasi seret dan letakkan.

Metode ini GetFormat memungkinkan Anda untuk:

  • Dapatkan objek yang telah DataFormats.Format ditentukan sebelumnya untuk nama format atau nomor ID.

  • Tambahkan pasangan nomor nama/ID format baru ke daftar static di kelas ini, dan untuk mendaftarkan format dengan registri Windows sebagai format Clipboard saat Anda meneruskannya nama format.

Anda bisa mendapatkan Id angka atau format Name dari properti yang sesuai dalam DataFormats.Format instans.

Bidang

Nama Deskripsi
Bitmap

Menentukan format bitmap Windows. Bidang ini static bersifat baca-saja.

CommaSeparatedValue

Menentukan format nilai yang dipisahkan koma (CSV), yang merupakan format pertukaran umum yang digunakan oleh spreadsheet. Format ini tidak digunakan langsung oleh Formulir Windows. Bidang ini static bersifat baca-saja.

Dib

Menentukan format bitmap independen perangkat (DIB) Windows. Bidang ini static bersifat baca-saja.

Dif

Menentukan Format Pertukaran Data (DIF) Windows, yang tidak digunakan secara langsung oleh Formulir Windows. Bidang ini static bersifat baca-saja.

EnhancedMetafile

Menentukan format metafile Windows ditingkatkan. Bidang ini static bersifat baca-saja.

FileDrop

Menentukan format penurunan file Windows, yang Formulir Windows tidak digunakan secara langsung. Bidang ini static bersifat baca-saja.

Html

Menentukan teks dalam format Papan Klip HTML. Bidang ini static bersifat baca-saja.

Locale

Menentukan format budaya Windows, yang tidak digunakan Formulir Windows secara langsung. Bidang ini static bersifat baca-saja.

MetafilePict

Menentukan format metafile Windows, yang tidak digunakan Formulir Windows secara langsung. Bidang ini static bersifat baca-saja.

OemText

Menentukan format teks standar Windows original equipment manufacturer (OEM). Bidang ini static bersifat baca-saja.

Palette

Menentukan format palet Windows. Bidang ini static bersifat baca-saja.

PenData

Menentukan format data pena Windows, yang terdiri dari goresan pena untuk perangkat lunak tulisan tangan; Formulir Windows tidak menggunakan format ini. Bidang ini static bersifat baca-saja.

Riff

Menentukan format audio Format File Pertukaran Sumber Daya (RIFF), yang Formulir Windows tidak digunakan secara langsung. Bidang ini static bersifat baca-saja.

Rtf

Menentukan teks yang terdiri dari data Rich Text Format (RTF). Bidang ini static bersifat baca-saja.

Serializable

Menentukan format yang merangkum semua jenis objek Formulir Windows. Bidang ini static bersifat baca-saja.

StringFormat

Menentukan format kelas string Formulir Windows, yang Formulir Windows gunakan untuk menyimpan objek string. Bidang ini static bersifat baca-saja.

SymbolicLink

Menentukan format tautan simbolis Windows, yang tidak digunakan Formulir Windows secara langsung. Bidang ini static bersifat baca-saja.

Text

Menentukan format teks ANSI standar. Bidang ini static bersifat baca-saja.

Tiff

Menentukan Format File Gambar Bertag (TIFF), yang tidak digunakan Formulir Windows secara langsung. Bidang ini static bersifat baca-saja.

UnicodeText

Menentukan format teks Windows Unicode standar. Bidang ini static bersifat baca-saja.

WaveAudio

Menentukan format audio gelombang, yang tidak digunakan Formulir Windows secara langsung. Bidang ini static bersifat baca-saja.

Metode

Nama Deskripsi
GetFormat(Int32)

Mengembalikan DataFormats.Format dengan ID numerik Windows Clipboard dan nama untuk ID yang ditentukan.

GetFormat(String)

Mengembalikan DataFormats.Format dengan ID numerik Windows Clipboard dan nama untuk format yang ditentukan.

Berlaku untuk

Lihat juga