DataFormats Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt staticvooraf gedefinieerde Clipboard notatienamen. Gebruik deze om de indeling van gegevens te identificeren die u opslaat in een IDataObject.
public ref class DataFormats
public class DataFormats
type DataFormats = class
Public Class DataFormats
- Overname
-
DataFormats
Voorbeelden
In het volgende codevoorbeeld wordt een nieuwe gegevensindeling gemaakt met de naam myFormat. De code maakt vervolgens een MyNewObject die wordt opgeslagen in een DataObject. De DataObject kopie wordt gekopieerd naar de Clipboard.
Vervolgens wordt het DataObject opgehaald uit de Clipboard en wordt het MyNewObject hersteld. De waarde van de waarde MyNewObject wordt afgedrukt in een tekstvak. Voor deze code moet een textBox1 formulier zijn gemaakt en geplaatst.
#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
Opmerkingen
De IDataObject en DataObject klassen gebruiken ook de static notatielijst om het type gegevens te bepalen dat wordt opgehaald uit het systeem Clipboardof die worden overgebracht in een slepen-en-neerzetten-bewerking.
Met de GetFormat methode kunt u het volgende doen:
Haal een vooraf gedefinieerd DataFormats.Format object op voor een notatienaam of id-nummer.
Voeg een nieuw notatienaam/id-nummerpaar toe aan de
static-lijst in deze klasse en om de notatie te registreren bij het Windows register als een Clipboard-indeling wanneer u de notatienaam doorgeeft.
U kunt het getal of de Id notatie Name ophalen uit de juiste eigenschap in het DataFormats.Format exemplaar.
Velden
| Name | Description |
|---|---|
| Bitmap |
Hiermee geeft u een Windows bitmapindeling. Dit |
| CommaSeparatedValue |
Hiermee geeft u een csv-indeling (door komma's gescheiden waarden) op. Dit is een gemeenschappelijke indeling voor uitwisseling die wordt gebruikt door spreadsheets. Deze indeling wordt niet rechtstreeks gebruikt door Windows Forms. Dit |
| Dib |
Hiermee geeft u de indeling Windows apparaatonafhankelijke bitmap (DIB). Dit |
| Dif |
Hiermee geeft u de Windows Data Interchange Format (DIF), die Windows Forms niet rechtstreeks gebruikt. Dit |
| EnhancedMetafile |
Hiermee geeft u de Windows verbeterde metabestand-indeling. Dit |
| FileDrop |
Hiermee geeft u de Windows vervolgkeuzelijst op, die Windows Forms niet rechtstreeks gebruikt. Dit |
| Html |
Hiermee geeft u tekst op in de HTML Klembord-indeling. Dit |
| Locale |
Hiermee geeft u de Windows cultuurindeling op, die Windows Forms niet rechtstreeks gebruikt. Dit |
| MetafilePict |
Hiermee geeft u de Windows metafile-indeling op, die Windows Forms niet rechtstreeks gebruikt. Dit |
| OemText |
Hiermee geeft u de standaard Windows oem-tekstindeling (Original Equipment Manufacturer). Dit |
| Palette |
Hiermee geeft u de Windows paletindeling. Dit |
| PenData |
Hiermee geeft u de Windows pengegevensindeling, die bestaat uit pennenstreken voor handschriftsoftware; Windows Forms gebruikt deze indeling niet. Dit |
| Riff |
Hiermee geeft u de RIFF-audio-indeling (Resource Interchange File Format) op, die Windows Forms niet rechtstreeks gebruikt. Dit |
| Rtf |
Hiermee geeft u tekst op die bestaat uit RTF-gegevens (Rich Text Format). Dit |
| Serializable |
Hiermee geeft u een indeling op die elk type Windows Forms object inkapselt. Dit |
| StringFormat |
Hiermee geeft u de Windows Forms tekenreeksklasse-indeling op, die Windows Forms gebruikt om tekenreeksobjecten op te slaan. Dit |
| SymbolicLink |
Hiermee geeft u de Windows symbolische koppelingsindeling op, die Windows Forms niet rechtstreeks gebruikt. Dit |
| Text |
Hiermee geeft u de standaard ANSI-tekstindeling. Dit |
| Tiff |
Hiermee geeft u de Tagged Image File Format (TIFF), die Windows Forms niet rechtstreeks gebruikt. Dit |
| UnicodeText |
Hiermee geeft u de standaard Windows Unicode-tekstindeling. Dit |
| WaveAudio |
Hiermee geeft u de wave audio-indeling, die Windows Forms niet rechtstreeks gebruikt. Dit |
Methoden
| Name | Description |
|---|---|
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetFormat(Int32) |
Retourneert een DataFormats.Format met de numerieke id van het Windows Klembord en de naam voor de opgegeven id. |
| GetFormat(String) |
Retourneert een DataFormats.Format met de numerieke id van het Windows Klembord en de naam voor de opgegeven indeling. |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |