Compartilhar via


UIElement.Tapped Evento

Definição

Ocorre quando uma interação tap sem tratamento ocorre na área de teste de clique 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 de toque, mouse e caneta podem produzir uma ação Tocar . Para obter mais informações, consulte Entrada de ponteiro de identificador.

Consulte 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 principal do elemento em seu aplicativo.

Um evento Tapped representa um gesto, enquanto um evento PointerPressed é um evento de entrada de nível inferior. Os eventos Tapped e PointerPressed 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 manipulando manipulações, isso não impede que Tapped seja gerado.

Um evento Tapped é 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 você 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 como true para ser uma origem do evento Tapped (true é o padrão). É possível manipular Tapped em elementos pai, mesmo que IsTapEnabled seja false no elemento pai, se o evento estiver em bolhas para um pai de um elemento filho de origem do 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 clique. 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 se os dados do evento estiverem marcados como Manipulados. Consulte AddHandler.

Controles de Windows Runtime específicos também podem ter manipulação baseada em classe para o evento Tapped. 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 Tocada, Segurando ou algum outro gesto, para que você não seja tocado no instante em que um usuário toca 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á gerado primeiro para representar o primeiro toque, mas o segundo toque não gerará um Toque adicional. Se você quiser uma lógica diferente para Tapped versus DoubleTapped, o manipulador Tapped talvez 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 ação Tocada. 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 evento Tapped :

Aplica-se a

Confira também