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 (ein UIElement oder ContentElement), dem der Ereignishandler hinzugefügt werden soll.

handler
DataObjectPastingEventHandler

Ein Delegat, der die hinzuzufügende Handlermethode referenziert.

Hinweise

Verwenden Sie dieses Ereignis, um ein Datenobjekt zu untersuchen, bevor die Daten eingefügt werden, und möglicherweise, um eine alternative Vorgehensweise zu wählen, z. B.:

  • Abbrechen des Einfügens – 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 vom zu einfügenden Datenobjekt unterstützt werden.

    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 Objekt zum Einfügen von Daten 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.

Wenn Sie den Inhalt eines Einfügedatenobjekts (DataObject) ändern, 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