共用方式為

TOUCHPAD_PARAMETERS 結構 (winuser.h)

  • 發行項

重要

某些資訊與發行前版本產品有關，在正式發行前可能會大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

包含與所有偵測到的觸控板相關的用戶觸控板設定和系統資訊。

注意

“touchpad” 一詞是指 Precision Touchpads。 「舊版觸控板」一詞是指將自己回報給 Windows 做為滑鼠的舊代觸控板。

語法

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;

成員

versionNumber

結構的版本。

呼叫端必須設定為 TOUCHPAD_PARAMETERS_LATEST_VERSION，才能使用最新版本，或是將 TOUCHPAD_PARAMETERS_VERSION_[#] 設定為使用特定版本 () 。 讀取和寫入設定時，必須指定版本。

注意

TOUCHPAD_PARAMETERS_VERSION_1是目前唯一定義TOUCHPAD_PARAMETERS_VERSION_[#] 的特定版本。

maxSupportedContacts

所有偵測到的觸控板之間支援最大) 的觸控板， (同時聯繫人數目上限。1

legacyTouchpadFeatures

偵測到舊版觸控板所報告的支援功能。 如果未偵測到舊版觸控板，或舊版觸控板不支援透過SPI_SETTOUCHPADPARAMETERS設定，就會LEGACY_TOUCHPAD_FEATURE_NONE。1

touchpadPresent

偵測到精確度觸控板。1

legacyTouchpadPresent

偵測到舊版觸控板。1

externalMousePresent

偵測到外部滑鼠。 如需豁免滑鼠作為外部 (的資訊，請參閱 精確度觸控板微調 ，以瞭解此狀態字段和 allowActiveWhenMousePresent 設定) 的行為。1

touchpadEnabled

已啟用觸控板輸入。1

touchpadActive

觸控板輸入為作用中。 如果已啟用，而且未偵測到任何外部滑鼠，或已將觸控板輸入設定為保持作用中，即使有外部滑鼠，它仍為作用中。 此欄位不會指出是否有任何觸控板主動產生輸入。1

feedbackSupported

偵測到的觸控板支援觸覺回饋。1

clickForceSupported

偵測到的觸控板支援觸覺點選強制。1

Reserved1

allowActiveWhenMousePresent

如果偵測到外部滑鼠，觸控板輸入仍可保持作用中。 非使用中時，會忽略觸控板所產生的任何輸入。2

feedbackEnabled

如果支援，觸控板上會啟用觸覺意見反應。2

tapEnabled

已啟用單指點選。2

tapAndDragEnabled

已啟用點選和拖曳。2

twoFingerTapEnabled

已啟用雙指點選。2

rightClickZoneEnabled

按下觸控板的右下角會導致按下滑鼠右鍵，而不是按滑鼠左鍵。2

如果使用者已將滑鼠左鍵和滑鼠右鍵交換 (GetSystemMetrics (SM_SWAPBUTTON) 為 true) ，則以滑鼠右鍵按兩下區域會水平鏡像到觸控板的左下角。

mouseAccelSettingHonored

觸控板所產生的滑鼠動作會接受 由 SystemParametersInfo (SPI_GETMOUSE) ) 所指定的使用者滑鼠加速 (設定。 如果為 false，滑鼠動作一律會套用加速。2

panEnabled

已啟用雙指移動流覽。2

zoomEnabled

已啟用雙指縮放。2

scrollDirectionReversed

方向內容會以雙指移動瀏覽進行反轉。 根據預設，觸控板上聯繫人的向上動作會導致內容向下捲動，而聯繫人的向左移動會導致內容向右卷動。2

Reserved2

sensitivityLevel

觸控板敏感度層級。 觸控板越敏感，鍵盤活動 (看到TOUCHPAD_SENSITIVITY_LEVEL 列舉) 之後，就會產生較少的滑鼠輸入。2

cursorSpeed

觸控板所產生的滑鼠動作移動移動游標的速率。 有效值為 1-20，包含。2

feedbackIntensity

如果支援) ，觸控板觸覺回饋的相對強度 (。 有效值為 0-100，包含。2

clickForceSensitivity

如果支援) ，觸控板觸覺點擊偵測的相對敏感度 (。 有效值為 0-100，包含。2

rightClickZoneWidth

觸控板的相對寬度，以滑鼠右鍵按兩下區域。 有效值為 0-100，包含。 如果不是零，這個值會覆寫裝置組態。2

rightClickZoneHeight

觸控板的相對高度，以滑鼠右鍵按兩下區域。 有效值為 0-100，包含。 如果不是零，這個值會覆寫裝置組態。2

備註

所有欄位僅適用於 Precision Touchpad，但指定「舊版觸控板」的欄位除外，或由舊版觸控板支援，如 舊版TouchpadFeatures 欄位所示。

1 代表可用來協助通知哪些使用者設定適用於目前裝置的系統資訊。 使用 SPI_SETTOUCHPADPARAMETERS呼叫 SystemParametersInfo (W/) 時，會忽略它們。

2 代表用戶設定。 對這些欄位的修改會導致在呼叫 SystemParametersInfo (W/) 與 SPI_SETTOUCHPADPARAMETERS 時變更使用者的設定。

規格需求

需求 值
最低支援的用戶端 Windows 11 版本 24H2 [僅限傳統型應用程式]
最低支援的伺服器 都不支援
標頭 winuser.h (包括 Windows.h)

另請參閱

TOUCHPAD_SENSITIVITY_LEVEL列舉， LEGACY_TOUCHPAD_FEATURES列舉