UIElement.Tapped Evento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

Si verifica quando si verifica un'interazione tocco altrimenti non gestita sull'area hit test di questo 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 evento

TappedEventHandler

Commenti

I dispositivi tocco, mouse e penna possono tutti produrre un'azione Tocco . Per altre info, vedi Gestire l'input del puntatore.

Vedi Progettazione dell'interazione tramite tocco per altre info su come usare un'interazione tocco nella progettazione dell'app. L'idea generale è che un'interazione tocco su un elemento richiama l'azione principale dell'elemento nell'app.

Un Tapped evento rappresenta un movimento, mentre un evento PointerPressed è un evento di input di livello inferiore. Tapped gli eventi e PointerPressed possono essere generati come risultato di un'interazione con un singolo utente. Se l'origine evento ha un oggetto ManipulationMode non predefinito, manipulationStarting può essere generato anche. Anche se un controllo gestisce già PointerPressed la logica del controllo o gestisce le manipolazioni, ciò non impedisce Tapped di essere generato.

Un Tapped evento è potenzialmente il risultato di più di un punto di puntatore. Per gli eventi di movimento di livello superiore, Tapped ad esempio non si ha più accesso immediato ai dettagli di PointerPoint , ad esempio singoli valori PointerId o singole coordinate. È possibile accedere al tipo di dispositivo (PointerDeviceType) e per le coordinate è possibile chiamare GetPosition, che fornisce una media delle coordinate per un tocco da più di un punto di puntatore.

Tapped è un evento indirizzato. Inoltre, un elemento deve avere IsTapEnabled essere true un'origine Tapped evento (true è l'impostazione predefinita). È possibile gestire Tapped gli elementi padre anche se IsTapEnabled si trova false nell'elemento padre, se l'evento si trova in un elemento padre da un elemento figlio dell'origine evento dove IsTapEnabled è false. Per altre info sul concetto di evento indirizzato, vedi Panoramica degli eventi e degli eventi indirizzati.

Per le azioni di tocco e anche per gli eventi di manipolazione o specifici dell'interazione che sono conseguenze di un'azione di tocco, un elemento deve essere visibile per essere l'origine evento. UIElement.Visibility deve essere Visibile. Anche altre proprietà dei tipi derivati influiscono sulla visibilità dei hit test. Per altre informazioni, vedi Panoramica degli eventi e degli eventi indirizzati.

Tapped supporta la possibilità di collegare gestori eventi alla route che verrà richiamata anche se i dati dell'evento per l'evento sono contrassegnati come Handled. Vedere AddHandler.

Controlli Windows Runtime specifici possono anche avere una gestione basata su classi per l'eventoTapped. In tal caso, il controllo ha probabilmente un override per il metodo OnTapped. Per altre info sul funzionamento della gestione basata su classi per gli eventi, vedi Panoramica degli eventi e degli eventi indirizzati.

Tapped e Holding si escludono a vicenda. Il sistema di input deve attendere il rilascio del punto di puntatore per determinare se l'azione deve essere Tappedo Holding un altro gesto, quindi non si ottiene Tapped all'istante stesso che un utente tocca lo schermo. Se hai davvero bisogno di feedback istantaneo potresti voler usare PointerPressed .

Se un'interazione dell'utente genera anche DoubleTapped, Tapped verrà generato per primo per rappresentare il primo tocco, ma il secondo tocco non genererà un valore aggiuntivo Tapped. Se si vuole una logica diversa rispetto TappedDoubleTappeda , il Tapped gestore potrebbe dover usare variabili specifiche dell'app e un timer per evitare l'esecuzione su interazioni che vengono infine interpretate come un'azione DoubleTap .

Toccato per l'input tramite mouse e penna/stilo

Il sistema di input elabora un'azione in cui l'utente fa clic sul pulsante sinistro del mouse sopra l'elemento come Tapped azione. L'evento non viene attivato finché non viene rilasciato il pulsante sinistro del mouse. L'input del mouse non produce eventi Holding per impostazione predefinita, indipendentemente dal tempo per cui si tiene premuto un pulsante del mouse o da quale pulsante viene mantenuto.

Per i dispositivi penna, toccare il dispositivo penna sulla superficie e rimanere in un'unica posizione produce un'azione Di blocco .

Controlli che non generano l'evento Tapped

Questi controlli non generano l'evento Tapped :

Si applica a

Vedi anche