Edit

Share via

GetPropertyInteractionContext function (interactioncontext.h)

  • Article

Gets Interaction Context object properties.

Syntax

HRESULT GetPropertyInteractionContext(
  [in]  HINTERACTIONCONTEXT          interactionContext,
  [in]  INTERACTION_CONTEXT_PROPERTY contextProperty,
  [out] UINT32                       *value
);

Parameters

[in] interactionContext

Handle to the Interaction Context object.

[in] contextProperty

One of the constants identified by INTERACTION_CONTEXT_PROPERTY enumeration.

[out] value

The value of the property.

Valid values for contextProperty are:
INTERACTION_CONTEXT_PROPERTY_MEASUREMENT_UNITS_HIMETRIC
0		 Measurement units are HIMETRIC units (0.01 mm).
INTERACTION_CONTEXT_PROPERTY_MEASUREMENT_UNITS_SCREEN
1		 Measurement units are screen pixels. This is the default value.
INTERACTION_CONTEXT_PROPERTY_UI_FEEDBACK_OFF
0		 Visual feedback for user interactions is disabled (the caller is responsible for displaying visual feedback). For more info, see GetWindowFeedbackSetting function and SetWindowFeedbackSetting function
INTERACTION_CONTEXT_PROPERTY_UI_FEEDBACK_ON
1		 Visual feedback for user interactions is enabled. This is the default value. For more info, see GetWindowFeedbackSetting function and SetWindowFeedbackSetting function.
INTERACTION_CONTEXT_PROPERTY_FILTER_POINTERS_OFF
0		 Pointer filtering is disabled (all pointer input data is processed).
INTERACTION_CONTEXT_PROPERTY_FILTER_POINTERS_ON
1		 Pointer filtering is enabled (only pointers specified through the AddPointerInteractionContext function are processed). This is the default value.

Return value

If this function succeeds, it returns S_OK.

Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header interactioncontext.h
Library Ninput.lib
DLL Ninput.dll

See also

SetPropertyInteractionContext function