DataObject.AddPastingHandler Metoda

Definicja

Dodaje procedurę Pasting obsługi zdarzeń do określonego obiektu zależności.

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

Obiekt zależności (a UIElement lub ContentElement), do którego ma zostać dodana procedura obsługi zdarzeń.

handler
DataObjectPastingEventHandler

Delegat odwołujący się do metody obsługi do dodania.

Uwagi

To zdarzenie służy do inspekcji obiektu danych przed wklejeniami danych i ewentualnie do podjęcia decyzji o alternatywnym przebiegu akcji, takim jak:

  • Anuluj operację Wklej — anuluj całą operację wklejania, wywołując metodę CancelCommand .

  • Wybierz format alternatywny — zmień wybrany format wklejania, określając nową wartość właściwości FormatToApply . Nowo wybrany format musi być wklejany przez obsługiwany przez obiekt danych.

    Uwaga

    Jeśli format wklejania zostanie zmieniony, upewnij się, że obiekt docelowy wklejania obsługuje nowo określony format.

  • Wstaw nowy format — jeśli określisz, że obiekt danych wklejania nie obsługuje żądanego formatu, zaktualizuj obiekt danych, aby uwzględnić wersję danych w żądanym formacie. Niestandardowe konwertery danych są często używane w ramach tego procesu.

Zmiana zawartości obiektu danych wklejania (DataObject) nie powoduje zmiany danych przechowywanych w schowku systemowym. Wszelkie takie zmiany będą stosowane tylko do obiektu danych skojarzonego ze skojarzonym poleceniem wklejania.

Dotyczy

Zobacz też