DataObject.AddPastingHandler Método

Definición

Agrega un controlador de eventos Pasting a un objeto de dependencia especificado.

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)

Parámetros

element
DependencyObject

Objeto de dependencia (UIElement o ContentElement) al que se va a agregar el controlador de eventos.

handler
DataObjectPastingEventHandler

Delegado que hace referencia al método del controlador que se va a agregar.

Comentarios

Use este evento para inspeccionar un objeto de datos antes de pegar los datos y, posiblemente, decidir un curso de acción alternativo, como:

  • Cancele la operación pegar: cancele toda la operación de pegado llamando al CancelCommand método .

  • Seleccione un formato alternativo : cambie el formato de pegado seleccionado especificando un nuevo valor para la FormatToApply propiedad . El formato recién seleccionado debe ser compatible con el objeto de datos que se va a pegar.

    Nota

    Si se cambia el formato de pegado, asegúrese de que el destino de pegado admite el formato recién especificado.

  • Insertar un nuevo formato : si determina que el objeto de datos de pegado no admite el formato deseado, actualice el objeto de datos para incluir una versión de los datos en el formato deseado. Los convertidores de datos personalizados se suelen usar como parte de este proceso.

Cambiar el contenido de un objeto de datos de pegado (DataObject) no cambia los datos almacenados en el Portapapeles del sistema; estos cambios solo se aplicarán al objeto de datos asociado al comando de pegado asociado.

Se aplica a

Consulte también