DataFormats Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje static
předdefinované Clipboard názvy formátů. Slouží k identifikaci formátu dat, která ukládáte v objektu IDataObject.
public ref class DataFormats
public ref class DataFormats abstract sealed
public class DataFormats
public static class DataFormats
type DataFormats = class
Public Class DataFormats
- Dědičnost
-
DataFormats
Příklady
Následující příklad kódu vytvoří nový formát dat s názvem myFormat
. Kód pak vytvoří , MyNewObject
který uloží do DataObject. Se DataObject zkopíruje do .Clipboard
Dále se DataObject načte z Clipboard a MyNewObject
obnoví se . Hodnota se vytiskne MyNewObject
v textovém poli. Tento kód vyžaduje, aby textBox1
byl vytvořen a umístěn ve formuláři.
#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
Třídy IDataObject a DataObject také používají static
seznam formátů k určení typu dat, která jsou načtena ze systému Clipboardnebo která jsou přenesena při operaci přetažení.
Metoda GetFormat umožňuje:
Získá předdefinovaný DataFormats.Format objekt pro název formátu nebo číslo ID.
Přidejte do seznamu v této třídě novou dvojici
static
čísel formátu název/ID a zaregistrujte formát v registru systému Windows jako Clipboard formát, když mu předáte název formátu.
Číslo nebo formát Name můžete získat Id z příslušné vlastnosti v DataFormats.Format instanci.
Pole
Bitmap |
Určuje formát rastrového obrázku systému Windows. Toto |
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 |
Dib |
Určuje formát dib (device-independent bitmap) systému Windows. Toto |
Dif |
Určuje formát DIF (Windows Data Interchange Format), který model Windows Forms přímo nepoužívá. Toto |
EnhancedMetafile |
Určuje formát rozšířeného metasouboru systému Windows. Toto |
FileDrop |
Určuje formát odstraňování souborů systému Windows, který model Windows Forms přímo nepoužívá. Toto |
Html |
Určuje text ve formátu html schránky. Toto |
Locale |
Určuje formát jazykové verze Windows, který model Windows Forms přímo nepoužívá. Toto |
MetafilePict |
Určuje formát metasouboru systému Windows, který model Windows Forms přímo nepoužívá. Toto |
OemText |
Určuje standardní textový formát výrobce OEM (Original Equipment Manufacturer) systému Windows. Toto |
Palette |
Určuje formát palety Systému Windows. Toto |
PenData |
Určuje datový formát pera systému Windows, který se skládá z tahů pera pro software pro rukopis. model Windows Forms tento formát nepoužívá. Toto |
Riff |
Určuje zvukový formát RIFF (Resource Interchange File Format), který model Windows Forms přímo nepoužívá. Toto |
Rtf |
Určuje text skládající se z dat ve formátu RTF (Rich Text Format). Toto |
Serializable |
Určuje formát, který zapouzdřuje libovolný typ model Windows Forms objektu. Toto |
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 |
SymbolicLink |
Určuje formát symbolického odkazu systému Windows, který model Windows Forms přímo nepoužívá. Toto |
Text |
Určuje standardní textový formát ANSI. Toto |
Tiff |
Určuje formát TIFF (Tagged Image File Format), který model Windows Forms nepoužívá přímo. Toto |
UnicodeText |
Určuje standardní textový formát Windows Unicode. Toto |
WaveAudio |
Určuje zvukový formát wave, který model Windows Forms přímo nepoužívá. Toto |
Metody
GetFormat(Int32) |
Vrátí hodnotu DataFormats.Format s číselným ID a názvem schránky systému Windows pro zadané ID. |
GetFormat(String) |
DataFormats.Format Vrátí hodnotu s číselným ID a názvem schránky systému Windows pro zadaný formát. |