DataObject.AddSettingDataHandler Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Fügt einem angegebenen Abhängigkeitsobjekt einen SettingData-Ereignishandler hinzu.

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)

Parameter

element

DependencyObject

Das Abhängigkeitsobjekt (ein UIElement oder ContentElement), dem der Ereignishandler hinzugefügt werden soll.

handler

DataObjectSettingDataEventHandler

Ein Delegat, der die hinzuzufügende Handlermethode referenziert.

Hinweise

Das SettingData Ereignis tritt als Teil eines Kopier- oder Ziehbefehls auf, einmal für jedes der Datenformate, die dem zugeordneten Datenobjekt hinzugefügt werden sollen. In der Regel ist dieses Ereignis mit einem Inhaltssteuerelement verbunden, z TextBox. B. .

Ein Handler für dieses Ereignis kann verwendet werden, um selektiv zu verhindern, dass dem Datenobjekt unerwünschte Datenformate hinzugefügt werden, wodurch die Datenkonvertierungsverarbeitung für redundante Datenformate entfällt und die Gesamtleistung eines Kopiervorgangs verbessert wird. Um ein bestimmtes Datenformat zu überspringen, rufen Sie die CancelCommand -Methode auf, und geben Sie in der -Eigenschaft das Format zu überspringende Format an. Wenn Sie die CancelCommand -Methode für dieses Ereignis aufrufen, wird der zugeordnete Befehl zum Kopieren oder Ziehen nicht abgebrochen.

Weitere Informationen

• RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)