通过

winuser.h) (TOUCHPAD_PARAMETERS 结构

  • 项目

重要

某些信息与预发行产品相关，该产品在商业发布之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

包含与所有检测到的触摸板相关的用户触摸板设置和系统信息。

注意

术语“触摸板”是指精确式触摸板。 术语“旧式触摸板”是指以鼠标的形式向 Windows 报告自己的旧一代触摸板。

语法

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;

成员

versionNumber

结构的版本。

调用方必须设置为 TOUCHPAD_PARAMETERS_LATEST_VERSION 才能使用最新版本，或设置为 TOUCHPAD_PARAMETERS_VERSION_[#] 以使用特定版本 () 。 在读取和写入设置时，必须指定版本。

注意

TOUCHPAD_PARAMETERS_VERSION_1是当前定义的唯一特定版本的 TOUCHPAD_PARAMETERS_VERSION_[#]。

maxSupportedContacts

支持所有检测到的触摸板中最多) 的触摸板 (的最大同时触点数。1

legacyTouchpadFeatures

检测到的旧式触摸板报告的受支持功能。 如果未检测到旧式触摸板，或者旧式触摸板不支持通过SPI_SETTOUCHPADPARAMETERS进行配置，则会LEGACY_TOUCHPAD_FEATURE_NONE。1

touchpadPresent

检测到精确式触摸板。1

legacyTouchpadPresent

检测到旧式触摸板。1

externalMousePresent

检测到外部鼠标。 请参阅 精确式触摸板优化 ，了解如何将此状态字段和 allowActiveWhenMousePresent 设置) 的行为免除鼠标视为外部 (。1

touchpadEnabled

启用触摸板输入。1

touchpadActive

触摸板输入处于活动状态。 如果已启用，则它处于活动状态，并且未检测到外部鼠标，或者已将触摸板输入配置为尽管存在外部鼠标而保持活动状态。 此字段不指示是否有任何触摸板正在主动生成输入。1

feedbackSupported

检测到的触摸板支持触觉反馈。1

clickForceSupported

检测到的触摸板支持触觉单击力。1

Reserved1

allowActiveWhenMousePresent

如果检测到外部鼠标，触摸板输入可以保持活动状态。 处于非活动状态时，将忽略触摸板生成的任何输入。2

feedbackEnabled

如果支持，则会在触摸板上启用触觉反馈。2

tapEnabled

启用单指点击。2

tapAndDragEnabled

已启用点击并拖动。2

twoFingerTapEnabled

已启用双指点击。2

rightClickZoneEnabled

按触摸板的右下角会导致右键单击而不是左键单击。2

如果用户交换了鼠标左键和右键 (GetSystemMetrics (SM_SWAPBUTTON) 为 true) ，则右键单击区域水平镜像到触摸板左下角。

mouseAccelSettingHonored

触摸板生成的鼠标运动遵循由 SystemParametersInfo (SPI_GETMOUSE) ) 指定的用户鼠标加速设置 (。 如果为 false，则始终应用了鼠标运动加速。2

panEnabled

已启用双指平移。2

zoomEnabled

已启用双指缩放。2

scrollDirectionReversed

两指平移的内容滚动方向将相反。 默认情况下，触摸板上触点的向上运动会导致内容向下滚动，而接触点的向左运动会导致内容向右滚动。2

Reserved2

sensitivityLevel

触摸板敏感度级别。 触摸板越敏感，在键盘活动 (看到TOUCHPAD_SENSITIVITY_LEVEL 枚举) 之后，鼠标输入生成的抑制就越少。2

cursorSpeed

触摸板产生的鼠标运动移动光标的速率。 有效值为 1-20（含）。2

feedbackIntensity

如果) 支持，触摸板触觉反馈的相对强度 (。 有效值为 0-100（含）。2

clickForceSensitivity

如果支持) ，触摸板的触觉单击检测的相对敏感度 (。 有效值为 0-100（含）。2

rightClickZoneWidth

触摸板右键单击区域的相对宽度。 有效值为 0-100（含）。 如果为非零，此值将替代设备配置。2

rightClickZoneHeight

触摸板右键单击区域的相对高度。 有效值为 0-100（含）。 如果为非零，此值将替代设备配置。2

注解

所有字段仅适用于精确式触摸板，但指定“旧式触摸板”或旧式触摸板支持的字段除外，如 旧式TouchpadFeatures 字段所示。

1 表示可用于帮助通知哪些用户设置适用于当前设备的系统信息。 使用 SPI_SETTOUCHPADPARAMETERS (A/W) 调用 SystemParametersInfo 时，将忽略它们。

2 表示用户设置。 对这些字段的修改将导致在使用 SPI_SETTOUCHPADPARAMETERS 调用 SystemParametersInfo (A/W) 时更改用户的设置。

要求

要求 值
最低受支持的客户端 Windows 11版本 24H2 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
标头 winuser.h (包括 Windows.h)

另请参阅

TOUCHPAD_SENSITIVITY_LEVEL 枚举、LEGACY_TOUCHPAD_FEATURES 枚举