DataObject.AddPastingHandler(DependencyObject, DataObjectPastingEventHandler) Method


指定された依存関係オブジェクトに Pasting イベント ハンドラーを追加します。 Adds a Pasting event handler to a specified dependency object.

public static void AddPastingHandler (System.Windows.DependencyObject element, System.Windows.DataObjectPastingEventHandler handler);

イベント ハンドラーを追加する対象の依存関係オブジェクト (UIElement または ContentElement)。 The dependency object (a UIElement or ContentElement) to which to add the event handler.


追加するハンドラー メソッドを参照するデリゲート。 A delegate that references the handler method to add.


このイベントを使用してに直接的および場合によって、データを貼り付けると、前に、データ オブジェクトを検査するアクションの代替のコースなどを決定します。Use this event to inspect a data object before the data is pasted, and possibly to decide on an alternate course of action, such as:

  • 貼り付けをキャンセルで呼び出すことによって、全体の貼り付け操作をキャンセル、CancelCommandメソッド。Cancel the Paste - Cancel the entire paste operation by calling the CancelCommand method.

  • 代替形式を選択します-新しい値を指定することで貼り付けが選択されている形式を変更、FormatToApplyプロパティ。Select an Alternate Format - Change the selected paste format by specifying a new value for the FormatToApply property. 貼り付けるデータ オブジェクトでは、新しく選択した形式はサポートする必要がありますで。The newly selected format must by supported by the data object to be pasted.


    貼り付けの形式を変更する場合は、貼り付け先が、新しく指定した形式をサポートしていることを確認します。If the paste format is changed, ensure that the paste target supports the newly specified format.

  • 新しい形式の挿入- 貼り付けデータ オブジェクトの目的の形式をサポートして、目的の形式でデータのバージョンを含めるデータ オブジェクトを更新はいないと判断した場合。Insert a New Format - If you determine that the paste data object does not support the desired format, update the data object to include a version of the data in the desired format. カスタム データ コンバーターは、このプロセスの一環としてよく使用されます。Custom data converters are often used as part of this process.

貼り付けのデータ オブジェクトの内容を変更 (DataObject) はシステム クリップボードに格納されているデータを変更しません。 このような変更が関連付けられている貼り付けコマンドに関連付けられたデータ オブジェクトにのみ適用されます。Changing the content of a paste data object (DataObject) does not change the data stored on the system Clipboard; any such changes will apply only to the data object associated with the associated paste command.