DataObject.AddPastingHandler Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic 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.
