struktur TOUCHPAD_PARAMETERS (winuser.h)
Penting
Beberapa informasi berkaitan dengan produk prarilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Berisi pengaturan touchpad pengguna dan informasi sistem yang terkait dengan semua touchpad yang terdeteksi.
Catatan
Istilah "touchpad" mengacu pada Precision Touchpads. Istilah "touchpad warisan" mengacu pada touchpad generasi lama yang melaporkan diri mereka ke Windows sebagai mouse.
Sintaks
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;
Anggota
versionNumber
Versi struktur.
Penelepon harus mengatur ke TOUCHPAD_PARAMETERS_LATEST_VERSION untuk menggunakan versi terbaru, atau untuk TOUCHPAD_PARAMETERS_VERSION_[#] untuk menggunakan versi tertentu (). Versi harus ditentukan ketika pengaturan membaca dan menulis.
Catatan
TOUCHPAD_PARAMETERS_VERSION_1 adalah satu-satunya versi spesifik dari TOUCHPAD_PARAMETERS_VERSION_[#] yang saat ini ditentukan.
maxSupportedContacts
Jumlah maksimum kontak simultan (untuk touchpad yang paling mendukung) di antara semua touchpad yang terdeteksi. 1
legacyTouchpadFeatures
Fitur yang didukung dilaporkan oleh touchpad warisan yang terdeteksi. Ini akan LEGACY_TOUCHPAD_FEATURE_NONE jika tidak ada touchpad warisan yang terdeteksi, atau jika touchpad warisan tidak mendukung konfigurasi melalui SPI_SETTOUCHPADPARAMETERS. 1
touchpadPresent
Touchpad Presisi terdeteksi. 1
legacyTouchpadPresent
Touchpad warisan terdeteksi. 1
externalMousePresent
Mouse eksternal terdeteksi. Lihat Penyetelan touchpad presisi untuk informasi tentang mengecualikan mouse agar tidak dianggap eksternal (untuk tujuan bidang status ini dan perilaku pengaturan allowActiveWhenMousePresent ). 1
touchpadEnabled
Input touchpad diaktifkan. 1
touchpadActive
Input touchpad aktif. Ini aktif jika diaktifkan, dan tidak ada mouse eksternal yang terdeteksi atau input touchpad telah dikonfigurasi untuk tetap aktif meskipun ada mouse eksternal. Bidang ini tidak menunjukkan apakah ada touchpad yang secara aktif menghasilkan input. 1
feedbackSupported
Touchpad yang terdeteksi mendukung umpan balik haptik. 1
clickForceSupported
Touchpad yang terdeteksi mendukung gaya klik haptik. 1
Reserved1
allowActiveWhenMousePresent
Input touchpad dapat tetap aktif jika mouse eksternal terdeteksi. Saat tidak aktif, input apa pun yang dihasilkan oleh touchpad diabaikan. 2
feedbackEnabled
Umpan balik haptic diaktifkan pada touchpad jika didukung. 2
tapEnabled
Ketukan satu jari diaktifkan. 2
tapAndDragEnabled
Ketuk dan seret diaktifkan. 2
twoFingerTapEnabled
Ketuk dua jari diaktifkan. 2
rightClickZoneEnabled
Menekan sudut kanan bawah touchpad menghasilkan klik kanan, bukan klik kiri. 2
Jika pengguna telah menukar tombol mouse kiri dan kanan mereka (GetSystemMetrics(SM_SWAPBUTTON) adalah benar), zona klik kanan dicerminkan secara horizontal ke sudut kiri bawah touchpad.
mouseAccelSettingHonored
Gerakan mouse yang dihasilkan oleh touchpad menghormati pengaturan akselerasi mouse pengguna (ditentukan oleh SystemParametersInfo(SPI_GETMOUSE)). Jika false, gerakan mouse selalu memiliki akselerasi yang diterapkan. 2
panEnabled
Pengalih dua jari diaktifkan. 2
zoomEnabled
Pembesaran dua jari diaktifkan. 2
scrollDirectionReversed
Konten arah bergulir dengan panning dua jari dibalik. Secara default, gerakan kontak ke atas pada touchpad menghasilkan konten yang bergulir ke bawah sementara gerakan kontak ke kiri menghasilkan konten yang bergulir ke kanan. 2
Reserved2
sensitivityLevel
Tingkat sensitivitas touchpad. Semakin sensitif touchpad, semakin sedikit penekanan pembuatan input mouse terjadi setelah aktivitas keyboard (lihat enumerasi TOUCHPAD_SENSITIVITY_LEVEL). 2
cursorSpeed
Laju di mana gerakan mouse yang dihasilkan oleh touchpad memindahkan kursor. Nilai yang valid adalah 1-20, inklusif. 2
feedbackIntensity
Intensitas relatif umpan balik haptik touchpad (jika didukung). Nilai yang valid adalah 0-100, inklusif. 2
clickForceSensitivity
Sensitivitas relatif deteksi klik haptik touchpad (jika didukung). Nilai yang valid adalah 0-100, inklusif. 2
rightClickZoneWidth
Lebar relatif zona klik kanan touchpad. Nilai yang valid adalah 0-100, inklusif. Jika bukan nol, nilai ini akan menggantikan konfigurasi perangkat. 2
rightClickZoneHeight
Tinggi relatif zona klik kanan touchpad. Nilai yang valid adalah 0-100, inklusif. Jika bukan nol, nilai ini akan menggantikan konfigurasi perangkat. 2
Keterangan
Semua bidang hanya berlaku untuk Touchpad Presisi, dengan pengecualian bidang yang menentukan "touchpad warisan" atau didukung oleh touchpad warisan seperti yang ditunjukkan oleh bidang warisanTouchpadFeatures .
1 Mewakili informasi sistem yang dapat digunakan untuk membantu menginformasikan pengaturan pengguna mana yang berlaku untuk perangkat saat ini. Mereka diabaikan saat memanggil SystemParametersInfo (A/W) dengan SPI_SETTOUCHPADPARAMETERS.
2 Mewakili pengaturan pengguna. Modifikasi pada bidang ini akan mengakibatkan perubahan pengaturan pengguna saat memanggil SystemParametersInfo (A/W) dengan SPI_SETTOUCHPADPARAMETERS.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 11, versi 24H2 [hanya aplikasi desktop] |
| Server minimum yang didukung | Tidak ada yang didukung |
| Header | winuser.h (termasuk Windows.h) |
Lihat juga
enumerasi TOUCHPAD_SENSITIVITY_LEVEL, enumerasi LEGACY_TOUCHPAD_FEATURES