DataObject.AddSettingDataHandler Método

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Adiciona um manipulador de eventos SettingData a um objeto de dependência especificado.

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)

Parâmetros

element

DependencyObject

O objeto de dependência (um UIElement ou ContentElement) ao qual o manipulador de eventos será adicionado.

handler

DataObjectSettingDataEventHandler

Um delegado que faz referência ao método de manipulador a ser adicionado.

Comentários

O SettingData evento ocorre como parte de um comando copy ou drag, uma vez para cada um dos formatos de dados a serem adicionados ao objeto de dados associado. Normalmente, esse evento é conectado a um controle de conteúdo, como TextBox.

Um manipulador para esse evento pode ser usado para impedir seletivamente que formatos de dados indesejados sejam adicionados ao objeto de dados, eliminando assim o processamento de conversão de dados para formatos de dados redundantes e melhorando o desempenho geral de uma operação de cópia. Para ignorar um formato de dados específico, chame o CancelCommand método e especifique o formato a ser pulado na Format propriedade . Chamar o CancelCommand método para esse evento não cancela o comando copy ou drag associado.

Confira também

• RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)