DataFormats Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
staticdi 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 |
| 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 |
| Dib |
Menentukan format bitmap independen perangkat (DIB) Windows. Bidang ini |
| Dif |
Menentukan Format Pertukaran Data (DIF) Windows, yang tidak digunakan secara langsung oleh Formulir Windows. Bidang ini |
| EnhancedMetafile |
Menentukan format metafile Windows ditingkatkan. Bidang ini |
| FileDrop |
Menentukan format penurunan file Windows, yang Formulir Windows tidak digunakan secara langsung. Bidang ini |
| Html |
Menentukan teks dalam format Papan Klip HTML. Bidang ini |
| Locale |
Menentukan format budaya Windows, yang tidak digunakan Formulir Windows secara langsung. Bidang ini |
| MetafilePict |
Menentukan format metafile Windows, yang tidak digunakan Formulir Windows secara langsung. Bidang ini |
| OemText |
Menentukan format teks standar Windows original equipment manufacturer (OEM). Bidang ini |
| Palette |
Menentukan format palet Windows. Bidang ini |
| PenData |
Menentukan format data pena Windows, yang terdiri dari goresan pena untuk perangkat lunak tulisan tangan; Formulir Windows tidak menggunakan format ini. Bidang ini |
| Riff |
Menentukan format audio Format File Pertukaran Sumber Daya (RIFF), yang Formulir Windows tidak digunakan secara langsung. Bidang ini |
| Rtf |
Menentukan teks yang terdiri dari data Rich Text Format (RTF). Bidang ini |
| Serializable |
Menentukan format yang merangkum semua jenis objek Formulir Windows. Bidang ini |
| StringFormat |
Menentukan format kelas string Formulir Windows, yang Formulir Windows gunakan untuk menyimpan objek string. Bidang ini |
| SymbolicLink |
Menentukan format tautan simbolis Windows, yang tidak digunakan Formulir Windows secara langsung. Bidang ini |
| Text |
Menentukan format teks ANSI standar. Bidang ini |
| Tiff |
Menentukan Format File Gambar Bertag (TIFF), yang tidak digunakan Formulir Windows secara langsung. Bidang ini |
| UnicodeText |
Menentukan format teks Windows Unicode standar. Bidang ini |
| WaveAudio |
Menentukan format audio gelombang, yang tidak digunakan Formulir Windows secara langsung. Bidang ini |
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. |