Marcas de puntero

Valores que pueden aparecer en el campo pointerFlags de la estructura POINTER_INFO .

POINTER_FLAG_NONE

0x00000000

Valor predeterminado

POINTER_FLAG_NEW

0x00000001

Indica la llegada de un nuevo puntero.

POINTER_FLAG_INRANGE

0x00000002

Indica que este puntero sigue existiendo. Cuando no se establece esta marca, indica que el puntero tiene un intervalo de detección izquierdo.

Normalmente, esta marca no se establece solo cuando un puntero que mantiene el mouse deja el intervalo de detección (se establece POINTER_FLAG_UPDATE ) o cuando un puntero en contacto con una superficie de ventana deja el intervalo de detección (se establece POINTER_FLAG_UP ).

POINTER_FLAG_INCONTACT

0x00000004

Indica que este puntero está en contacto con la superficie del digitalizador. Cuando no se establece esta marca, indica un puntero que mantiene el puntero.

POINTER_FLAG_FIRSTBUTTON

0x00000010

Indica una acción principal, análoga a un botón izquierdo del mouse hacia abajo.

Un puntero táctil tiene esta marca establecida cuando está en contacto con la superficie del digitalizador.

Un puntero de lápiz tiene esta marca establecida cuando está en contacto con la superficie del digitalizador sin botones presionados.

Un puntero del mouse tiene esta marca establecida cuando el botón izquierdo del mouse está inactivo.

POINTER_FLAG_SECONDBUTTON

0x00000020

Indica una acción secundaria, análoga a un botón derecho del mouse hacia abajo.

Un puntero táctil no usa esta marca.

Un puntero de lápiz tiene esta marca establecida cuando está en contacto con la superficie del digitalizador con el botón de lápiz de barril presionado.

Un puntero del mouse tiene esta marca establecida cuando el botón derecho del mouse está inactivo.

POINTER_FLAG_THIRDBUTTON

0x00000040

Análogo a un botón de rueda del mouse hacia abajo.

Un puntero táctil no usa esta marca.

Un puntero de lápiz no usa esta marca.

Un puntero del mouse tiene esta marca establecida cuando el botón de rueda del mouse está inactivo.

POINTER_FLAG_FOURTHBUTTON

0x00000080

Análogo a un primer botón extendido del mouse (XButton1) hacia abajo.

Un puntero táctil no usa esta marca.

Un puntero de lápiz no usa esta marca.

Un puntero del mouse tiene esta marca establecida cuando el primer botón extendido del mouse (XBUTTON1) está inactivo.

POINTER_FLAG_FIFTHBUTTON

0x00000100

Análogo a un segundo botón extendido del mouse (XButton2) hacia abajo.

Un puntero táctil no usa esta marca.

Un puntero de lápiz no usa esta marca.

Un puntero del mouse tiene esta marca establecida cuando el segundo botón de mouse extendido (XBUTTON2) está inactivo.

POINTER_FLAG_PRIMARY

0x00002000

Indica que este puntero se ha designado como puntero principal. Un puntero principal es un único puntero que puede realizar acciones más allá de las disponibles para punteros no principales. Por ejemplo, cuando un puntero principal hace contacto con una superficie de ventana, puede proporcionar a la ventana una oportunidad de activar mediante el envío de un mensaje de WM_POINTERACTIVATE .

El puntero principal se identifica a partir de todas las interacciones actuales del usuario en el sistema (mouse, táctil, lápiz, etc.). Por lo tanto, es posible que el puntero principal no esté asociado a la aplicación. El primer contacto de una interacción multitáctil se establece como puntero principal. Una vez identificado un puntero principal, se deben levantar todos los contactos antes de que se pueda identificar un nuevo contacto como puntero principal. En el caso de las aplicaciones que no procesan la entrada del puntero, solo se promueven los eventos del puntero principal a los eventos del mouse.

POINTER_FLAG_CONFIDENCE

0x000004000

La confianza es una sugerencia del dispositivo de origen sobre si el puntero representa una interacción intencionada o accidental, que es especialmente relevante para PT_TOUCH punteros en los que una interacción accidental (por ejemplo, con la palma de la mano) puede desencadenar la entrada. La presencia de esta marca indica que el dispositivo de origen tiene una confianza alta de que esta entrada forma parte de una interacción prevista.

POINTER_FLAG_CANCELED

0x000008000

Indica que el puntero sale de forma anómala, como cuando el sistema recibe una entrada no válida para el puntero o cuando un dispositivo con punteros activos sale abruptamente. Si la aplicación que recibe la entrada está en una posición para hacerlo, debe tratar la interacción como no completada e invertir los efectos del puntero en cuestión.

POINTER_FLAG_DOWN

0x00010000

Indica que este puntero ha pasado a un estado inactivo; es decir, hizo contacto con la superficie del digitalizador.

POINTER_FLAG_UPDATE

0x00020000

Indica que se trata de una actualización simple que no incluye cambios de estado de puntero.

POINTER_FLAG_UP

0x00040000

Indica que este puntero ha pasado a un estado ascendente; es decir, el contacto con la superficie del digitalizador finalizó.

POINTER_FLAG_WHEEL

0x00080000

Indica la entrada asociada a una rueda del puntero. En el caso de los punteros del mouse, esto equivale a la acción de la rueda del mouse (WM_MOUSEHWHEEL).

POINTER_FLAG_HWHEEL

0x00100000

Indica la entrada asociada a una rueda h del puntero. En el caso de los punteros del mouse, esto equivale a la acción de la rueda de desplazamiento horizontal del mouse (WM_MOUSEHWHEEL).

POINTER_FLAG_CAPTURECHANGED

0x00200000

Indica que este puntero fue capturado por (asociado a) otro elemento y el elemento original ha perdido la captura (vea WM_POINTERCAPTURECHANGED).

POINTER_FLAG_HASTRANSFORM

0x00400000

Indica que este puntero tiene una transformación asociada.

Comentarios

XBUTTON1 y XBUTTON2 son botones adicionales que se usan en muchos dispositivos de mouse. Devuelven los mismos datos que los botones estándar del mouse.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Encabezado	Winuser.h

Consulte también

Constantes

POINTER_INFO

POINTER_BUTTON_CHANGE_TYPE