estrutura TOUCHPAD_PARAMETERS (winuser.h)
Importante
Algumas informações estão relacionadas a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Contém as configurações do touchpad do usuário e as informações do sistema relacionadas a todos os touchpads detectados.
Observação
O termo "touchpad" refere-se a Touchpads de precisão. O termo "touchpad herdado" refere-se a touchpads de geração mais antiga que se reportam ao Windows como um mouse.
Sintaxe
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;
Membros
versionNumber
A versão do struct.
O chamador deve definir como TOUCHPAD_PARAMETERS_LATEST_VERSION para usar a versão mais recente ou para TOUCHPAD_PARAMETERS_VERSION_[#] para usar uma versão específica (). A versão deve ser especificada ao ler e gravar configurações.
Observação
TOUCHPAD_PARAMETERS_VERSION_1 é a única versão específica do TOUCHPAD_PARAMETERS_VERSION_[#] definida no momento.
maxSupportedContacts
O número máximo de contatos simultâneos (para o touchpad que mais dá suporte) entre todos os touchpads detectados. 1
legacyTouchpadFeatures
Os recursos com suporte relatados por touchpads herdados detectados. Isso será LEGACY_TOUCHPAD_FEATURE_NONE se nenhum touchpad herdado for detectado ou se os touchpads herdados não derem suporte à configuração por meio de SPI_SETTOUCHPADPARAMETERS. 1
touchpadPresent
Um Touchpad de Precisão é detectado. 1
legacyTouchpadPresent
Um touchpad herdado é detectado. 1
externalMousePresent
Um mouse externo é detectado. Consulte Ajuste de touchpad de precisão para obter informações sobre como isentar um mouse de ser considerado externo (para fins deste campo de status e comportamento da configuração allowActiveWhenMousePresent).1
touchpadEnabled
A entrada do Touchpad está habilitada. 1
touchpadActive
A entrada do Touchpad está ativa. Ele estará ativo se estiver habilitado e não houver nenhum mouse externo detectado ou se a entrada do touchpad tiver sido configurada para permanecer ativa, apesar da presença de um mouse externo. Esse campo não indica se algum touchpad está produzindo ativamente entrada. 1
feedbackSupported
Um touchpad detectado dá suporte a comentários hápticos. 1
clickForceSupported
Um touchpad detectado dá suporte à força de clique háptica. 1
Reserved1
allowActiveWhenMousePresent
A entrada touchpad poderá permanecer ativa se um mouse externo for detectado. Quando inativa, qualquer entrada produzida por um touchpad é ignorada. 2
feedbackEnabled
Os comentários hápticos são habilitados em touchpads, se houver suporte. 2
tapEnabled
Os toques de dedo único estão habilitados. 2
tapAndDragEnabled
Toque e arraste está habilitado. 2
twoFingerTapEnabled
O toque de dois dedos está habilitado. 2
rightClickZoneEnabled
Pressionar o canto inferior direito do touchpad resulta em um clique com o botão direito do mouse em vez de um clique à esquerda. 2
Se o usuário tiver trocado os botões esquerdo e direito do mouse (GetSystemMetrics(SM_SWAPBUTTON) for true), a zona de clique com o botão direito do mouse será espelhada horizontalmente para o canto inferior esquerdo do touchpad.
mouseAccelSettingHonored
O movimento do mouse produzido pelo touchpad respeita a configuração de aceleração do mouse do usuário (especificada por SystemParametersInfo(SPI_GETMOUSE)). Se for false, o movimento do mouse sempre terá a aceleração aplicada. 2
panEnabled
O movimento panorâmico de dois dedos está habilitado. 2
zoomEnabled
O zoom de dois dedos está habilitado. 2
scrollDirectionReversed
A direção em que o conteúdo rola com movimento panorâmico de dois dedos é invertida. Por padrão, o movimento ascendente dos contatos no touchpad resulta na rolagem de conteúdo para baixo enquanto o movimento para a esquerda dos contatos resulta na rolagem de conteúdo para a direita. 2
Reserved2
sensitivityLevel
O nível de confidencialidade do touchpad. Quanto mais sensível o touchpad, menos supressão da geração de entrada do mouse ocorre após a atividade do teclado (consulte TOUCHPAD_SENSITIVITY_LEVEL enumeração). 2
cursorSpeed
A taxa na qual o movimento do mouse produzido pelo touchpad move o cursor. Os valores válidos são de 1 a 20, inclusive. 2
feedbackIntensity
A intensidade relativa dos comentários hápticos do touchpad (se houver suporte). Os valores válidos são de 0 a 100, inclusive. 2
clickForceSensitivity
A sensibilidade relativa da detecção de clique háptico do touchpad (se houver suporte). Os valores válidos são de 0 a 100, inclusive. 2
rightClickZoneWidth
A largura relativa da zona de clique com o botão direito do mouse no touchpad. Os valores válidos são de 0 a 100, inclusive. Se não for zero, esse valor substituirá a configuração do dispositivo. 2
rightClickZoneHeight
A altura relativa da zona de clique com o botão direito do mouse no touchpad. Os valores válidos são de 0 a 100, inclusive. Se não for zero, esse valor substituirá a configuração do dispositivo. 2
Comentários
Todos os campos se aplicam somente a Touchpads de Precisão, com exceção de campos que especificam "touchpad herdado" ou têm suporte do touchpad herdado, conforme indicado pelo campo legacyTouchpadFeatures .
1 Representa as informações do sistema que podem ser usadas para ajudar a informar quais configurações de usuário são aplicáveis ao dispositivo atual. Eles são ignorados ao chamar SystemParametersInfo (A/W) com SPI_SETTOUCHPADPARAMETERS.
2 Representa as configurações do usuário. As modificações nesses campos resultarão na alteração das configurações do usuário ao chamar SystemParametersInfo (A/W) com SPI_SETTOUCHPADPARAMETERS.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 11, versão 24H2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Cabeçalho | winuser.h (inclua Windows.h) |
Confira também
enumeração TOUCHPAD_SENSITIVITY_LEVEL, enumeração LEGACY_TOUCHPAD_FEATURES