TOUCHPAD_PARAMETERS 構造体 (winuser.h)

  • [アーティクル]

重要

一部の情報はプレリリース製品に関連しており、市販される前に大幅に変更される可能性があります。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

検出されたすべてのタッチパッドに関連するユーザー タッチパッドの設定とシステム情報が含まれます。

注意

"タッチパッド" という用語は、高精度タッチパッドを指します。 "レガシ タッチパッド" という用語は、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

1 本指でタップできます。2

tapAndDragEnabled

タップアンドドラッグが有効になっています。2

twoFingerTapEnabled

2 本指でタップできます。2

rightClickZoneEnabled

タッチパッドの右下隅を押すと、左クリックではなく右クリックになります。2

ユーザーがマウスの左ボタンと右ボタンを入れ替えた場合 (GetSystemMetrics(SM_SWAPBUTTON) が true の場合、右クリック ゾーンはタッチパッドの左下隅に水平方向にミラー化されます。

mouseAccelSettingHonored

タッチパッドによって生成されたマウス モーションは、ユーザーのマウス アクセラレーション設定 ( SystemParametersInfo(SPI_GETMOUSE)で指定) を考慮します。 false の場合、マウスのモーションには常に加速度が適用されます。2

panEnabled

2 本指でのパンが有効になっています。2

zoomEnabled

2 本指でのズームが有効になっています。2

scrollDirectionReversed

2 本指でパンすると、コンテンツがスクロールする方向が反転します。 既定では、タッチパッド上の連絡先の上向きの動きにより、コンテンツは下方向にスクロールし、連絡先の左方向のモーションではコンテンツが右方向にスクロールします。2

Reserved2

sensitivityLevel

タッチパッドの感度レベル。 タッチパッドの感度が高いほど、キーボードアクティビティ後のマウス入力生成の抑制が少なくなります ( 「TOUCHPAD_SENSITIVITY_LEVEL列挙」を参照してください)。2

cursorSpeed

タッチパッドによって生成されたマウスモーションがカーソルを移動する速度。 有効な値は 1 から 20 です。値は 1 から 20 です。2

feedbackIntensity

タッチパッドのハプティクス フィードバックの相対的な強度 (サポートされている場合)。 有効な値は 0 ~ 100 です。値は 0 ~ 100 です。2

clickForceSensitivity

タッチパッドのハプティクス クリック検出の相対的な感度 (サポートされている場合)。 有効な値は 0 ~ 100 です。値は 0 ~ 100 です。2

rightClickZoneWidth

タッチパッドの右クリック 領域の相対幅。 有効な値は 0 ~ 100 です。値は 0 ~ 100 です。 0 以外の場合、この値はデバイス構成をオーバーライドします。2

rightClickZoneHeight

タッチパッドの右クリック ゾーンの相対的な高さ。 有効な値は 0 ~ 100 です。値は 0 ~ 100 です。 0 以外の場合、この値はデバイス構成をオーバーライドします。2

注釈

すべてのフィールドは、"レガシ タッチパッド" を指定するフィールド、または legacyTouchpadFeatures フィールドで示されているようにレガシ タッチパッドでサポートされているフィールドを除き、有効桁数タッチパッドにのみ適用されます。

1 現在のデバイスに適用できるユーザー設定を通知するために使用できるシステム情報を表します。 SPI_SETTOUCHPADPARAMETERSを使用して SystemParametersInfo (A/W) を呼び出すときは無視されます。

2 ユーザー設定を表します。 これらのフィールドを変更すると、SPI_SETTOUCHPADPARAMETERSで SystemParametersInfo (A/W) を呼び出すときにユーザーの設定が変更されます。

要件

要件 値
サポートされている最小のクライアント Windows 11バージョン 24H2 [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
Header winuser.h (Windows.h を含む)

こちらもご覧ください

列挙TOUCHPAD_SENSITIVITY_LEVEL、 列挙LEGACY_TOUCHPAD_FEATURES