TOUCHPAD_PARAMETERS structure (winuser.h)

Contains user touchpad settings and system information related to all detected touchpads.

Syntax

typedef struct TOUCHPAD_PARAMETERS {
  UINT                       versionNumber;
  UINT                       maxSupportedContacts;
  LEGACY_TOUCHPAD_FEATURES   legacyTouchpadFeatures;
  BOOL                       touchpadPresent : 1;
  BOOL                       legacyTouchpadPresent : 1;
  BOOL                       externalMousePresent : 1;
  BOOL                       touchpadEnabled : 1;
  BOOL                       touchpadActive : 1;
  BOOL                       feedbackSupported : 1;
  BOOL                       clickForceSupported : 1;
  BOOL                       Reserved1 : 25;
  BOOL                       allowActiveWhenMousePresent : 1;
  BOOL                       feedbackEnabled : 1;
  BOOL                       tapEnabled : 1;
  BOOL                       tapAndDragEnabled : 1;
  BOOL                       twoFingerTapEnabled : 1;
  BOOL                       rightClickZoneEnabled : 1;
  BOOL                       mouseAccelSettingHonored : 1;
  BOOL                       panEnabled : 1;
  BOOL                       zoomEnabled : 1;
  BOOL                       scrollDirectionReversed : 1;
  BOOL                       Reserved2 : 22;
  TOUCHPAD_SENSITIVITY_LEVEL sensitivityLevel;
  UINT                       cursorSpeed;
  UINT                       feedbackIntensity;
  UINT                       clickForceSensitivity;
  UINT                       rightClickZoneWidth;
  UINT                       rightClickZoneHeight;
} TOUCHPAD_PARAMETERS, *PTOUCH_PAD_PARAMETERS, TOUCHPAD_PARAMETERS_V1, *PTOUCHPAD_PARAMETERS_V1;

Members

versionNumber

The version of the struct.

Caller must set to TOUCHPAD_PARAMETERS_LATEST_VERSION to use the latest version, or to TOUCHPAD_PARAMETERS_VERSION_[#] to use a specific version (). The version must be specified when both reading and writing settings.

maxSupportedContacts

The maximum number of simultaneous contacts (for the touchpad that supports the most) amongst all detected touchpads.¹

legacyTouchpadFeatures

The supported features reported by detected legacy touchpads. This will be LEGACY_TOUCHPAD_FEATURE_NONE if no legacy touchpads are detected, or if the legacy touchpads do not support configuration through SPI_SETTOUCHPADPARAMETERS.¹

touchpadPresent

A Precision Touchpad is detected.¹

legacyTouchpadPresent

A legacy touchpad is detected.¹

externalMousePresent

An external mouse is detected. See Precision touchpad tuning for information on exempting a mouse from being considered as external (for the purposes of this status field and behavior of the allowActiveWhenMousePresent setting).¹

touchpadEnabled

Touchpad input is enabled.¹

touchpadActive

Touchpad input is active. It is active if it is enabled, and either there is no external mouse detected or touchpad input has been configured to stay active despite the presence of an external mouse. This field does not indicate whether any touchpad is actively producing input.¹

feedbackSupported

A detected touchpad supports haptic feedback.¹

clickForceSupported

A detected touchpad supports haptic click force.¹

Reserved1

allowActiveWhenMousePresent

Touchpad input can remain active if an external mouse is detected. When inactive, any input produced by a touchpad is ignored.²

feedbackEnabled

Haptic feedback is enabled on touchpads if supported.²

tapEnabled

Single-finger taps are enabled.²

tapAndDragEnabled

Tap-and-drag is enabled.²

twoFingerTapEnabled

Two-finger tap is enabled.²

rightClickZoneEnabled

Pressing the bottom-right corner of the touchpad results in a right-click instead of a left click.²

If the user has swapped their left and right mouse buttons (GetSystemMetrics(SM_SWAPBUTTON) is true), the right-click zone is mirrored horizontally to the bottom-left corner of the touchpad.

mouseAccelSettingHonored

Mouse motion produced by the touchpad honors the user's mouse acceleration setting (specified by SystemParametersInfo(SPI_GETMOUSE)). If false, the mouse motion always has acceleration applied.²

panEnabled

Two-finger panning is enabled.²

zoomEnabled

Two-finger zooming is enabled.²

scrollDirectionReversed

The direction content scrolls with two-finger panning is reversed. By default, the upward motion of contacts on the touchpad results in content scrolling downward while leftward motion of contacts results in content scrolling rightwards.²

Reserved2

sensitivityLevel

The touchpad sensitivity level. The more sensitive the touchpad, the less suppression of mouse input generation occurs after keyboard activity (see TOUCHPAD_SENSITIVITY_LEVEL enumeration).²

cursorSpeed

The rate at which the mouse motion produced by the touchpad moves the cursor. Valid values are 1-20, inclusive.²

feedbackIntensity

The relative intensity of the touchpad's haptic feedback (if supported). Valid values are 0-100, inclusive.²

clickForceSensitivity

The relative sensitivity of the touchpad's haptic click detection (if supported). Valid values are 0-100, inclusive.²

rightClickZoneWidth

The relative width of the touchpad right-click zone. Valid values are 0-100, inclusive. If non-zero, this value overrides the device configuration.²

rightClickZoneHeight

The relative height of the touchpad right-click zone. Valid values are 0-100, inclusive. If non-zero, this value overrides the device configuration.²

Remarks

All fields apply only to Precision Touchpads, with the exception of fields that specify "legacy touchpad" or are supported by the legacy touchpad as indicated by the legacyTouchpadFeatures field.

¹ Represents the system information that can be used to help inform which user settings are applicable to the current device. They are ignored when calling SystemParametersInfo (A/W) with SPI_SETTOUCHPADPARAMETERS.

² Represents user settings. Modifications to these fields will result in changing the user's settings when calling SystemParametersInfo (A/W) with SPI_SETTOUCHPADPARAMETERS.

Requirements

See also

TOUCHPAD_SENSITIVITY_LEVEL enumeration, LEGACY_TOUCHPAD_FEATURES enumeration