UIElement.Tapped Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica quando si verifica un'interazione tap altrimenti non gestita sull'area di 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
Commenti
I dispositivi touch, mouse e penna possono tutti produrre un'azione Tap . Per altre informazioni, vedere Gestire l'input del puntatore.
Per altre informazioni su come usare un'interazionetap nella progettazione dell'app, vedere Progettazione interazione tocco. L'idea generale è che un'interazione tap su un elemento richiama l'azione primaria dell'elemento nell'app.
Un evento Tapped rappresenta un movimento, mentre un evento PointerPressed è un evento di input di livello inferiore. Gli eventi toccati e PointerPressed possono essere generati come risultato di un'interazione con un singolo utente. Se l'origine evento ha anche un oggetto ManipulationMode non definito, ManipulationStarting può essere generato anche. Anche se un controllo gestisce già PointerPressed nella logica di controllo o gestisce le manipolazioni, che non impedisce l'generazione di Tapped.
Un evento Tapped è potenzialmente il risultato di più punti puntatori. Per gli eventi di movimento di livello superiore, ad esempio Tapped, non si ha più accesso immediato ai dettagli di PointerPoint , ad esempio i singoli valori PointerId o le singole coordinate. È possibile accedere al tipo di dispositivo (PointerDeviceType) e per le coordinate che è possibile chiamare GetPosition, che fornisce una media delle coordinate per un tocco da più di un punto puntatore.
Tapped è un evento instradato. Inoltre, un elemento deve avere IsTapEnabled essere true per essere un'origine evento Tapped (true è l'impostazione predefinita). È possibile gestire Tapped sugli elementi padre anche se IsTapEnabled è false nell'elemento padre, se le bolle di evento a un elemento padre da un elemento figlio dell'origine evento in cui IsTapEnabled è false. Per altre informazioni sul concetto di evento indirizzato, vedere Panoramica degli eventi e degli eventi indirizzati.
Per le azioni touch e anche per gli eventi di manipolazione o specifici dell'interazione che sono conseguenze di un'azione tocco, un elemento deve essere visibile al test per essere l'origine evento. UIElement.Visibility deve essere visibile. Altre proprietà dei tipi derivati influiscono anche sulla visibilità di hit test. Per altre informazioni, vedi Panoramica degli eventi e degli eventi indirizzati.
Toccad 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.
I controlli specifici Windows Runtime possono avere anche la gestione basata sulla classe per l'evento Tapped. In tal caso, il controllo ha probabilmente un override per il metodo OnTapped. Per altre informazioni sulla gestione basata sulla classe per gli eventi, vedere Panoramica degli eventi e degli eventi indirizzati.
Tapped e Holding si escludono a vicenda. Il sistema di input deve attendere fino a quando il punto del puntatore viene rilasciato per determinare se l'azione deve essere Toccata, Tenendo o un altro gesto, in modo che non venga toccato all'istante in cui un utente tocca lo schermo. Se invece hai bisogno di commenti e suggerimenti istantanei, potresti voler usare PointerPressed .
Se un'interazione utente genera anche DoubleTapped, Toccad verrà generato per primo per rappresentare il primo tocco, ma il secondo tocco non genererà un tocco aggiuntivo. Se si desidera una logica diversa per Tapped rispetto a DoubleTapped, il gestore Tapped potrebbe dover usare variabili specifiche dell'app e un timer per evitare l'esecuzione sulle interazioni che vengono infine interpretate come azione DoubleTap .
Toccato per l'input di mouse e penna/stilo
Il sistema di input elabora un'azione in cui l'utente fa clic sul pulsante sinistro del mouse mentre sopra l'elemento come azione toccata. L'evento non viene attivato finché non viene rilasciato il pulsante sinistro del mouse. L'input del mouse non produce eventi di conservazione per impostazione predefinita, indipendentemente dal tempo in cui viene tenuto premuto un pulsante del mouse o il pulsante che viene mantenuto.
Per i dispositivi penna, toccando il dispositivo penna sulla superficie e rimanente in un'unica posizione viene generata un'azione Di blocco .
Controlli che non generano l'evento Tapped
Questi controlli non generano l'evento Tapped :