DataObject.AddPastingHandler 方法

定義

命名空間:

System.Windows

組件:

PresentationCore.dll

為 Pasting 指定的相依物件新增事件處理器。

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

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

static member AddPastingHandler : System.Windows.DependencyObject * System.Windows.DataObjectPastingEventHandler -> unit

Public Shared Sub AddPastingHandler (element As DependencyObject, handler As DataObjectPastingEventHandler)

參數

element

DependencyObject

要加入事件處理程序的相依物件（a UIElement 或 ContentElement）。

handler

DataObjectPastingEventHandler

一個代理，會參考 handler 方法來新增。

備註

利用此事件在資料貼上前檢查資料物件，並可能決定替代行動方案，例如：

• 取消貼上 - 透過呼叫 CancelCommand 方法取消整個貼上操作。

• 選擇替代格式 - 透過指定屬性的新值 FormatToApply 來更改所選的貼上格式。 新選取的格式必須由要貼上的資料物件所支援。

  備註

  如果貼上格式被更改，請確保貼上目標支援新指定的格式。

• 插入新格式 - 若您確定貼上資料物件不支援所需格式，請更新資料物件以包含所需格式的版本資料。 客製化資料轉換器通常會作為此過程的一部分使用。

更改貼上資料物件DataObject（）的內容不會改變系統剪貼簿中儲存的資料;任何此類變更只會影響與該貼上指令相關的資料物件。

另請參閱

• RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)