UIElement.ManipulationInertiaStarting UIElement.ManipulationInertiaStarting UIElement.ManipulationInertiaStarting UIElement.ManipulationInertiaStarting Event

Definition

Occurs when the input device loses contact with the UIElement object during a manipulation and inertia begins.

public : event ManipulationInertiaStartingEventHandler ManipulationInertiaStarting
// Register
event_token ManipulationInertiaStarting(ManipulationInertiaStartingEventHandler const& handler) const;

// Revoke with event_token
void ManipulationInertiaStarting(event_token const& cookie) const;

// Revoke with event_revoker
ManipulationInertiaStarting_revoker ManipulationInertiaStarting(auto_revoke_t, ManipulationInertiaStartingEventHandler const& handler) const;
public event ManipulationInertiaStartingEventHandler ManipulationInertiaStarting
Public Event ManipulationInertiaStarting As ManipulationInertiaStartingEventHandler
<uiElement ManipulationInertiaStarting="eventhandler"/>

Remarks

For custom controls and interaction experiences, see GestureRecognizer.ManipulationInertiaStarting.

An element must have a ManipulationMode value other than None or System to be a manipulation event source. The default value of ManipulationMode is System, which enables built-in control logic to process manipulations, but doesn't permit app code to handle manipulation events. If you want to handle manipulations, set ManipulationMode to All, or to specific ManipulationModes values. For more info, see ManipulationMode.

ManipulationInertiaStarting is a routed event. If the event is permitted to bubble up to parent elements because it goes unhandled, then it is possible to handle the event on parent elements even if ManipulationMode is None or System on the parent element. 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.

ManipulationInertiaStarting 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.

Windows 8 behavior

Windows 8 doesn't fire ManipulationCompleted in cases where the inertial phase has started (and ManipulationInertiaStarting has fired) but the user has tapped on the item before it's finished scrolling, which cancels the inertial phase visually. The issue is fixed starting with Windows 8.1; ManipulationCompleted is fired as soon as the tap action cancels the inertial phase.

Apps that were compiled for Windows 8 but running on Windows 8.1 continue to use the Windows 8 behavior.

See also