UIElement.Tapped Evento

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

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

TappedEventHandler

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 Tapped evento rappresenta un movimento, mentre un evento PointerPressed è un evento di input di livello inferiore. Tapped e PointerPressed gli eventi possono essere generati come risultato di una singola interazione utente. Se l'origine evento ha anche un oggetto ManipulationMode non predefinito, ManipulationStarting può essere generato anche. Anche se un controllo è già in gestione PointerPressed nella logica di controllo o gestisce le manipolazioni, ciò non impedisce Tapped di essere generato.

Un Tapped evento è potenzialmente il risultato di più punti puntatori. Per gli eventi di movimento di livello superiore, ad esempio non è più possibile accedere immediatamente ai dettagli di PointerPoint, ad esempio Tapped singoli valori PointerId o 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 per true essere un'origine Tapped evento (true è l'impostazione predefinita). È possibile gestire Tapped gli elementi padre anche se si trova false nell'elemento padre, se IsTapEnabled l'evento bolle in un elemento padre da un elemento figlio dell'origine eventi 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.

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.

I controlli Windows Runtime specifici possono avere anche la gestione basata sulla classe per l'eventoTapped. 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 La holding si escludono a vicenda. Il sistema di input deve attendere fino al rilascio del punto di puntatore per determinare se l'azione deve essere Tappedo Holding un altro gesto, quindi non si ottiene Tapped 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, verrà generata prima per rappresentare il primo tocco, Tapped ma il secondo tocco non genererà un altro Tappedtocco. Se si desidera una logica diversa rispetto TappedDoubleTappeda , il Tapped gestore potrebbe dover usare variabili specifiche dell'app e un timer per evitare l'esecuzione di 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 supera 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 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 :

Si applica a

Vedi anche