Compartilhar via


DataObject.AddPastingHandler Método

Definição

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.

Aplica-se a

Confira também