DataObject.AddPastingHandler Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute un gestionnaire d’événements Pasting à un objet de dépendance spécifié.
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)
Paramètres
- element
- DependencyObject
Objet de dépendance (UIElement ou ContentElement) auquel ajouter le gestionnaire d’événements.
- handler
- DataObjectPastingEventHandler
Délégué qui fait référence à la méthode de gestionnaire à ajouter.
Remarques
Utilisez cet événement pour inspecter un objet de données avant que les données ne sont collées, et éventuellement pour décider d’un autre plan d’action, par exemple :
Annuler le collage : annulez l’intégralité de l’opération de collage en appelant la CancelCommand méthode .
Sélectionner un autre format : modifiez le format de collage sélectionné en spécifiant une nouvelle valeur pour la FormatToApply propriété . Le format nouvellement sélectionné doit être pris en charge par l’objet de données à coller.
Notes
Si le format de collage est modifié, vérifiez que la cible de collage prend en charge le format nouvellement spécifié.
Insérer un nouveau format : si vous déterminez que l’objet coller des données ne prend pas en charge le format souhaité, mettez à jour l’objet de données pour inclure une version des données dans le format souhaité. Les convertisseurs de données personnalisés sont souvent utilisés dans le cadre de ce processus.
La modification du contenu d’un objet de données coller (DataObject) ne modifie pas les données stockées dans le Presse-papiers système ; ces modifications s’appliquent uniquement à l’objet de données associé à la commande coller associée.