DataObject.AddSettingDataHandler Metodo

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

Aggiunge un gestore dell'evento SettingData a un oggetto dipendenza specificato.

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)

Parametri

element

DependencyObject

Oggetto dipendenza (UIElement o ContentElement) a cui aggiungere il gestore dell'evento.

handler

DataObjectSettingDataEventHandler

Un delegato che fa riferimento al metodo del gestore da aggiungere.

Commenti

L'evento SettingData si verifica come parte di un comando di copia o trascinamento, una volta per ognuno dei formati di dati da aggiungere all'oggetto dati associato. In genere, questo evento è connesso a un controllo contenuto, ad esempio TextBox.

Un gestore per questo evento può essere usato per impedire l'aggiunta selettiva dei formati di dati indesiderati all'oggetto dati, eliminando così l'elaborazione della conversione dei dati per formati di dati ridondanti e migliorando le prestazioni complessive di un'operazione di copia. Per ignorare un formato di dati specifico, chiamare il metodo e specificare il CancelCommand formato da ignorare nella Format proprietà. La chiamata al CancelCommand metodo per questo evento non annulla il comando di copia o trascinamento associato.

Vedi anche

• RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)