Поделиться через

структура TOUCHPAD_PARAMETERS (winuser.h)

  • Статья

Важно!

Некоторые сведения относятся к предварительной версии продукта, который может быть существенно изменен до его коммерческого выпуска. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Содержит параметры сенсорной панели пользователя и сведения о системе, связанные со всеми обнаруженными сенсорными паннотами.

Примечание

Термин "сенсорная панель" относится к точным сенсорным паннолам. Термин "устаревшая сенсорная панель" относится к сенсорной панели старшего поколения, которые сообщают о себе в 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

Поддерживаемые функции, о которые сообщили обнаруженные устаревшие сенсорные панели. Это будет LEGACY_TOUCHPAD_FEATURE_NONE , если не обнаружены устаревшие сенсорные панели или если устаревшие сенсорные панели не поддерживают настройку с помощью SPI_SETTOUCHPADPARAMETERS. 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

Комментарии

Все поля применяются только к сенсорной панели Precision, за исключением полей, которые указывают "устаревшую сенсорную панель" или поддерживаются устаревшей сенсорной панелью, как указано в поле legacyTouchpadFeatures .

1 Представляет сведения о системе, которые можно использовать для информирования о том, какие параметры пользователя применимы к текущему устройству. Они игнорируются при вызове SystemParametersInfo (A/W) с SPI_SETTOUCHPADPARAMETERS.

2 Представляет параметры пользователя. Изменение этих полей приведет к изменению параметров пользователя при вызове SystemParametersInfo (A/W) с SPI_SETTOUCHPADPARAMETERS.

Требования

Требование Значение
Минимальная версия клиента Windows 11 версии 24H2 [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Верхняя часть winuser.h (включая Windows.h)

См. также раздел

перечисление TOUCHPAD_SENSITIVITY_LEVEL, LEGACY_TOUCHPAD_FEATURES перечисление