DataFormats クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
static
な定義済み Clipboard 形式名を提供します。 これらを使用して IDataObject に格納するデータの形式を識別します。
public ref class DataFormats
public ref class DataFormats abstract sealed
public class DataFormats
public static class DataFormats
type DataFormats = class
Public Class DataFormats
- 継承
-
DataFormats
例
次のコード例では、 という名前 myFormat
の新しいデータ形式を作成します。 その後、コードは にDataObject格納する を作成MyNewObject
します。
DataObjectが にClipboardコピーされます。
次に DataObject 、 が から Clipboard 取得され、 MyNewObject
が復旧されます。 の MyNewObject
値はテキスト ボックスに出力されます。 このコードでは、 が 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
注釈
IDataObjectクラスと DataObject クラスは、書式リストをstatic
使用して、システムClipboardから取得されるデータの種類、またはドラッグ アンド ドロップ操作で転送されるデータの種類を決定します。
GetFormatメソッドを使用すると、次のことができます。
書式名または ID 番号の定義済み DataFormats.Format オブジェクトを取得します。
このクラスのリストに
static
新しい形式名と ID 番号のペアを追加し、書式名を渡すときに形式として Clipboard Windows レジストリに形式を登録します。
インスタンス内の Id 適切なプロパティから数値または形式 Name を DataFormats.Format 取得できます。
フィールド
Bitmap |
Windows ビットマップ形式を指定します。
|
CommaSeparatedValue |
コンマ区切り (CSV: Comma-Separated Value) 形式を指定します。この形式はスプレッドシートで使用する交換形式です。 Windows フォームでは、この形式が直接使用されることはありません。
|
Dib |
Windows のデバイスに依存しないビットマップ (DIB: Device-Independent Bitmap) 形式を指定します。
|
Dif |
Windows DIF (Data Interchange Format) を指定します。Windows フォームでは、この形式が直接使用されることはありません。
|
EnhancedMetafile |
Windows 拡張メタファイル形式を指定します。
|
FileDrop |
Windows ファイル ドロップ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。
|
Html |
HTML クリップボード形式のテキストを指定します。
|
Locale |
Windows のカルチャで使用する形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。
|
MetafilePict |
Windows メタファイル形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。
|
OemText |
標準の Windows OEM (Original Equipment Manufacturer) テキスト形式を指定します。
|
Palette |
Windows パレット形式を指定します。
|
PenData |
手書きソフトウェアのペン ストロークで形成される Windows ペン データ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。
|
Riff |
RIFF (Resource Interchange File Format) オーディオ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。
|
Rtf |
RTF (Rich Text Format) データで構成されるテキストを指定します。
|
Serializable |
任意の種類の Windows フォーム オブジェクトをカプセル化する形式を指定します。
|
StringFormat |
Windows フォーム文字列クラス形式を指定します。Windows フォームは、この形式を使用して文字列オブジェクトを格納します。
|
SymbolicLink |
Windows シンボリック リンク形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。
|
Text |
標準 ANSI テキスト形式を指定します。
|
Tiff |
TIFF (Tagged Image File Format) を指定します。Windows フォームでは、この形式が直接使用されることはありません。
|
UnicodeText |
標準 Windows Unicode テキスト形式を指定します。
|
WaveAudio |
WAVE オーディオ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。
|
メソッド
GetFormat(Int32) |
Windows クリップボード数値 ID および指定された ID の名前と共に DataFormats.Format を返します。 |
GetFormat(String) |
Windows クリップボード数値 ID および指定されたフォーマット名と共に DataFormats.Format を返します。 |
適用対象
こちらもご覧ください
.NET