estructura TOUCHPAD_PARAMETERS (winuser.h)
Importante
Parte de la información se relaciona con un producto de versión preliminar que puede modificarse sustancialmente antes de su lanzamiento comercial. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Contiene la configuración del panel táctil de usuario y la información del sistema relacionadas con todos los paneles táctiles detectados.
Nota
El término "touchpad" hace referencia a los paneles táctiles de precisión. El término "panel táctil heredado" hace referencia a los paneles táctiles de generación anteriores que se informan a sí mismos a Windows como un mouse.
Sintaxis
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;
Miembros
versionNumber
Versión de la estructura.
El autor de la llamada debe establecer en TOUCHPAD_PARAMETERS_LATEST_VERSION para usar la versión más reciente o para TOUCHPAD_PARAMETERS_VERSION_[#] para usar una versión específica (). La versión debe especificarse al leer y escribir la configuración.
Nota
TOUCHPAD_PARAMETERS_VERSION_1 es la única versión específica de TOUCHPAD_PARAMETERS_VERSION_[#] definida actualmente.
maxSupportedContacts
El número máximo de contactos simultáneos (para el panel táctil que admite más) entre todos los paneles táctiles detectados. 1
legacyTouchpadFeatures
Las características admitidas notificadas por los paneles táctiles heredados detectados. Esto será LEGACY_TOUCHPAD_FEATURE_NONE si no se detectan paneles táctiles heredados o si los paneles táctiles heredados no admiten la configuración a través de SPI_SETTOUCHPADPARAMETERS. 1
touchpadPresent
Se detecta un panel táctil de precisión. 1
legacyTouchpadPresent
Se detecta un panel táctil heredado. 1
externalMousePresent
Se detecta un mouse externo. Consulte Ajuste de panel táctil de precisión para obtener información sobre cómo excluir que un mouse se considere externo (para los fines de este campo de estado y comportamiento de la configuración allowActiveWhenMousePresent ). 1
touchpadEnabled
La entrada del panel táctil está habilitada. 1
touchpadActive
La entrada del panel táctil está activa. Está activo si está habilitado y no se ha detectado ningún mouse externo o se ha configurado la entrada del panel táctil para mantenerse activo a pesar de la presencia de un mouse externo. Este campo no indica si algún panel táctil está produciendo activamente la entrada. 1
feedbackSupported
Un panel táctil detectado admite comentarios hápticos. 1
clickForceSupported
Un panel táctil detectado admite la fuerza de clic háptica. 1
Reserved1
allowActiveWhenMousePresent
La entrada del panel táctil puede permanecer activa si se detecta un mouse externo. Cuando está inactivo, se omite cualquier entrada generada por un panel táctil. 2
feedbackEnabled
Los comentarios hápticos están habilitados en los paneles táctiles si se admiten. 2
tapEnabled
Las pulsaciones de un solo dedo están habilitadas. 2
tapAndDragEnabled
Pulsar y arrastrar está habilitado. 2
twoFingerTapEnabled
La pulsación con dos dedos está habilitada. 2
rightClickZoneEnabled
Al presionar la esquina inferior derecha del panel táctil, se produce un clic derecho en lugar de un clic izquierdo. 2
Si el usuario ha intercambiado sus botones del mouse izquierdo y derecho (GetSystemMetrics(SM_SWAPBUTTON) es true), la zona de clic derecho se refleja horizontalmente en la esquina inferior izquierda del panel táctil.
mouseAccelSettingHonored
El movimiento del mouse producido por el panel táctil respeta la configuración de aceleración del mouse del usuario (especificada por SystemParametersInfo(SPI_GETMOUSE)). Si es false, el movimiento del mouse siempre tiene aplicada la aceleración. 2
panEnabled
El movimiento panorámico de dos dedos está habilitado. 2
zoomEnabled
El zoom con dos dedos está habilitado. 2
scrollDirectionReversed
El contenido de dirección se desplaza con movimiento panorámico de dos dedos se invierte. De forma predeterminada, el movimiento ascendente de los contactos en el panel táctil da como resultado que el contenido se desplaza hacia abajo mientras que el movimiento hacia la izquierda de los contactos da como resultado el desplazamiento hacia la derecha del contenido. 2
Reserved2
sensitivityLevel
Nivel de sensibilidad del panel táctil. Cuanto más sensible sea el panel táctil, la menor supresión de la generación de entrada del mouse se produce después de la actividad del teclado (consulte TOUCHPAD_SENSITIVITY_LEVEL enumeración). 2
cursorSpeed
Velocidad a la que el movimiento del mouse producido por el panel táctil mueve el cursor. Los valores válidos son 1-20, ambos incluidos. 2
feedbackIntensity
Intensidad relativa de los comentarios hápticos del panel táctil (si se admite). Los valores válidos son 0-100, ambos incluidos. 2
clickForceSensitivity
Sensibilidad relativa de la detección de clic háptico del panel táctil (si se admite). Los valores válidos son 0-100, ambos incluidos. 2
rightClickZoneWidth
Ancho relativo de la zona de clic con el botón derecho del panel táctil. Los valores válidos son 0-100, ambos incluidos. Si no es cero, este valor invalida la configuración del dispositivo. 2
rightClickZoneHeight
Alto relativo de la zona de clic derecho del panel táctil. Los valores válidos son 0-100, ambos incluidos. Si no es cero, este valor invalida la configuración del dispositivo. 2
Comentarios
Todos los campos solo se aplican a los paneles táctiles de precisión, con la excepción de los campos que especifican "panel táctil heredado" o son compatibles con el panel táctil heredado, como se indica en el campo legacyTouchpadFeatures .
1 Representa la información del sistema que se puede usar para ayudar a informar de qué configuración de usuario se aplica al dispositivo actual. Se omiten al llamar a SystemParametersInfo (A/W) con SPI_SETTOUCHPADPARAMETERS.
2 Representa la configuración del usuario. Las modificaciones en estos campos darán lugar a cambios en la configuración del usuario al llamar a SystemParametersInfo (A/W) con SPI_SETTOUCHPADPARAMETERS.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 11, versión 24H2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Encabezado | winuser.h (incluya Windows.h) |
Consulte también
enumeración TOUCHPAD_SENSITIVITY_LEVEL, enumeración LEGACY_TOUCHPAD_FEATURES