Sinalizadores de ponteiro

Valores que podem aparecer no campo pointerFlags da estrutura POINTER_INFO .

POINTER_FLAG_NONE

0x00000000

Padrão

POINTER_FLAG_NEW

0x00000001

Indica a chegada de um novo ponteiro.

POINTER_FLAG_INRANGE

0x00000002

Indica que esse ponteiro continua existindo. Quando esse sinalizador não está definido, ele indica que o ponteiro tem o intervalo de detecção à esquerda.

Normalmente, esse sinalizador não é definido somente quando um ponteiro focalizado deixa o intervalo de detecção (POINTER_FLAG_UPDATE está definido) ou quando um ponteiro em contato com uma superfície de janela deixa o intervalo de detecção (POINTER_FLAG_UP está definido).

POINTER_FLAG_INCONTACT

0x00000004

Indica que esse ponteiro está em contato com a superfície do digitalizador. Quando esse sinalizador não está definido, ele indica um ponteiro de foco.

POINTER_FLAG_FIRSTBUTTON

0x00000010

Indica uma ação primária, análoga a um botão esquerdo do mouse para baixo.

Um ponteiro de toque tem esse sinalizador definido quando está em contato com a superfície do digitalizador.

Um ponteiro de caneta tem esse sinalizador definido quando está em contato com a superfície do digitalizador sem botões pressionados.

Um ponteiro do mouse tem esse sinalizador definido quando o botão esquerdo do mouse está inativo.

POINTER_FLAG_SECONDBUTTON

0x00000020

Indica uma ação secundária, análoga a um botão direito do mouse para baixo.

Um ponteiro de toque não usa esse sinalizador.

Um ponteiro de caneta tem esse sinalizador definido quando está em contato com a superfície do digitalizador com o botão de caneta pressionado.

Um ponteiro do mouse tem esse sinalizador definido quando o botão direito do mouse está inativo.

POINTER_FLAG_THIRDBUTTON

0x00000040

Análogo a um botão de roda do mouse para baixo.

Um ponteiro de toque não usa esse sinalizador.

Um ponteiro de caneta não usa esse sinalizador.

Um ponteiro do mouse tem esse sinalizador definido quando o botão de roda do mouse está inativo.

POINTER_FLAG_FOURTHBUTTON

0x00000080

Análogo a um primeiro botão estendido do mouse (XButton1) para baixo.

Um ponteiro de toque não usa esse sinalizador.

Um ponteiro de caneta não usa esse sinalizador.

Um ponteiro do mouse tem esse sinalizador definido quando o primeiro botão estendido do mouse (XBUTTON1) está inativo.

POINTER_FLAG_FIFTHBUTTON

0x00000100

Análogo a um segundo botão estendido do mouse (XButton2) para baixo.

Um ponteiro de toque não usa esse sinalizador.

Um ponteiro de caneta não usa esse sinalizador.

Um ponteiro do mouse tem esse sinalizador definido quando o segundo botão estendido do mouse (XBUTTON2) está inativo.

POINTER_FLAG_PRIMARY

0x00002000

Indica que esse ponteiro foi designado como o ponteiro primário. Um ponteiro primário é um único ponteiro que pode executar ações além daquelas disponíveis para ponteiros não primários. Por exemplo, quando um ponteiro primário faz contato com a superfície de uma janela, ele pode fornecer à janela uma oportunidade de ativar enviando-lhe uma mensagem WM_POINTERACTIVATE .

O ponteiro primário é identificado de todas as interações atuais do usuário no sistema (mouse, toque, caneta e assim por diante). Dessa forma, o ponteiro primário pode não estar associado ao seu aplicativo. O primeiro contato em uma interação de vários toques é definido como o ponteiro primário. Depois que um ponteiro primário é identificado, todos os contatos devem ser levantados antes que um novo contato possa ser identificado como um ponteiro primário. Para aplicativos que não processam a entrada de ponteiro, somente os eventos do ponteiro primário são promovidos a eventos do mouse.

POINTER_FLAG_CONFIDENCE

0x000004000

Confiança é uma sugestão do dispositivo de origem sobre se o ponteiro representa uma interação pretendida ou acidental, que é especialmente relevante para ponteiros PT_TOUCH em que uma interação acidental (como com a palma da mão) pode disparar a entrada. A presença desse sinalizador indica que o dispositivo de origem tem alta confiança de que essa entrada faz parte de uma interação pretendida.

POINTER_FLAG_CANCELED

0x000008000

Indica que o ponteiro está partindo de maneira anormal, como quando o sistema recebe entrada inválida para o ponteiro ou quando um dispositivo com ponteiros ativos parte abruptamente. Se o aplicativo que recebe a entrada estiver em uma posição para fazer isso, ele deverá tratar a interação como não concluída e reverter quaisquer efeitos do ponteiro em questão.

POINTER_FLAG_DOWN

0x00010000

Indica que esse ponteiro fez a transição para um estado inativo; ou seja, ele fez contato com a superfície do digitalizador.

POINTER_FLAG_UPDATE

0x00020000

Indica que essa é uma atualização simples que não inclui alterações de estado do ponteiro.

POINTER_FLAG_UP

0x00040000

Indica que esse ponteiro fez a transição para um estado acima; ou seja, o contato com a superfície do digitalizador terminou.

POINTER_FLAG_WHEEL

0x00080000

Indica a entrada associada a uma roda de ponteiro. Para ponteiros do mouse, isso é equivalente à ação da roda de rolagem do mouse (WM_MOUSEHWHEEL).

POINTER_FLAG_HWHEEL

0x00100000

Indica a entrada associada a um ponteiro h-wheel. Para ponteiros do mouse, isso é equivalente à ação da roda de rolagem horizontal do mouse (WM_MOUSEHWHEEL).

POINTER_FLAG_CAPTURECHANGED

0x00200000

Indica que esse ponteiro foi capturado por (associado a) outro elemento e o elemento original perdeu a captura (consulte WM_POINTERCAPTURECHANGED).

POINTER_FLAG_HASTRANSFORM

0x00400000

Indica que esse ponteiro tem uma transformação associada.

Comentários

XBUTTON1 e XBUTTON2 são botões adicionais usados em muitos dispositivos de mouse. Eles retornam os mesmos dados que os botões padrão do mouse.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho	Winuser.h

Confira também

Constantes

POINTER_INFO

POINTER_BUTTON_CHANGE_TYPE