Sinalizadores de ponteiro

Valores que podem aparecer no campo pointerFlags da estrutura POINTER_INFO.

POINTER_FLAG_NONE

0x00000000

Inadimplência

POINTER_FLAG_NEW

0x00000001

Indica a chegada de um novo ponteiro.

POINTER_FLAG_INRANGE

0x00000002

Indica que esse ponteiro continua a existir. Quando esse sinalizador não está definido, ele indica que o ponteiro deixou o intervalo de deteção.

Esse sinalizador normalmente não é definido apenas quando um ponteiro pairando deixa o intervalo de deteção (POINTER_FLAG_UPDATE está definido) ou quando um ponteiro em contato com uma superfície de janela deixa o intervalo de deteçã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 ponteiro pairando.

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 do cano da 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 da roda do mouse está inativo.

POINTER_FLAG_FOURTHBUTTON

0x00000080

Análogo a um primeiro mouse estendido (XButton1) botão 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 mouse estendido (XButton2) botão 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 ponteiro único que pode executar ações além daquelas disponíveis para ponteiros não primários. Por exemplo, quando um ponteiro primário entra em contato com a superfície de uma janela, ele pode fornecer à janela uma oportunidade de ativação, enviando-lhe uma mensagem WM_POINTERACTIVATE.

O ponteiro principal é identificado a partir de todas as interações atuais do usuário no sistema (mouse, toque, caneta e assim por diante). Como tal, o ponteiro principal pode não estar associado à sua aplicação. O primeiro contato em uma interação multitoque é definido como o ponteiro principal. Uma vez 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 do ponteiro, apenas os eventos do ponteiro principal são promovidos para eventos do mouse.

POINTER_FLAG_CONFIDENCE

0x000004000

A confiança é uma sugestão do dispositivo de origem sobre se o ponteiro representa uma interação intencional ou acidental, o que é especialmente relevante para PT_TOUCH ponteiros onde uma interação acidental (como com a palma da mão) pode desencadear 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 condições de fazê-lo, ele deve 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 transitou para um estado inativo; ou seja, fez contato com a superfície do digitalizador.

POINTER_FLAG_UPDATE

0x00020000

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

POINTER_FLAG_UP

0x00040000

Indica que esse ponteiro transitou para um estado ascendente; 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 uma roda h de ponteiro. 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 que 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.

Requerimentos

Exigência	Valor
Cliente mínimo suportado	Windows 8 [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado	Windows Server 2012 [apenas aplicações de ambiente de trabalho]
Cabeçalho	Winuser.h

Ver também

constantes

POINTER_INFO

POINTER_BUTTON_CHANGE_TYPE