Compartilhar via


UIElement.DragEnter Evento

Definição

Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com esse elemento como o destino.

public:
 virtual event DragEventHandler ^ DragEnter;
// Register
event_token DragEnter(DragEventHandler const& handler) const;

// Revoke with event_token
void DragEnter(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::DragEnter_revoker DragEnter(auto_revoke_t, DragEventHandler const& handler) const;
public event DragEventHandler DragEnter;
function onDragEnter(eventArgs) { /* Your code */ }
uIElement.addEventListener("dragenter", onDragEnter);
uIElement.removeEventListener("dragenter", onDragEnter);
- or -
uIElement.ondragenter = onDragEnter;
Public Custom Event DragEnter As DragEventHandler 
<uiElement DragEnter="eventhandler"/>

Tipo de evento

Comentários

Para que um DragEnter evento ocorra, o valor de AllowDrop no UIElement atual e na origem do evento deve ser true. Caso contrário, considere usar PointerEntered.

Você pode iniciar uma ação de arrastar e 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 soltar, desde que AllowDrop esteja true nesse elemento. Todos os elementos passados pela ação de arrastar e soltar podem manipular DragEnter, DragLeave ou DragOver.

DragEnter é um evento roteado. 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.

DragEnter 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 DragEnter evento. Nesse caso, o controle provavelmente tem uma substituição para o método OnDragEnter. Normalmente, o evento é marcado como manipulado pelo manipulador de classe e o DragEnter 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.

Aplica-se a

Confira também