SetInertiaParameterInteractionContext function (interactioncontext.h)

Configures the inertia behavior of a manipulation (translation, rotation, scaling) after the contact is lifted.

Syntax

HRESULT SetInertiaParameterInteractionContext(
 [in] HINTERACTIONCONTEXT interactionContext,
 [in] INERTIA_PARAMETER inertiaParameter,
 [in] float value
);

Parameters

[in] interactionContext

The handle of the interaction context.

[in] inertiaParameter

One of the constants from INERTIA_PARAMETER enumeration.

[in] value

One of the following:

• The rate of deceleration, in radians/ms².
• For translation, the relative change in screen location, in HIMETRIC units.
• For rotation, the relative change in angle of rotation, in radians.
• For scaling, the relative change in size, in HIMETRIC units.

Return value

If this function succeeds, it returns S_OK.

Otherwise, it returns an HRESULT error code.

Remarks

Interaction Context uses the inertia system setting for all manipulations (translation, rotation, scaling). This function overrides the system setting.

To restore the system setting, set value to INERTIA_PARAMETER_INVALID_VALUE (FLT_MAX).

Requirements

See also

GetInertiaParameterInteractionContext function