UIElement.DragOver Evento
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.
Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com esse elemento como o destino de queda potencial.
public:
virtual event DragEventHandler ^ DragOver;// Register
event_token DragOver(DragEventHandler const& handler) const;
// Revoke with event_token
void DragOver(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::DragOver_revoker DragOver(auto_revoke_t, DragEventHandler const& handler) const;public event DragEventHandler DragOver;function onDragOver(eventArgs) { /* Your code */ }
uIElement.addEventListener("dragover", onDragOver);
uIElement.removeEventListener("dragover", onDragOver);
- or -
uIElement.ondragover = onDragOver;Public Custom Event DragOver As DragEventHandler <uiElement DragOver="eventhandler"/>
Tipo de evento
Comentários
Para DragOver ocorrer, o valor de AllowDrop no UIElement atual e na origem do evento deve ser true. Caso contrário, considere usar PointerMoved.
Você pode iniciar uma ação de arrastar-soltar em qualquer UIElement chamando o método StartDragAsync . Depois que a ação for iniciada, qualquer UIElement um no aplicativo poderá ser um destino de descarte, desde que AllowDrop esteja true nesse elemento. Todos os elementos passados pela ação de arrastar-soltar podem manipular DragEnter, DragLeave ou DragOver.
DragOver é um evento roteado. Para obter mais informações sobre o conceito de evento roteado, consulte Eventos e visão geral de 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 hit-test, por exemplo , IsEnabled. Para saber mais, confira Visão geral de eventos e eventos roteados.
DragOver 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 Windows Runtime específicos podem ter tratamento baseado em classe para o DragOver evento. Nesse caso, o controle provavelmente terá uma substituição para o método OnDragOver. Normalmente, o evento é marcado como manipulado pelo manipulador de classe e o DragOver 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.