Espandi Riduci a icona

UIElement.Tapped Event

Si verifica quando un'interazione Tap altrimenti non gestita si verifica sopra l'area di hit test dell'elemento.

Sintassi


public event TappedEventHandler Tapped


<uiElement Tapped="eventhandler"/>

Informazioni sull'evento

Delegato TappedEventHandler

Note

Il tocco, i mouse e i dispositivi penna possono generare tutti un'azione Tap. Per ulteriori informazioni, vedere Guida introduttiva: Input del tocco.

Vedere Progettazione delle interazioni tramite tocco per ulteriori informazioni su come utilizzare un'interazione Tap nella progettazione dell'applicazione. L'idea generale suggerisce che un'interazione di Tap su un elemento richiama l'azione principale dell'elemento nell'applicazione.

Un evento Tapped rappresenta un movimento, mentre un evento PointerPressed è un evento di input a livello inferiore. Gli eventi Tapped e PointerPressed possono essere generati come conseguenza di una singola interazione utente. Se l'origine evento ha ManipulationMode non predefinito, anche ManipulationStarting può essere generato. Anche se tramite un controllo vengono già gestiti eventi PointerPressed nella logica di controllo, o vengono gestite le modifiche, ciò non impedisce la generazione di eventi Tapped.

Un evento Tapped è probabilmente il risultato di più di un punto del puntatore. Per gli eventi di spostamento di primo livello come Tapped non si ha accesso diretto ai dettagli di PointerPoint come valori PointerId dell'utente o coordinate dell'utente. È possibile accedere al tipo di dispositivo (PointerDeviceType) e per le coordinate è possibile chiamare GetPosition, che fornisce una media delle coordinate per Tap da più di un punto del puntatore.

Tapped è un evento indirizzato. Inoltre l'oggetto IsTapEnabled di un elemento deve essere true per essere un'origine dell'evento Tapped (true è l'impostazione predefinita). È possibile gestire Tapped sugli elementi padre anche se IsTapEnabled è false sull'elemento padre, se l'evento si propaga a un elemento padre da un elemento figlio di origine evento in cui IsTapEnabled è false. Per ulteriori informazioni sul concetto di eventi indirizzati, vedere la sezione Panoramica degli eventi e eventi indirizzati.

Per le azioni tocco e anche per eventi specifici dell'interazione o di modifica che sono conseguenze di un'azione tocco, un elemento deve essere visibile a livello di hit testing per essere l'origine eventi. UIElement.Visibility deve essere Visible. Altre proprietà dei tipi derivati influiscono anche sulla visibilità dell'hit testing. Per ulteriori informazioni, vedere la sezione Eventi di input e hit testing.

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

I controlli specifici di Windows Runtime possono inoltre avere una gestione basata su classi per l'evento Tapped. In questo caso, il controllo presenterà probabilmente un override per il metodo OnTapped. Per ulteriori informazioni sulla modalità di funzionamento della gestione di eventi basata su classi, vedere la sezione Gestori eventi di input nei controlli.

Tapped e Holding si escludono a vicenda. Il sistema di input deve attendere fino al rilascio del puntatore per determinare se l'azione deve essere Tapped, Holding o un altro tipo di spostamento, pertanto non si ottiene Tapped proprio nel momento in cui un utente tocca lo schermo. Se è effettivamente necessario il feedback istantaneo è possibile invece utilizzare PointerPressed.

Se l'interazione di un utente genera anche DoubleTapped, Tapped verrà generato prima per rappresentare il primo tocco, mentre il secondo tocco non genererà un Tapped aggiuntivo. Se si desidera una logica diversa per Tapped rispetto a DoubleTapped, il gestore Tapped può dover utilizzare le variabili specifiche dell'applicazione e un timer per evitare l'esecuzione sulle interazioni che verranno interpretate come un'azione di DoubleTap.

Tapped per l'input del mouse e della penna/stilo

Il sistema di input elabora un'azione in cui l'utente fa clic con il pulsante sinistro del mouse mentre si trova sull'elemento come un'azione Tapped. L'evento non viene generato fino al rilascio del pulsante sinistro del mouse. Per impostazione predefinita, l'input del mouse non genera eventi Holding, indipendentemente dalla durata della pressione del pulsante del mouse o da quale pulsante viene tenuto premuto.

Per i dispositivi penna, toccando il dispositivo penna sulla superficie e rimanendo in un'unica posizione viene prodotta un'azione di Hold.

Requisiti

Client supportato minimo

Windows 8

Server supportato minimo

Windows Server 2012

Spazio dei nomi

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Metadati

Windows.winmd

Vedere anche

UIElement
IsTapEnabled
PointerPressed
DoubleTapped
Guida introduttiva sull'input del tocco
Esempio di eventi di input utente XAML

 

 

Mostra:
© 2015 Microsoft