IDataObject インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データを転送するための形式に依存しないメカニズムを提供します。
public interface class IDataObject[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject[<System.Runtime.InteropServices.ComVisible(true)>]
type IDataObject = interfacePublic Interface IDataObject- 派生
- 属性
注釈
IDataObject インターフェイスは、Clipboard クラスおよびドラッグ アンド ドロップ操作で使用されます。
IDataObject メソッドをクラスに実装すると、ユーザーはクラスのインスタンスに複数の形式でデータを格納できます。 複数の形式でデータを格納すると、形式要件がわからないターゲット アプリケーションが格納されたデータを取得できる可能性が高くなります。
IDataObjectのインスタンスにデータを格納するには、SetData メソッドを呼び出し、format パラメーターでデータ形式を指定します。 格納されているデータを取得時に別の形式に変換しない場合は、 autoConvert パラメーターを false に設定します。
IDataObjectの 1 つのインスタンスでSetDataを複数回呼び出して、複数の形式でデータを格納します。
IDataObjectから格納されたデータを取得するには、GetData メソッドを呼び出し、format パラメーターでデータ形式を指定します。
autoConvert パラメーターを false に設定して、指定した形式で格納されたデータのみを取得します。 格納されているデータを指定した形式に変換するには、 autoConvert を true に設定するか、 autoConvertを使用しないでください。
IDataObjectに格納されているデータの形式を確認するには、次のIDataObjectメソッドを使用します。
GetFormats メソッドを呼び出して、データが使用可能なすべての形式の配列を取得します。
autoConvertパラメーターをfalseに設定して、データが格納されている形式のみを取得します。 データが使用可能なすべての形式を取得するには、autoConvertをtrueに設定するか、このパラメーターを使用しないでください。GetDataPresent メソッドを呼び出して、格納されているデータが特定の形式で使用できるかどうかを判断します。 格納されたデータを指定した形式に変換しない場合は、
autoConvertパラメーターをfalseに設定します。
このインターフェイスの実装については、 DataObject クラスを参照してください。 定義済みのClipboardデータ形式については、DataFormats クラスを参照してください。
メソッド
| 名前 | 説明 |
|---|---|
| GetData(String, Boolean) |
ブール値を使用して、データを形式に変換するかどうかを判断して、指定したデータ形式に関連付けられているデータを取得します。 |
| GetData(String) |
指定したデータ形式に関連付けられているデータを取得します。 |
| GetData(Type) |
指定したクラス型形式に関連付けられているデータを取得します。 |
| GetDataPresent(String, Boolean) |
ブール値を使用してデータを形式に変換するかどうかを決定して、このインスタンスに格納されているデータが指定した形式に関連付けられているかどうかを判断します。 |
| GetDataPresent(String) |
このインスタンスに格納されているデータが、指定した形式に関連付けられているか、または変換できるかを決定します。 |
| GetDataPresent(Type) |
このインスタンスに格納されているデータが、指定した形式に関連付けられているか、または変換できるかを決定します。 |
| GetFormats() |
このインスタンスに格納されているデータが関連付けられているか、変換可能なすべての形式の一覧を返します。 |
| GetFormats(Boolean) |
このインスタンスに格納されているデータが関連付けられている、または変換できるすべての形式の一覧を取得します。ブール値を使用して、データを変換できるすべての形式を取得するか、ネイティブ データ形式のみを取得するかを決定します。 |
| SetData(Object) |
形式のデータのクラスを使用して、指定したデータをこのインスタンスに格納します。 |
| SetData(String, Boolean, Object) |
ブール値を使用して、データを別の形式に変換できるかどうかを指定して、指定したデータとその関連する形式をこのインスタンスに格納します。 |
| SetData(String, Object) |
指定したデータとそれに関連付けられている形式をこのインスタンスに格納します。 |
| SetData(Type, Object) |
指定したデータとそれに関連付けられているクラス型をこのインスタンスに格納します。 |