TOUCHPAD_PARAMETERS Struktur (winuser.h)
Wichtig
Einige Informationen beziehen sich auf ein Vorabrelease-Produkt, das vor der kommerziellen Freigabe erheblich geändert werden kann. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Enthält Benutzertouchpadeinstellungen und Systeminformationen, die sich auf alle erkannten Touchpads beziehen.
Hinweis
Der Begriff "Touchpad" bezieht sich auf Präzisions-Touchpads. Der Begriff "Legacy-Touchpad" bezieht sich auf Touchpads der älteren Generation, die sich als Maus an Windows melden.
Syntax
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;
Member
versionNumber
Die Version der Struktur.
Der Aufrufer muss auf TOUCHPAD_PARAMETERS_LATEST_VERSION festlegen, um die neueste Version zu verwenden, oder TOUCHPAD_PARAMETERS_VERSION_[#], um eine bestimmte Version () zu verwenden. Die Version muss bei Lese- und Schreibeinstellungen angegeben werden.
Hinweis
TOUCHPAD_PARAMETERS_VERSION_1 ist derzeit die einzige bestimmte Version von TOUCHPAD_PARAMETERS_VERSION_[#] definiert.
maxSupportedContacts
Die maximale Anzahl gleichzeitiger Kontakte (für das Touchpad, das am meisten unterstützt) unter allen erkannten Touchpads. 1
legacyTouchpadFeatures
Die von erkannten Legacy-Touchpads gemeldeten unterstützten Features. Dies wird LEGACY_TOUCHPAD_FEATURE_NONE , wenn keine Legacy-Touchpads erkannt werden oder wenn die Legacy-Touchpads die Konfiguration über SPI_SETTOUCHPADPARAMETERS nicht unterstützen. 1
touchpadPresent
Es wird ein Präzisions-Touchpad erkannt. 1
legacyTouchpadPresent
Ein Legacy-Touchpad wird erkannt. 1
externalMousePresent
Eine externe Maus wird erkannt. Informationen zum Ausschließen einer Maus als extern (für die Zwecke dieses status Felds und des Verhaltens der Einstellung allowActiveWhenMousePresent) finden Sie unter Precision Touchpad-Optimierung.1
touchpadEnabled
Die Touchpadeingabe ist aktiviert. 1
touchpadActive
Die Touchpadeingabe ist aktiv. Sie ist aktiv, wenn sie aktiviert ist und entweder keine externe Maus erkannt wird oder die Touchpadeingabe so konfiguriert wurde, dass sie trotz der Anwesenheit einer externen Maus aktiv bleibt. Dieses Feld gibt nicht an, ob ein Touchpad aktiv Eingaben erzeugt. 1
feedbackSupported
Ein erkanntes Touchpad unterstützt haptisches Feedback. 1
clickForceSupported
Ein erkanntes Touchpad unterstützt haptische Klickkraft. 1
Reserved1
allowActiveWhenMousePresent
Touchpadeingaben können aktiv bleiben, wenn eine externe Maus erkannt wird. Wenn sie inaktiv ist, werden alle von einem Touchpad erzeugten Eingaben ignoriert. 2
feedbackEnabled
Haptisches Feedback wird auf Touchpads aktiviert, sofern diese unterstützt werden. 2
tapEnabled
Das Tippen mit einem Finger ist aktiviert. 2
tapAndDragEnabled
Tippen und Ziehen ist aktiviert. 2
twoFingerTapEnabled
Das Tippen mit zwei Fingern ist aktiviert. 2
rightClickZoneEnabled
Durch Drücken der unteren rechten Ecke des Touchpads wird anstelle eines Linksklicks ein Rechtsklick angezeigt. 2
Wenn der Benutzer seine linken und rechten Maustasten ausgetauscht hat (GetSystemMetrics(SM_SWAPBUTTON) ist true), wird die Rechtsklickzone horizontal in die linke untere Ecke des Touchpads gespiegelt.
mouseAccelSettingHonored
Mausbewegungen, die vom Touchpad erzeugt werden, entsprechen der Mausbeschleunigungseinstellung des Benutzers (angegeben durch SystemParametersInfo(SPI_GETMOUSE)). Wenn false, wird die Mausbewegung immer beschleunigt. 2
panEnabled
Das Schwenken mit zwei Fingern ist aktiviert. 2
zoomEnabled
Das Zoomen mit zwei Fingern ist aktiviert. 2
scrollDirectionReversed
Die Richtung des Inhaltslaufs mit zwei Fingern wird umgekehrt. Standardmäßig führt die Aufwärtsbewegung von Kontakten auf dem Touchpad zu einem Bildlauf von Inhalten nach unten, während die Linksbewegung von Kontakten dazu führt, dass inhalte nach rechts scrollen. 2
Reserved2
sensitivityLevel
Die Touchpad-Empfindlichkeitsstufe. Je empfindlicher das Touchpad ist, desto weniger Unterdrückung der Mauseingabegenerierung erfolgt nach der Tastaturaktivität (siehe TOUCHPAD_SENSITIVITY_LEVEL Enumeration). 2
cursorSpeed
Die Geschwindigkeit, mit der die vom Touchpad erzeugte Mausbewegung den Cursor bewegt. Gültige Werte sind einschließlich 1 bis 20. 2
feedbackIntensity
Die relative Intensität des haptischen Feedbacks des Touchpads (sofern unterstützt). Gültige Werte sind einschließlich 0-100. 2
clickForceSensitivity
Die relative Empfindlichkeit der haptischen Klickerkennung des Touchpads (sofern unterstützt). Gültige Werte sind einschließlich 0-100. 2
rightClickZoneWidth
Die relative Breite der Touchpad-Zone mit der rechten Maustaste. Gültige Werte sind einschließlich 0-100. Wenn der Wert ungleich 0 ist, überschreibt dieser Wert die Gerätekonfiguration. 2
rightClickZoneHeight
Die relative Höhe der Touchpadzone mit der rechten Maustaste. Gültige Werte sind einschließlich 0-100. Wenn der Wert ungleich 0 ist, überschreibt dieser Wert die Gerätekonfiguration. 2
Hinweise
Alle Felder gelten nur für Präzisions-Touchpads, mit Ausnahme von Feldern, die "Legacy-Touchpad" angeben oder vom Legacy-Touchpad unterstützt werden, wie im Feld legacyTouchpadFeatures angegeben.
1 Stellt die Systeminformationen dar, die verwendet werden können, um zu informieren, welche Benutzereinstellungen für das aktuelle Gerät gelten. Sie werden ignoriert, wenn SystemParametersInfo (A/W) mit SPI_SETTOUCHPADPARAMETERS aufgerufen wird.
2 Stellt Benutzereinstellungen dar. Änderungen an diesen Feldern führen zum Ändern der Benutzereinstellungen beim Aufrufen von SystemParametersInfo (A/W) mit SPI_SETTOUCHPADPARAMETERS.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 11, Version 24H2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Kopfzeile | winuser.h (einschließlich Windows.h) |
Weitere Informationen
TOUCHPAD_SENSITIVITY_LEVEL-Enumeration, LEGACY_TOUCHPAD_FEATURES-Enumeration