UIElement.DoubleTapped Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Occurs when an otherwise unhandled DoubleTap interaction occurs over the hit test area of this element.
public:
virtual event DoubleTappedEventHandler ^ DoubleTapped;
// Register
event_token DoubleTapped(DoubleTappedEventHandler const& handler) const;
// Revoke with event_token
void DoubleTapped(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::DoubleTapped_revoker DoubleTapped(auto_revoke_t, DoubleTappedEventHandler const& handler) const;
public event DoubleTappedEventHandler DoubleTapped;
function onDoubleTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("doubletapped", onDoubleTapped);
uIElement.removeEventListener("doubletapped", onDoubleTapped);
- or -
uIElement.ondoubletapped = onDoubleTapped;
Public Custom Event DoubleTapped As DoubleTappedEventHandler
<uiElement DoubleTapped="eventhandler"/>
Event Type
Remarks
A DoubleTap interaction is simply two Tap interactions that occur in quick succession. The exact timing of what the system interprets as a double tap is adjustable by users through system settings.
See Touch interaction design for more info on how to use a DoubleTap interaction in your app design.
If a user interaction also fires DoubleTapped
, Tapped will fire first to represent the first tap, but the second tap won't fire an additional Tapped
. If you want different logic for Tapped
versus DoubleTapped
, your Tapped
handler may need to use app-specific variables and a timer in order to avoid running on interactions that are eventually interpreted as a DoubleTap action.
A DoubleTapped
event represents a gesture, whereas a PointerPressed event is a lower-level input event. DoubleTapped
and PointerPressed
events can fire as the result of a single user interaction. Even if a control is already handling pointer events in the control logic, or is handling manipulations, that doesn't prevent DoubleTapped
from firing.
A DoubleTapped
event is potentially the result of more than one pointer point. For the higher-level gesture events like DoubleTapped
you no longer have immediate access to PointerPoint details such as individual PointerId values or individual coordinates. You do have access to device type (PointerDeviceType) and for coordinates you can call GetPosition, which gives an average of the coordinates for a DoubleTap from more than one pointer point.
DoubleTapped
is a routed event. Also, an element must have IsDoubleTapEnabled be true
to be a DoubleTapped
event source (true
is the default). It is possible to handle DoubleTapped
on parent elements even if IsDoubleTapEnabled
is false
on the parent element, if the event bubbles to a parent from an event source child element where IsDoubleTapEnabled
is false
. For more info on the routed event concept, see Events and routed events overview.
For touch actions and also for interaction-specific or manipulation events that are consequences of a touch action, an element must be hit-test visible in order to be the event source and fire the event that is associated with the action. UIElement.Visibility must be Visible. Other properties of derived types also affect hit-test visibility. For more info, see Events and routed events overview.
DoubleTapped
supports the ability to attach event handlers to the route that will be invoked even if the event data for the event is marked Handled. See AddHandler.
Specific Windows Runtime controls may have class-based handling for the DoubleTapped
input event. If so, the control probably has an override for the method OnDoubleTapped. Typically the event is marked handled by the class handler, and the DoubleTapped
event is not raised for handling by any user code handlers on that control. For more info on how class-based handling for events works, see Events and routed events overview.