DataObject.AddSettingDataHandler メソッド

定義

名前空間:

System.Windows

アセンブリ:

PresentationCore.dll

指定された依存関係オブジェクトに SettingData イベント ハンドラーを追加します。

public:
 static void AddSettingDataHandler(System::Windows::DependencyObject ^ element, System::Windows::DataObjectSettingDataEventHandler ^ handler);

public static void AddSettingDataHandler (System.Windows.DependencyObject element, System.Windows.DataObjectSettingDataEventHandler handler);

static member AddSettingDataHandler : System.Windows.DependencyObject * System.Windows.DataObjectSettingDataEventHandler -> unit

Public Shared Sub AddSettingDataHandler (element As DependencyObject, handler As DataObjectSettingDataEventHandler)

パラメーター

element

DependencyObject

イベント ハンドラーを追加する対象の依存関係オブジェクト (UIElement または ContentElement)。

handler

DataObjectSettingDataEventHandler

追加するハンドラー メソッドを参照するデリゲート。

注釈

イベントは SettingData 、関連付けられたデータ オブジェクトに追加するデータ形式ごとに 1 回、コピーまたはドラッグ コマンドの一部として発生します。 通常、このイベントは などの TextBoxコンテンツ コントロールに接続されます。

このイベントのハンドラーを使用すると、不要なデータ形式がデータ オブジェクトに追加されるのを選択的に防ぐことができます。そのため、冗長なデータ形式のデータ変換処理を排除し、コピー操作の全体的なパフォーマンスを向上させることができます。 特定のデータ形式をスキップするには、 メソッドを CancelCommand 呼び出し、 プロパティでスキップする形式を Format 指定します。 このイベントの メソッドを CancelCommand 呼び出しても、関連付けられているコピーまたはドラッグ コマンドは取り消されません。

こちらもご覧ください

• RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)