SetInertiaParameterInteractionContext function

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

Syntax


HRESULT WINAPI SetInertiaParameterInteractionContext(
  _In_  HINTERACTIONCONTEXT interactionContext,
  _In_  INERTIA_PARAMETER inertiaParameter,
  _In_  float value
);

Parameters

interactionContext [in]

The handle of the interaction context.

inertiaParameter [in]

One of the constants from INERTIA_PARAMETER.

value [in]

One of the following:

  • The rate of deceleration, in radians/ms2.
  • For translation, the relative change in screen location, in HIMETRIC units.
  • For rotation, the relative change in angle of rotation, in radianx
  • 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

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

None supported

Header

Interactioncontext.h

Library

Ninput.lib

DLL

Ninput.dll

See also

Interaction Context Functions
HINTERACTIONCONTEXT
GetInertiaParameterInteractionContext

 

 

Community Additions

ADD
Show:
© 2014 Microsoft