DataObject.AddPastingHandler Método

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Adiciona um manipulador de eventos Pasting a um objeto de dependência 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

O objeto de dependência (um UIElement ou ContentElement) ao qual o manipulador de eventos será adicionado.

handler

DataObjectPastingEventHandler

Um delegado que faz referência ao método de manipulador a ser adicionado.

Comentários

Use esse evento para inspecionar um objeto de dados antes que os dados sejam colados e, possivelmente, para decidir sobre um curso de ação alternativo, como:

• Cancele a operação Colar – Cancelar a colagem inteira chamando o CancelCommand método .

• Selecione um Formato Alternativo – Altere o formato de colagem selecionado especificando um novo valor para a FormatToApply propriedade . O formato recém-selecionado deve ter suporte do objeto de dados a ser colado.

  Observação

  Se o formato de colagem for alterado, verifique se o destino de colagem dá suporte ao formato recém-especificado.

• Inserir um Novo Formato – se você determinar que o objeto de dados de colagem não dá suporte ao formato desejado, atualize o objeto de dados para incluir uma versão dos dados no formato desejado. Conversores de dados personalizados geralmente são usados como parte desse processo.

A alteração do conteúdo de um objeto de dados de colagem (DataObject) não altera os dados armazenados na Área de Transferência do sistema; essas alterações serão aplicadas somente ao objeto de dados associado ao comando de colagem associado.

Confira também

• RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)