Freigeben über


DataObject.AddPastingHandler Methode

Definition

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

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)

Parameter

element
DependencyObject

Das Abhängigkeitsobjekt (a UIElement oder ContentElement) zum Hinzufügen des Ereignishandlers.

handler
DataObjectPastingEventHandler

Ein Delegat, der auf die hinzuzufügende Handlermethode verweist.

Hinweise

Verwenden Sie dieses Ereignis, um ein Datenobjekt zu prüfen, bevor die Daten eingefügt werden, und möglicherweise um einen alternativen Aktionsverlauf zu entscheiden, z. B.:

  • Abbrechen des Einfügevorgangs – Abbrechen des gesamten Einfügevorgangs durch Aufrufen der CancelCommand Methode.

  • Wählen Sie ein alternatives Format aus– Ändern Sie das ausgewählte Einfügeformat, indem Sie einen neuen Wert für die FormatToApply Eigenschaft angeben. Das neu ausgewählte Format muss von dem datenobjekt unterstützt werden, das eingefügt werden soll.

    Hinweis

    Wenn das Einfügeformat geändert wird, stellen Sie sicher, dass das Einfügeziel das neu angegebene Format unterstützt.

  • Einfügen eines neuen Formats – Wenn Sie feststellen, dass das Einfügedatenobjekt das gewünschte Format nicht unterstützt, aktualisieren Sie das Datenobjekt so, dass es eine Version der Daten im gewünschten Format enthält. Benutzerdefinierte Datenkonverter werden häufig als Teil dieses Prozesses verwendet.

Durch das Ändern des Inhalts eines Einfügedatenobjekts (DataObject) werden die in der Systemablage gespeicherten Daten nicht geändert. Solche Änderungen gelten nur für das Datenobjekt, das dem zugeordneten Einfügebefehl zugeordnet ist.

Gilt für:

Weitere Informationen