TOUCHPAD_PARAMETERS struttura (winuser.h)
Importante
Alcune informazioni si riferiscono a un prodotto di versione preliminare che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Contiene le impostazioni del touchpad utente e le informazioni di sistema correlate a tutti i touchpad rilevati.
Nota
Il termine "touchpad" fa riferimento a Touchpad precisione. Il termine "touchpad legacy" si riferisce ai touchpad di vecchia generazione che segnalano se stessi a Windows come mouse.
Sintassi
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
Versione dello struct.
Il chiamante deve impostare su TOUCHPAD_PARAMETERS_LATEST_VERSION per usare la versione più recente oppure per TOUCHPAD_PARAMETERS_VERSION_[#] per usare una versione specifica (). La versione deve essere specificata durante la lettura e la scrittura delle impostazioni.
Nota
TOUCHPAD_PARAMETERS_VERSION_1 è l'unica versione specifica di TOUCHPAD_PARAMETERS_VERSION_[#] attualmente definita.
maxSupportedContacts
Numero massimo di contatti simultanei (per il touchpad che supporta la maggior parte) tra tutti i touchpad rilevati. 1
legacyTouchpadFeatures
Le funzionalità supportate segnalate dai touchpad legacy rilevati. Questo sarà LEGACY_TOUCHPAD_FEATURE_NONE se non vengono rilevati touchpad legacy o se i touchpad legacy non supportano la configurazione tramite SPI_SETTOUCHPADPARAMETERS. 1
touchpadPresent
Viene rilevato un Touchpad di precisione. 1
legacyTouchpadPresent
Viene rilevato un touchpad legacy. 1
externalMousePresent
Viene rilevato un mouse esterno. Vedere Ottimizzazione del touchpad di precisione per informazioni sull'esenzione di un mouse da considerare come esterna (a scopo di questo campo di stato e comportamento dell'impostazione allowActiveWhenMousePresent ). 1
touchpadEnabled
L'input del touchpad è abilitato. 1
touchpadActive
L'input touchpad è attivo. È attivo se è abilitato e non è stato rilevato alcun mouse esterno o l'input del touchpad è stato configurato per rimanere attivo nonostante la presenza di un mouse esterno. Questo campo non indica se un touchpad produce attivamente input. 1
feedbackSupported
Un touchpad rilevato supporta il feedback aptico. 1
clickForceSupported
Un touchpad rilevato supporta la forza di clic aptico. 1
Reserved1
allowActiveWhenMousePresent
L'input del touchpad può rimanere attivo se viene rilevato un mouse esterno. Quando inattivo, qualsiasi input prodotto da un touchpad viene ignorato. 2
feedbackEnabled
Il feedback aptico è abilitato nei touchpad se supportato. 2
tapEnabled
I tocco a dito singolo sono abilitati. 2
tapAndDragEnabled
Il tocco e il trascinamento sono abilitati. 2
twoFingerTapEnabled
Il tocco a due dita è abilitato. 2
rightClickZoneEnabled
Premendo l'angolo in basso a destra del touchpad viene restituito un clic con il pulsante destro del mouse anziché un clic a sinistra. 2
Se l'utente ha scambiato i pulsanti sinistro e destro del mouse (GetSystemMetrics(SM_SWAPBUTTON) è true), la zona di clic con il pulsante destro del mouse viene mirrorata orizzontalmente nell'angolo inferiore sinistro del touchpad.
mouseAccelSettingHonored
Il movimento del mouse prodotto dal touchpad rispetta l'impostazione di accelerazione del mouse dell'utente (specificata da SystemParametersInfo(SPI_GETMOUSE)). Se false, il movimento del mouse ha sempre l'accelerazione applicata. 2
panEnabled
La panoramica a due dita è abilitata. 2
zoomEnabled
Lo zoom a due dita è abilitato. 2
scrollDirectionReversed
Il contenuto di direzione scorre con panoramica a due dita viene invertito. Per impostazione predefinita, il movimento verso l'alto dei contatti sul touchpad comporta lo scorrimento del contenuto verso il basso mentre il movimento sinistro dei contatti comporta lo scorrimento del contenuto verso destra. 2
Reserved2
sensitivityLevel
Livello di riservatezza del touchpad. Più sensibile al touchpad, la minore eliminazione della generazione di input del mouse si verifica dopo l'attività della tastiera (vedere TOUCHPAD_SENSITIVITY_LEVEL enumerazione). 2
cursorSpeed
Frequenza in cui il movimento del mouse prodotto dal touchpad sposta il cursore. I valori validi sono compresi tra 1 e 20. 2
feedbackIntensity
L'intensità relativa del feedback aptico del touchpad (se supportato). I valori validi sono compresi tra 0 e 100. 2
clickForceSensitivity
La riservatezza relativa del rilevamento del clic aptico del touchpad (se supportato). I valori validi sono compresi tra 0 e 100. 2
rightClickZoneWidth
La larghezza relativa del touchpad fare clic con il pulsante destro del mouse sulla zona. I valori validi sono compresi tra 0 e 100. Se non zero, questo valore esegue l'override della configurazione del dispositivo. 2
rightClickZoneHeight
Altezza relativa del touchpad con il pulsante destro del mouse sulla zona. I valori validi sono compresi tra 0 e 100. Se non zero, questo valore esegue l'override della configurazione del dispositivo. 2
Commenti
Tutti i campi si applicano solo ai Touchpad precisione, ad eccezione dei campi che specificano "touchpad legacy" o sono supportati dal touchpad legacy, come indicato dal campo legacyTouchpadFeatures .
1 Rappresenta le informazioni di sistema che possono essere usate per informare quali impostazioni utente sono applicabili al dispositivo corrente. Vengono ignorati quando si chiama SystemParametersInfo (A/W) con SPI_SETTOUCHPADPARAMETERS.
2 Rappresenta le impostazioni utente. Le modifiche a questi campi comportano la modifica delle impostazioni dell'utente quando si chiama SystemParametersInfo (A/W) con SPI_SETTOUCHPADPARAMETERS.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 11, versione 24H2 [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Intestazione | winuser.h (include Windows.h) |
Vedi anche
enumerazione TOUCHPAD_SENSITIVITY_LEVEL, enumerazione LEGACY_TOUCHPAD_FEATURES