Sinalizadores de mensagem de ponteiro

Valores usados em várias macros de ponteiro (consulte Macros).

POINTER_MESSAGE_FLAG_NEW

POINTER_MESSAGE_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 de foco 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_MESSAGE_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_MESSAGE_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_MESSAGE_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 barril de caneta pressionado. Um ponteiro do mouse tem esse sinalizador definido quando o botão direito do mouse está inativo.

POINTER_MESSAGE_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_MESSAGE_FLAG_FOURTHBUTTON

0x00000080
Análogo a um primeiro botão de mouse estendido (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 de mouse estendido (XBUTTON1) está inativo.

POINTER_MESSAGE_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 de mouse estendido (XBUTTON2) está inativo.

POINTER_MESSAGE_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, apenas os eventos do ponteiro primário são promovidos para eventos do mouse.

POINTER_MESSAGE_FLAG_CONFIDENCE

0x00000400
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_MESSAGE_FLAG_CANCELED

0x00000800
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.

Comentários

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

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