다음을 통해 공유

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_VERSION_[#]을 TOUCHPAD_PARAMETERS_LATEST_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) 를 교환한 경우 오른쪽 클릭 영역은 터치 패드의 왼쪽 아래 모서리에 가로로 미러링됩니다.

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(포함)입니다. 0이 아닌 경우 이 값은 디바이스 구성을 재정의합니다. 2

rightClickZoneHeight

터치 패드 오른쪽 클릭 영역의 상대 높이입니다. 유효한 값은 0-100(포함)입니다. 0이 아닌 경우 이 값은 디바이스 구성을 재정의합니다. 2

설명

모든 필드는 "레거시 터치패드"를 지정하거나 레거시TouchpadFeatures 필드에 표시된 대로 레거시 터치패드에서 지원되는 필드를 제외하고 정밀 터치패드에만 적용됩니다.

1 현재 디바이스에 적용할 수 있는 사용자 설정을 알리는 데 사용할 수 있는 시스템 정보를 나타냅니다. SPI_SETTOUCHPADPARAMETERS 사용하여 SystemParametersInfo(A/W)를 호출할 때 무시됩니다.

2 사용자 설정을 나타냅니다. 이러한 필드를 수정하면 SPI_SETTOUCHPADPARAMETERS 사용하여 SystemParametersInfo(A/W)를 호출할 때 사용자의 설정이 변경됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 11 버전 24H2 [데스크톱 앱만 해당]
지원되는 최소 서버 지원되는 버전 없음
머리글 winuser.h(Windows.h 포함)

추가 정보

TOUCHPAD_SENSITIVITY_LEVEL 열거형, LEGACY_TOUCHPAD_FEATURES 열거형