DataFormats DataFormats DataFormats DataFormats Class

定義

static な定義済み Clipboard 形式名を提供します。Provides static, predefined Clipboard format names. これらを使用して IDataObject に格納するデータの形式を識別します。Use them to identify the format of data that you store in an IDataObject.

public ref class DataFormats
public class DataFormats
type DataFormats = class
Public Class DataFormats
継承
DataFormatsDataFormatsDataFormatsDataFormats

次のコード例は、という名前の新しいデータ形式を作成します。myFormatします。The following code example creates a new data format named myFormat. このコードを作成し、MyNewObjectに格納している、DataObjectします。The code then creates a MyNewObject which it stores in a DataObject. DataObjectにコピーされて、Clipboardします。The DataObject is copied to the Clipboard.

次に、DataObjectから取得されます、ClipboardMyNewObjectが復旧されます。Next, the DataObject is retrieved from the Clipboard and the MyNewObject is recovered. 値、MyNewObjectはテキスト ボックスで出力されます。The value of the MyNewObject is printed in a text box. このコードである必要がありますtextBox1作成され、フォーム上に配置します。This code requires that textBox1 has been created and placed on a form.

#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
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 'MyClipboardMethod
End Class 'MyClass


' 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 'New
    
    ' 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 'MyNewObject

注釈

IDataObjectDataObjectクラスに対しても使用して、static形式の一覧、システムから取得したデータの種類を決定するClipboard、ドラッグ アンド ドロップ操作で転送されるか。The IDataObject and DataObject classes also use the static format list to determine the type of data that is retrieved from the system Clipboard, or that is transferred in a drag-and-drop operation.

GetFormatメソッドを使用します。The GetFormat method allows you to:

  • 事前に定義された取得DataFormats.Format形式の名前または ID 番号のオブジェクト。Get a predefined DataFormats.Format object for a format name or ID number.

  • 新しい形式の名前と ID 番号のペアを追加、static形式として、Windows レジストリに登録して、このクラスで一覧表示、Clipboard形式名を渡すときに書式を設定します。Add a new format name/ID number pair to the static list in this class, and to register the format with the Windows registry as a Clipboard format when you pass it the format name.

取得することができます、Id数または形式Nameで適切なプロパティから、DataFormats.Formatインスタンス。You can get the Id number or format Name from the appropriate property in the DataFormats.Format instance.

フィールド

Bitmap Bitmap Bitmap Bitmap

Windows ビットマップ形式を指定します。Specifies a Windows bitmap format. static フィールドは読み取り専用です。This static field is read-only.

CommaSeparatedValue CommaSeparatedValue CommaSeparatedValue CommaSeparatedValue

コンマ区切り (CSV: Comma-Separated Value) 形式を指定します。この形式はスプレッドシートで使用する交換形式です。Specifies a comma-separated value (CSV) format, which is a common interchange format used by spreadsheets. Windows フォームでは、この形式が直接使用されることはありません。This format is not used directly by Windows Forms. static フィールドは読み取り専用です。This static field is read-only.

Dib Dib Dib Dib

Windows のデバイスに依存しないビットマップ (DIB: Device-Independent Bitmap) 形式を指定します。Specifies the Windows device-independent bitmap (DIB) format. static フィールドは読み取り専用です。This static field is read-only.

Dif Dif Dif Dif

Windows DIF (Data Interchange Format) を指定します。Windows フォームでは、この形式が直接使用されることはありません。Specifies the Windows Data Interchange Format (DIF), which Windows Forms does not directly use. static フィールドは読み取り専用です。This static field is read-only.

EnhancedMetafile EnhancedMetafile EnhancedMetafile EnhancedMetafile

Windows 拡張メタファイル形式を指定します。Specifies the Windows enhanced metafile format. static フィールドは読み取り専用です。This static field is read-only.

FileDrop FileDrop FileDrop FileDrop

Windows ファイル ドロップ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。Specifies the Windows file drop format, which Windows Forms does not directly use. static フィールドは読み取り専用です。This static field is read-only.

Html Html Html Html

HTML クリップボード形式のテキストを指定します。Specifies text in the HTML Clipboard format. static フィールドは読み取り専用です。This static field is read-only.

Locale Locale Locale Locale

Windows のカルチャで使用する形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。Specifies the Windows culture format, which Windows Forms does not directly use. static フィールドは読み取り専用です。This static field is read-only.

MetafilePict MetafilePict MetafilePict MetafilePict

Windows メタファイル形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。Specifies the Windows metafile format, which Windows Forms does not directly use. static フィールドは読み取り専用です。This static field is read-only.

OemText OemText OemText OemText

標準の Windows OEM (Original Equipment Manufacturer) テキスト形式を指定します。Specifies the standard Windows original equipment manufacturer (OEM) text format. static フィールドは読み取り専用です。This static field is read-only.

Palette Palette Palette Palette

Windows パレット形式を指定します。Specifies the Windows palette format. static フィールドは読み取り専用です。This static field is read-only.

PenData PenData PenData PenData

手書きソフトウェアのペン ストロークで形成される Windows ペン データ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。Specifies the Windows pen data format, which consists of pen strokes for handwriting software; Windows Forms does not use this format. static フィールドは読み取り専用です。This static field is read-only.

Riff Riff Riff Riff

RIFF (Resource Interchange File Format) オーディオ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。Specifies the Resource Interchange File Format (RIFF) audio format, which Windows Forms does not directly use. static フィールドは読み取り専用です。This static field is read-only.

Rtf Rtf Rtf Rtf

RTF (Rich Text Format) データで構成されるテキストを指定します。Specifies text consisting of Rich Text Format (RTF) data. static フィールドは読み取り専用です。This static field is read-only.

Serializable Serializable Serializable Serializable

任意の種類の Windows フォーム オブジェクトをカプセル化する形式を指定します。Specifies a format that encapsulates any type of Windows Forms object. static フィールドは読み取り専用です。This static field is read-only.

StringFormat StringFormat StringFormat StringFormat

Windows フォーム文字列クラス形式を指定します。Windows フォームは、この形式を使用して文字列オブジェクトを格納します。Specifies the Windows Forms string class format, which Windows Forms uses to store string objects. static フィールドは読み取り専用です。This static field is read-only.

SymbolicLink SymbolicLink SymbolicLink SymbolicLink

Windows シンボリック リンク形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。Specifies the Windows symbolic link format, which Windows Forms does not directly use. static フィールドは読み取り専用です。This static field is read-only.

Text Text Text Text

標準 ANSI テキスト形式を指定します。Specifies the standard ANSI text format. static フィールドは読み取り専用です。This static field is read-only.

Tiff Tiff Tiff Tiff

TIFF (Tagged Image File Format) を指定します。Windows フォームでは、この形式が直接使用されることはありません。Specifies the Tagged Image File Format (TIFF), which Windows Forms does not directly use. static フィールドは読み取り専用です。This static field is read-only.

UnicodeText UnicodeText UnicodeText UnicodeText

標準 Windows Unicode テキスト形式を指定します。Specifies the standard Windows Unicode text format. static フィールドは読み取り専用です。This static field is read-only.

WaveAudio WaveAudio WaveAudio WaveAudio

WAVE オーディオ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。Specifies the wave audio format, which Windows Forms does not directly use. static フィールドは読み取り専用です。This static field is read-only.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetFormat(Int32) GetFormat(Int32) GetFormat(Int32) GetFormat(Int32)

Windows クリップボード数値 ID および指定された ID の名前と共に DataFormats.Format を返します。Returns a DataFormats.Format with the Windows Clipboard numeric ID and name for the specified ID.

GetFormat(String) GetFormat(String) GetFormat(String) GetFormat(String)

Windows クリップボード数値 ID および指定されたフォーマット名と共に DataFormats.Format を返します。Returns a DataFormats.Format with the Windows Clipboard numeric ID and name for the specified format.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください