DataFormats Sınıf

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

staticönceden tanımlanmış Clipboard biçim adları sağlar. Bir içinde IDataObjectdepoladığınız veri biçimini tanımlamak için bunları kullanın.

public ref class DataFormats
public ref class DataFormats abstract sealed
public class DataFormats
public static class DataFormats
type DataFormats = class
Public Class DataFormats
Devralma
Object
DataFormats

Örnekler

Aşağıdaki kod örneği adlı myFormatyeni bir veri biçimi oluşturur. Kod daha sonra içinde MyNewObject depoladığı bir DataObjectoluşturur. DataObject, öğesine Clipboardkopyalanır.

Ardından , DataObject 'den Clipboard alınır ve MyNewObject kurtarılır. değeri MyNewObject bir metin kutusuna yazdırılır. Bu kod, oluşturulmasını ve bir forma yerleştirilmesini gerektirir textBox1 .

#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

Açıklamalar

IDataObject ve DataObject sınıfları, sistemden Clipboardalınan veya sürükleyip bırakma işleminde aktarılan veri türünü belirlemek için biçim listesini de kullanırstatic.

yöntemi şunları GetFormat yapmanızı sağlar:

  • Biçim adı veya kimlik numarası için önceden tanımlanmış DataFormats.Format bir nesne alın.

  • Bu sınıftaki listeye yeni bir biçim adı/kimlik numarası çifti static ekleyin ve biçim adını geçirirken biçimi Windows kayıt defterine biçim Clipboard olarak kaydetmek için.

Örnekteki Id uygun özellikten DataFormats.Format sayıyı veya biçimi Name alabilirsiniz.

Alanlar

Bitmap

Windows bit eşlem biçimini belirtir. Bu static alan salt okunur.
CommaSeparatedValue

Elektronik tablolar tarafından kullanılan ortak bir değişim biçimi olan virgülle ayrılmış değer (CSV) biçimini belirtir. Bu biçim doğrudan Windows Forms tarafından kullanılmaz. Bu static alan salt okunur.
Dib

Windows cihazdan bağımsız bit eşlem (DIB) biçimini belirtir. Bu static alan salt okunur.
Dif

Windows Forms doğrudan kullanmadığı Windows Veri Değişim Biçimini (DIF) belirtir. Bu static alan salt okunur.
EnhancedMetafile

gelişmiş Windows meta dosyası biçimini belirtir. Bu static alan salt okunur.
FileDrop

Windows Forms doğrudan kullanmadığı Windows dosya bırakma biçimini belirtir. Bu static alan salt okunur.
Html

METNI HTML Panosu biçiminde belirtir. Bu static alan salt okunur.
Locale

Windows Forms doğrudan kullanmadığı Windows kültür biçimini belirtir. Bu static alan salt okunur.
MetafilePict

Windows Forms doğrudan kullanmadığı Windows meta dosyası biçimini belirtir. Bu static alan salt okunur.
OemText

Standart Windows özgün donanım üreticisi (OEM) metin biçimini belirtir. Bu static alan salt okunur.
Palette

Windows palet biçimini belirtir. Bu static alan salt okunur.
PenData

El yazısı yazılımları için kalem vuruşlarından oluşan Windows kalem veri biçimini belirtir; Windows Forms bu biçimi kullanmaz. Bu static alan salt okunur.
Riff

Kaynak Değişim Dosyası Biçimi (RIFF) ses biçimini belirtir ve Windows Forms doğrudan kullanmaz. Bu static alan salt okunur.
Rtf

Zengin Metin Biçimi (RTF) verilerinden oluşan metni belirtir. Bu static alan salt okunur.
Serializable

Her tür Windows Forms nesnesini kapsülleyen bir biçim belirtir. Bu static alan salt okunur.
StringFormat

Windows Forms dize nesnelerini depolamak için kullandığı Windows Forms dize sınıfı biçimini belirtir. Bu static alan salt okunur.
SymbolicLink

Windows Forms doğrudan kullanmadığı Windows sembolik bağlantı biçimini belirtir. Bu static alan salt okunur.
Text

Standart ANSI metin biçimini belirtir. Bu static alan salt okunur.
Tiff

Windows Forms doğrudan kullanmadığı Etiketli Görüntü Dosya Biçimini (TIFF) belirtir. Bu static alan salt okunur.
UnicodeText

Standart Windows Unicode metin biçimini belirtir. Bu static alan salt okunur.
WaveAudio

Windows Forms doğrudan kullanmadığı dalga ses biçimini belirtir. Bu static alan salt okunur.

Yöntemler

GetFormat(Int32)

Belirtilen kimliğin Windows Pano sayısal kimliği ve adıyla bir DataFormats.Format döndürür.
GetFormat(String)

Belirtilen biçim için Windows Pano sayısal kimliği ve adıyla bir DataFormats.Format döndürür.

Şunlara uygulanır

Ayrıca bkz.