DataObject.AddPastingHandler Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationCore.dll

Přidá obslužnou rutinu Pasting události do zadaného objektu závislosti.

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)

Parametry

element

DependencyObject

Objekt závislosti (a UIElement nebo ContentElement), do kterého chcete přidat obslužnou rutinu události.

handler

DataObjectPastingEventHandler

Delegát, který odkazuje na metodu obslužné rutiny přidat.

Poznámky

Tato událost slouží ke kontrole datového objektu před vložením dat a případně k rozhodnutí o alternativním průběhu akce, například:

• Zrušení vložení – Zrušení celé operace vložení voláním CancelCommand metody.

• Vyberte alternativní formát – změňte vybraný formát vložení zadáním nové hodnoty vlastnosti FormatToApply . Nově vybraný formát musí být podporován datovým objektem, který má být vložen.

  Poznámka:

  Pokud se formát vložení změní, ujistěte se, že cíl vložení podporuje nově zadaný formát.

• Vložení nového formátu – Pokud zjistíte, že datový objekt pro vložení požadovaný formát nepodporuje, aktualizujte datový objekt tak, aby obsahoval verzi dat v požadovaném formátu. V rámci tohoto procesu se často používají vlastní převaděče dat.

Změna obsahu datového objektu vložení (DataObject) nemění data uložená v systémové schránce. Všechny tyto změny budou platit pouze pro datový objekt přidružený k přidruženému příkazu pro vložení.

Viz také

• RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)