Sinalizadores de mensagem de ponteiro

Valores que são usados em várias macros de ponteiro (consulte Macros).

POINTER_MESSAGE_FLAG_NEW

POINTER_MESSAGE_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_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 ponteiro pairando.

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

POINTER_MESSAGE_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_MESSAGE_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_MESSAGE_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_MESSAGE_FLAG_CONFIDENCE

0x00000400
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_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 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.

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.

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