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 -> unitPublic Shared Sub AddPastingHandler (element As DependencyObject, handler As DataObjectPastingEventHandler)Параметры
- element
- DependencyObject
Объект зависимости (UIElement или ContentElement), к которому добавляется обработчик событий.
- handler
- DataObjectPastingEventHandler
Делегат, ссылающийся на добавляемый метод-обработчик.
Комментарии
Используйте это событие для проверки объекта данных перед вставкой данных и, возможно, для выбора альтернативного варианта действий, например:
Отмена вставки — отмена всей операции вставки путем вызова CancelCommand метода .
Выберите альтернативный формат . Измените выбранный формат вставки, указав новое значение для FormatToApply свойства . Только что выбранный формат должен поддерживаться объектом данных для вставки.
Примечание
Если формат вставки изменен, убедитесь, что целевой объект вставки поддерживает только что указанный формат.
Вставка нового формата . Если вы определили, что объект данных вставки не поддерживает нужный формат, обновите объект данных, чтобы включить версию данных в нужном формате. В рамках этого процесса часто используются пользовательские преобразователи данных.
Изменение содержимого объекта данных вставки (DataObject) не приводит к изменению данных, хранящихся в системном буфере обмена; любые такие изменения будут применяться только к объекту данных, связанному с соответствующей командой paste.
