IDataObject IDataObject IDataObject IDataObject Interface

定義

形式に依存しないデータ転送機構を提供します。Provides a format-independent mechanism for transferring data.

public interface class IDataObject
[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject
type IDataObject = interface
Public Interface IDataObject
派生
属性

注釈

IDataObjectインターフェイスを使って、Clipboardクラスとドラッグ アンド ドロップ操作でします。The IDataObject interface is used by the Clipboard class and in drag-and-drop operations.

クラスで実装された場合、IDataObjectメソッドは、クラスのインスタンスで複数の形式でデータを格納するユーザーを許可します。When implemented in a class, the IDataObject methods allow the user to store data in multiple formats in an instance of the class. 1 つ以上の形式でデータを格納するには、形式の要件がわからない場合がありますが、ターゲット アプリケーションが格納されているデータを取得できる可能性が高くなります。Storing data in more than one format increases the chance that a target application, whose format requirements you might not know, can retrieve the stored data. インスタンスにデータを格納するIDataObjectを呼び出し、SetDataメソッドでデータ形式を指定し、formatパラメーター。To store data in an instance of IDataObject, call the SetData method and specify the data format in the format parameter. 設定、autoConvertパラメーターをfalse格納されたデータが取得されたときに別の形式に変換しないかどうか。Set the autoConvert parameter to false if you do not want stored data to be converted to another format when it is retrieved. 呼び出すSetDataの 1 つのインスタンスで複数回IDataObject1 つ以上の形式でデータを格納します。Invoke SetData multiple times on one instance of IDataObject to store data in more than one format.

格納されたデータを取得する、IDataObject呼び出すことによって、GetDataで書式設定メソッドと、データを指定する、formatパラメーター。You retrieve stored data from an IDataObject by calling the GetData method and specifying the data format in the format parameter. 設定、autoConvertパラメーターをfalseを指定した形式で格納されたデータのみを取得します。Set the autoConvert parameter to false to retrieve only data that was stored in the specified format. 指定した形式に格納されているデータを変換するには設定autoConverttrue、または使用しないでくださいautoConvertします。To convert the stored data to the specified format, set autoConvert to true, or do not use autoConvert.

格納されたデータの形式を決定する、 IDataObject、次を使用して、IDataObjectメソッド。To determine the formats of the data stored in an IDataObject, use the following IDataObject methods.

  • 呼び出す、GetFormatsデータが使用するすべての形式の配列を取得します。Call the GetFormats method to retrieve an array of all the formats in which the data is available. 設定、autoConvertパラメーターをfalseデータが格納されている形式のみを取得します。Set the autoConvert parameter to false to get only the formats in which the data is stored. データの使用可能なすべての形式を取得するには、次のように設定します。autoConverttrue、またはこのパラメーターを使用しません。To get all the formats in which the data is available, set autoConvert to true, or do not use this parameter.

  • 呼び出す、GetDataPresent格納されたデータが特定の形式で使用できるかどうかを判断するメソッド。Call the GetDataPresent method to determine whether stored data is available in a certain format. 格納されたデータを指定した形式に変換したくない場合は、設定、autoConvertパラメーターfalseします。If you do not want stored data to be converted to the specified format, set the autoConvert parameter to false.

参照してください、DataObjectこのインターフェイスの実装のクラス。See the DataObject class for an implementation of this interface. 参照してください、 DataFormats 、定義済みのクラスClipboardデータ形式。See the DataFormats class for the predefined Clipboard data formats.

メソッド

GetData(String) GetData(String) GetData(String) GetData(String)

指定したデータ形式に関連付けられているデータを取得します。Retrieves the data associated with the specified data format.

GetData(Type) GetData(Type) GetData(Type) GetData(Type)

指定したクラス型形式に関連付けられているデータを取得します。Retrieves the data associated with the specified class type format.

GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean)

指定したデータ形式に関連付けられているデータを取得します。データを指定形式に変換できるかどうかを確認するためにブール値を使用します。Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

GetDataPresent(String) GetDataPresent(String) GetDataPresent(String) GetDataPresent(String)

インスタンスに格納されているデータが、指定した形式と関連付けられているかどうかや、その形式に変換できるかどうかを確認します。Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetDataPresent(Type) GetDataPresent(Type) GetDataPresent(Type) GetDataPresent(Type)

インスタンスに格納されているデータが、指定した形式と関連付けられているかどうかや、その形式に変換できるかどうかを確認します。Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetDataPresent(String, Boolean) GetDataPresent(String, Boolean) GetDataPresent(String, Boolean) GetDataPresent(String, Boolean)

インスタンスに格納されているデータが、指定した形式に関連付けられているかどうかを確認します。データを指定形式に変換できるかどうかを確認するためにブール値を使用します。Determines whether data stored in this instance is associated with the specified format, using a Boolean value to determine whether to convert the data to the format.

GetFormats() GetFormats() GetFormats() GetFormats()

このインスタンスに格納されたデータに関連付けられているすべての形式、または変換できるすべての形式のリストを返します。Returns a list of all formats that data stored in this instance is associated with or can be converted to.

GetFormats(Boolean) GetFormats(Boolean) GetFormats(Boolean) GetFormats(Boolean)

インスタンスに格納されているデータが関連付けられている形式、またはそのデータを変換できる形式のリストを取得します。データを変換できる形式をすべて取得するのか、ネイティブ データ形式だけを取得するのかを確認するためにブール値を使用します。Gets a list of all formats that data stored in this instance is associated with or can be converted to, using a Boolean value to determine whether to retrieve all formats that the data can be converted to or only native data formats.

SetData(Object) SetData(Object) SetData(Object) SetData(Object)

指定したデータを、そのデータのクラスに基づく形式で、このインスタンスに格納します。Stores the specified data in this instance, using the class of the data for the format.

SetData(String, Object) SetData(String, Object) SetData(String, Object) SetData(String, Object)

指定したデータおよびそのデータに関連付けられている形式をインスタンスに格納します。Stores the specified data and its associated format in this instance.

SetData(Type, Object) SetData(Type, Object) SetData(Type, Object) SetData(Type, Object)

指定されているデータおよびそのデータに関連付けられているクラス型をインスタンスに格納します。Stores the specified data and its associated class type in this instance.

SetData(String, Boolean, Object) SetData(String, Boolean, Object) SetData(String, Boolean, Object) SetData(String, Boolean, Object)

指定されているデータおよびそのデータに関連付けられている形式をインスタンスに格納します。データを別の形式に変換できるかどうかを確認するためにブール値を使用します。Stores the specified data and its associated format in this instance, using a Boolean value to specify whether the data can be converted to another format.

適用対象

こちらもご覧ください