Compartilhar via


UIElement.Tapped Evento

Definição

Ocorre quando ocorre uma interação de toque sem tratamento na área de teste de ocorrência desse elemento.

public:
 virtual event TappedEventHandler ^ Tapped;
// Register
event_token Tapped(TappedEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::Tapped_revoker Tapped(auto_revoke_t, TappedEventHandler const& handler) const;
public event TappedEventHandler Tapped;
function onTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("tapped", onTapped);
uIElement.removeEventListener("tapped", onTapped);
- or -
uIElement.ontapped = onTapped;
Public Custom Event Tapped As TappedEventHandler 
<uiElement Tapped="eventhandler"/>

Tipo de evento

Comentários

Dispositivos touch, mouse e dispositivos de caneta podem produzir uma ação Tocar . Para obter mais informações, consulte Entrada de ponteiro de identificador.

Confira Design de interação por toque para obter mais informações sobre como usar uma interação de toque no design do aplicativo. A ideia geral é que uma interação de toque em um elemento invoque a ação primária do elemento em seu aplicativo.

Um Tapped evento representa um gesto, enquanto um evento PointerPressed é um evento de entrada de nível inferior. Tapped e PointerPressed eventos podem ser gerados como resultado de uma única interação do usuário. Se a origem do evento tiver um ManipulationMode não padrão, ManipulationStarting também poderá ser gerado. Mesmo que um controle já esteja tratando PointerPressed na lógica de controle ou esteja tratando manipulações, isso não impede Tapped que seja gerado.

Um Tapped evento é potencialmente o resultado de mais de um ponto de ponteiro. Para os eventos de gesto de nível superior, como Tapped você, não tem mais acesso imediato aos detalhes do PointerPoint , como valores de PointerId individuais ou coordenadas individuais. Você tem acesso ao tipo de dispositivo (PointerDeviceType) e, para coordenadas, pode chamar GetPosition, o que fornece uma média das coordenadas para um Toque de mais de um ponto de ponteiro.

Tapped é um evento roteado. Além disso, um elemento deve ter IsTapEnabled para ser true uma Tapped fonte de evento (true é o padrão). É possível lidar com Tapped elementos pai mesmo que IsTapEnabled esteja false no elemento pai, se o evento bolhas para um pai de um elemento filho de origem de evento em que IsTapEnabled é false. 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 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. UIElement.Visibility deve ser Visível. Outras propriedades de tipos derivados também afetam a visibilidade do teste de ocorrência. Para saber mais, confira Visão geral de eventos e eventos roteados.

Tapped dá suporte à capacidade de anexar manipuladores de eventos à rota que será invocada mesmo que os dados do evento sejam marcados como Manipulados. Consulte AddHandler.

Controles Windows Runtime específicos também podem ter manipulação baseada em classe para o Tapped evento. Nesse caso, o controle provavelmente tem uma substituição para o método OnTapped. Para obter mais informações sobre como funciona o tratamento baseado em classe para eventos, consulte Visão geral de eventos e eventos roteado.

Tapped e Holding são mutuamente exclusivos. O sistema de entrada deve aguardar até que o ponto de ponteiro seja liberado para determinar se a ação deve ser Tappedou Holding algum outro gesto, para que você não obtenha Tapped no instante em que um usuário toque na tela. Se você realmente precisar de comentários instantâneos, talvez queira usar PointerPressed .

Se uma interação do usuário também gerar DoubleTapped, Tapped será acionada primeiro para representar o primeiro toque, mas o segundo toque não gerará um adicional Tapped. Se você quiser uma lógica diferente para Tapped versus DoubleTapped, talvez o Tapped manipulador precise usar variáveis específicas do aplicativo e um temporizador para evitar a execução em interações que eventualmente são interpretadas como uma ação DoubleTap .

Tocado para entrada de mouse e caneta/caneta

O sistema de entrada processa uma ação em que o usuário clica no botão esquerdo do mouse enquanto está sobre o elemento como uma Tapped ação. O evento não é acionado até que o botão esquerdo do mouse seja liberado. A entrada do mouse não produz eventos holding por padrão, independentemente de quanto tempo um botão do mouse é mantido pressionado ou qual botão é mantido.

Para dispositivos de caneta, tocar o dispositivo de caneta na superfície e permanecer em um só lugar produz uma ação De espera.

Controles que não geram o evento Tapped

Esses controles não geram o Tapped evento:

Aplica-se a

Confira também