structure TOUCHPAD_PARAMETERS (winuser.h)
Important
Certaines informations se rapportent à un produit de préversion qui peut être sensiblement modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Contient les paramètres du pavé tactile utilisateur et les informations système relatives à tous les pavés tactiles détectés.
Notes
Le terme « pavé tactile » fait référence aux pavés tactiles de précision. Le terme « pavé tactile hérité » fait référence aux pavés tactiles d’ancienne génération qui se signalent eux-mêmes sur Windows en tant que souris.
Syntaxe
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;
Membres
versionNumber
Version du struct.
L’appelant doit définir sur TOUCHPAD_PARAMETERS_LATEST_VERSION pour utiliser la dernière version ou pour TOUCHPAD_PARAMETERS_VERSION_[#] pour utiliser une version spécifique (). La version doit être spécifiée lors de la lecture et de l’écriture des paramètres.
Notes
TOUCHPAD_PARAMETERS_VERSION_1 est la seule version spécifique de TOUCHPAD_PARAMETERS_VERSION_[#] actuellement définie.
maxSupportedContacts
Nombre maximal de contacts simultanés (pour le pavé tactile qui prend le plus en charge) parmi tous les pavés tactiles détectés. 1
legacyTouchpadFeatures
Fonctionnalités prises en charge signalées par les pavés tactiles hérités détectés. Cela sera LEGACY_TOUCHPAD_FEATURE_NONE si aucun pavé tactile hérité n’est détecté ou si les pavés tactiles hérités ne prennent pas en charge la configuration via SPI_SETTOUCHPADPARAMETERS. 1
touchpadPresent
Un pavé tactile de précision est détecté. 1
legacyTouchpadPresent
Un pavé tactile hérité est détecté. 1
externalMousePresent
Une souris externe est détectée. Consultez Réglage de précision du pavé tactile pour plus d’informations sur l’exemption de la prise en compte d’une souris comme externe (aux fins de ce champ status et du comportement du paramètre allowActiveWhenMousePresent).1
touchpadEnabled
L’entrée du pavé tactile est activée. 1
touchpadActive
L’entrée du pavé tactile est active. Il est actif s’il est activé, qu’il n’y a pas de souris externe détectée ou qu’une entrée du pavé tactile a été configurée pour rester active malgré la présence d’une souris externe. Ce champ n’indique pas si un pavé tactile produit activement une entrée. 1
feedbackSupported
Un pavé tactile détecté prend en charge les commentaires haptiques. 1
clickForceSupported
Un pavé tactile détecté prend en charge la force de clic haptique. 1
Reserved1
allowActiveWhenMousePresent
L’entrée du pavé tactile peut rester active si une souris externe est détectée. En cas d’inactivité, toute entrée produite par un pavé tactile est ignorée. 2
feedbackEnabled
Les commentaires haptiques sont activés sur les pavés tactiles si pris en charge. 2
tapEnabled
Les appuis à un seul doigt sont activés. 2
tapAndDragEnabled
Appuyez et faites glisser est activé. 2
twoFingerTapEnabled
Appuyez sur deux doigts. 2
rightClickZoneEnabled
Appuyer sur le coin inférieur droit du pavé tactile entraîne un clic droit au lieu d’un clic gauche. 2
Si l’utilisateur a échangé ses boutons gauche et droit de la souris (GetSystemMetrics(SM_SWAPBUTTON) a la valeur true), la zone de clic droit est mise en miroir horizontalement dans le coin inférieur gauche du pavé tactile.
mouseAccelSettingHonored
Le mouvement de la souris produit par le pavé tactile respecte le paramètre d’accélération de la souris de l’utilisateur (spécifié par SystemParametersInfo(SPI_GETMOUSE)). Si la valeur est false, l’accélération est toujours appliquée au mouvement de la souris. 2
panEnabled
Le panoramique à deux doigts est activé. 2
zoomEnabled
Le zoom à deux doigts est activé. 2
scrollDirectionReversed
La direction du contenu défile avec un panoramique à deux doigts est inversée. Par défaut, le mouvement vers le haut des contacts sur le pavé tactile entraîne le défilement du contenu vers le bas, tandis que le mouvement vers la gauche des contacts entraîne un défilement du contenu vers la droite. 2
Reserved2
sensitivityLevel
Niveau de sensibilité du pavé tactile. Plus le pavé tactile est sensible, moins la suppression de la génération d’entrée de souris se produit après l’activité du clavier (voir TOUCHPAD_SENSITIVITY_LEVEL énumération). 2
cursorSpeed
Vitesse à laquelle le mouvement de la souris produit par le pavé tactile déplace le curseur. Les valeurs valides sont comprises entre 1 et 20, inclus. 2
feedbackIntensity
Intensité relative des commentaires haptiques du pavé tactile (si pris en charge). Les valeurs valides sont comprises entre 0 et 100, inclus. 2
clickForceSensitivity
Sensibilité relative de la détection de clic haptique du pavé tactile (si prise en charge). Les valeurs valides sont comprises entre 0 et 100, inclus. 2
rightClickZoneWidth
Largeur relative de la zone de clic droit du pavé tactile. Les valeurs valides sont comprises entre 0 et 100, inclus. Si elle n’est pas égale à zéro, cette valeur remplace la configuration de l’appareil. 2
rightClickZoneHeight
Hauteur relative de la zone de clic droit du pavé tactile. Les valeurs valides sont comprises entre 0 et 100, inclus. Si elle n’est pas égale à zéro, cette valeur remplace la configuration de l’appareil. 2
Remarques
Tous les champs s’appliquent uniquement aux pavés tactiles de précision, à l’exception des champs qui spécifient « pavé tactile hérité » ou qui sont pris en charge par le pavé tactile hérité, comme indiqué par le champ LegacyTouchpadFeatures .
1 Représente les informations système qui peuvent être utilisées pour informer les paramètres utilisateur applicables à l’appareil actuel. Ils sont ignorés lors de l’appel de SystemParametersInfo (A/W) avec SPI_SETTOUCHPADPARAMETERS.
2 Représente les paramètres utilisateur. Les modifications apportées à ces champs entraînent la modification des paramètres de l’utilisateur lors de l’appel de SystemParametersInfo (A/W) avec SPI_SETTOUCHPADPARAMETERS.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 11, version 24H2 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| En-tête | winuser.h (inclure Windows.h) |
Voir aussi
énumération TOUCHPAD_SENSITIVITY_LEVEL, énumération LEGACY_TOUCHPAD_FEATURES