Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Contiene le impostazioni del touchpad utente e le informazioni di sistema correlate a tutti i touchpad rilevati.
Annotazioni
Il termine "touchpad" si riferisce ai Touchpad di precisione. Il termine "touchpad legacy" si riferisce ai touchpad di generazione precedenti che si riferiscono a Windows come mouse.
Sintassi
typedef struct TOUCHPAD_PARAMETERS_V1 {
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_V1, *PTOUCHPAD_PARAMETERS_V1;
Members
versionNumber
Versione dello struct.
Il chiamante deve impostare su TOUCHPAD_PARAMETERS_LATEST_VERSION per usare la versione più recente o per TOUCHPAD_PARAMETERS_VERSION_[#] per usare una versione specifica, ad esempio TOUCHPAD_PARAMETERS_VERSION_1. La versione deve essere specificata sia durante la lettura che la scrittura.
Annotazioni
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 di più) 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. Vedi Ottimizzazione del touchpad di precisione per informazioni sull'esenzione di un mouse dall'essere considerato esterno (ai fini di questo campo di stato e comportamento dell'impostazione allowActiveWhenMousePresent ). 1
touchpadEnabled
L'input touchpad è abilitato. 1
touchpadActive
L'input del 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 sta producendo 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 touchpad può rimanere attivo se viene rilevato un mouse esterno. In caso di inattività, qualsiasi input prodotto da un touchpad viene ignorato. 2
feedbackEnabled
Il feedback aptico è abilitato nei touchpad, se supportato. 2
tapEnabled
I tap con un solo dito 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 si ottiene 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 rispecchiata orizzontalmente nell'angolo inferiore sinistro del touchpad.
mouseAccelSettingHonored
Il movimento del mouse prodotto dal touchpad rispetta l'impostazione dell'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 della 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 verso sinistra 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 dell'input del mouse si verifica dopo l'attività della tastiera (vedere TOUCHPAD_SENSITIVITY_LEVEL enumerazione). 2
cursorSpeed
Frequenza con cui il movimento del mouse prodotto dal touchpad sposta il cursore. I valori validi sono compresi tra 1 e 20. 2
feedbackIntensity
Intensità relativa del feedback aptico del touchpad (se supportato). I valori validi sono compresi tra 0 e 100 inclusi. 2
clickForceSensitivity
Sensibilità relativa del rilevamento clic aptico del touchpad (se supportato). I valori validi sono compresi tra 0 e 100 inclusi. 2
rightClickZoneWidth
Larghezza relativa della zona di clic con il pulsante destro del mouse sul touchpad. I valori validi sono compresi tra 0 e 100 inclusi. Se diverso da zero, questo valore esegue l'override della configurazione del dispositivo. 2
rightClickZoneHeight
Altezza relativa della zona di clic con il pulsante destro del mouse sul touchpad. I valori validi sono compresi tra 0 e 100 inclusi. Se diverso da zero, questo valore esegue l'override della configurazione del dispositivo. 2
Osservazioni:
Tutti i campi si applicano solo ai Touchpad di 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 apportate a questi campi comportano la modifica delle impostazioni dell'utente quando si chiama SystemParametersInfo (A/W) con SPI_SETTOUCHPADPARAMETERS.
Requisiti
| Requisito | Value |
|---|---|
| Client minimo supportato | Windows 11, versione 24H2 [solo app desktop] |
| Server minimo supportato | Nessuna supportata |
| Header | winuser.h (include Windows.h) |
Vedere anche
enumerazione TOUCHPAD_SENSITIVITY_LEVELLEGACY_TOUCHPAD_FEATURES