UIElement.Drop Evento
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.
Ocorre quando o sistema de entrada relata um evento soltar subjacente com esse elemento sendo uma reprodução automática.
public:
virtual event DragEventHandler ^ Drop;// Register
event_token Drop(DragEventHandler const& handler) const;
// Revoke with event_token
void Drop(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::Drop_revoker Drop(auto_revoke_t, DragEventHandler const& handler) const;public event DragEventHandler Drop;function onDrop(eventArgs) { /* Your code */ }
uIElement.addEventListener("drop", onDrop);
uIElement.removeEventListener("drop", onDrop);
- or -
uIElement.ondrop = onDrop;Public Custom Event Drop As DragEventHandler <uiElement Drop="eventhandler"/>
Para Drop que ocorra e invoque um manipulador, o valor de AllowDrop no UIElement que é o destino de soltar e também na origem da ação de arrastar e soltar deve ser true.
Um manipulador típico marcar o valor Data dos dados de evento DragEventArgs.
Você pode iniciar uma ação de arrastar e soltar em qualquer UIElement chamando o método StartDragAsync . Depois que a ação é iniciada, qualquer UIElement um no aplicativo pode ser um destino de soltar, desde que AllowDrop esteja true nesse elemento, e todos os elementos que a ação de arrastar-soltar passar podem manipular DragEnter, DragLeave ou DragOver.
Drop é um evento roteado. Um elemento deve ter AllowDrop como true uma Drop origem do evento. Se o evento tiver permissãoparal para elementos pai porque ele não for tratado, será possível manipular o evento em um elemento pai se AllowDrop estiver true no elemento pai. Elementos intermediários na rota que não são o objeto do manipulador ou o destino de soltar não precisam que AllowDrop seja true. Para obter mais informações sobre o conceito de evento roteado, consulte Visão geral de eventos e eventos roteado.
Para ações de toque, ações de arrastar e soltar e também para eventos específicos de interação ou manipulação que são consequências de uma ação de toque, um elemento deve ser visível para ser a origem do evento e disparar o evento associado à ação. UIElement.Visibility deve ser Visível. Outras propriedades de tipos derivados também afetam a visibilidade do teste de clique, por exemplo , IsEnabled. Para saber mais, confira Visão geral de eventos e eventos roteados.
Drop dá suporte à capacidade de anexar manipuladores de eventos à rota que será invocada mesmo se os dados do evento estiverem marcados como Manipulados. Consulte AddHandler.
Controles de Windows Runtime específicos podem ter tratamento baseado em classe para o Drop evento. Nesse caso, a lógica do controle provavelmente tem uma substituição para o método OnDrop. Normalmente, o evento é marcado como manipulado pelo manipulador de classe e o Drop evento não é gerado para manipulação por nenhum manipulador de código de usuário nesse controle. Para saber mais, confira Visão geral de eventos e eventos roteados.
Independentemente da ocorrência do evento, alguns controles podem usar animações de tema como DragItemThemeAnimation para indicar visualmente um comportamento de arrastar para o usuário.
| Produto | Versões |
|---|---|
| Windows App SDK | 0.8, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6 |