Поделиться через


DataObject.AddPastingHandler Метод

Определение

Добавляет обработчик событий 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

Объект зависимости (UIElement или ContentElement), к которому добавляется обработчик событий.

handler
DataObjectPastingEventHandler

Делегат, ссылающийся на добавляемый метод-обработчик.

Комментарии

Используйте это событие для проверки объекта данных перед вставкой данных и, возможно, для выбора альтернативного варианта действий, например:

  • Отмена вставки — отмена всей операции вставки путем вызова CancelCommand метода .

  • Выберите альтернативный формат . Измените выбранный формат вставки, указав новое значение для FormatToApply свойства . Только что выбранный формат должен поддерживаться объектом данных для вставки.

    Примечание

    Если формат вставки изменен, убедитесь, что целевой объект вставки поддерживает только что указанный формат.

  • Вставка нового формата . Если вы определили, что объект данных вставки не поддерживает нужный формат, обновите объект данных, чтобы включить версию данных в нужном формате. В рамках этого процесса часто используются пользовательские преобразователи данных.

Изменение содержимого объекта данных вставки (DataObject) не приводит к изменению данных, хранящихся в системном буфере обмена; любые такие изменения будут применяться только к объекту данных, связанному с соответствующей командой paste.

Применяется к

См. также раздел