Flag puntatore

Valori che possono essere visualizzati nel campo puntatoreFlags della struttura POINTER_INFO.

POINTER_FLAG_NONE

0x00000000

Default

POINTER_FLAG_NEW

0x00000001

Indica l'arrivo di un nuovo puntatore.

POINTER_FLAG_INRANGE

0x00000002

Indica che questo puntatore continua a esistere. Quando questo flag non è impostato, indica che il puntatore ha lasciato l'intervallo di rilevamento.

Questo flag non viene in genere impostato solo quando un puntatore al passaggio del mouse lascia l'intervallo di rilevamento (POINTER_FLAG_UPDATE è impostato) o quando un puntatore in contatto con una superficie di finestra lascia l'intervallo di rilevamento ( viene impostatoPOINTER_FLAG_UP).

POINTER_FLAG_INCONTACT

0x00000004

Indica che questo puntatore è in contatto con la superficie del digitalizzatore. Quando questo flag non è impostato, indica un puntatore al passaggio del mouse.

POINTER_FLAG_FIRSTBUTTON

0x00000010

Indica un'azione primaria, analoga a un pulsante sinistro del mouse verso il basso.

Un puntatore tocco ha questo flag impostato quando è in contatto con la superficie del digitalizzatore.

Un puntatore penna ha questo flag impostato quando è in contatto con la superficie del digitalizzatore senza pulsanti premuti.

Un puntatore del mouse ha questo flag impostato quando il pulsante sinistro del mouse è inattivo.

POINTER_FLAG_SECONDBUTTON

0x00000020

Indica un'azione secondaria, analoga a un pulsante destro del mouse verso il basso.

Un puntatore tocco non usa questo flag.

Un puntatore penna ha questo flag impostato quando è in contatto con la superficie del digitalizzatore con il pulsante della penna a barile premuto.

Un puntatore del mouse ha questo flag impostato quando il pulsante destro del mouse è inattivo.

POINTER_FLAG_THIRDBUTTON

0x00000040

Analogo a un pulsante della rotellina del mouse verso il basso.

Un puntatore tocco non usa questo flag.

Un puntatore penna non usa questo flag.

Un puntatore del mouse ha questo flag impostato quando il pulsante della rotellina del mouse è inattivo.

POINTER_FLAG_FOURTHBUTTON

0x00000080

Analogo a un primo pulsante esteso del mouse (XButton1).

Un puntatore tocco non usa questo flag.

Un puntatore penna non usa questo flag.

Un puntatore del mouse ha questo flag impostato quando il primo pulsante del mouse esteso (XBUTTON1) è inattivo.

POINTER_FLAG_FIFTHBUTTON

0x00000100

Analogo a un secondo pulsante esteso del mouse (XButton2) verso il basso.

Un puntatore tocco non usa questo flag.

Un puntatore penna non usa questo flag.

Un puntatore del mouse ha questo flag impostato quando il secondo pulsante esteso del mouse (XBUTTON2) è inattivo.

POINTER_FLAG_PRIMARY

0x00002000

Indica che questo puntatore è stato designato come puntatore primario. Un puntatore primario è un singolo puntatore che può eseguire azioni oltre a quelle disponibili per i puntatori non primari. Ad esempio, quando un puntatore primario effettua il contatto con una superficie di una finestra, può fornire alla finestra un'opportunità di attivazione inviando un messaggio di WM_POINTERACTIVATE.

Il puntatore principale viene identificato da tutte le interazioni utente correnti nel sistema (mouse, tocco, penna e così via). Di conseguenza, il puntatore primario potrebbe non essere associato all'app. Il primo contatto in un'interazione multitocco viene impostato come puntatore primario. Una volta identificato un puntatore primario, tutti i contatti devono essere revocati prima che un nuovo contatto possa essere identificato come puntatore primario. Per le app che non elaborano l'input del puntatore, solo gli eventi del puntatore primario vengono promossi agli eventi del mouse.

POINTER_FLAG_CONFIDENCE

0x000004000

L'attendibilità è un suggerimento del dispositivo di origine sul fatto che il puntatore rappresenti un'interazione intenzionale o accidentale, particolarmente rilevante per i puntatori PT_TOUCH in cui un'interazione accidentale (ad esempio con il palmo della mano) può attivare l'input. La presenza di questo flag indica che il dispositivo di origine ha un'elevata probabilità che questo input faccia parte di un'interazione prevista.

POINTER_FLAG_CANCELED

0x000008000

Indica che il puntatore parte in modo anomalo, ad esempio quando il sistema riceve un input non valido per il puntatore o quando un dispositivo con puntatori attivi parte bruscamente. Se l'applicazione che riceve l'input è in grado di farlo, deve considerare l'interazione come non completata e invertire eventuali effetti del puntatore interessato.

POINTER_FLAG_DOWN

0x00010000

Indica che questo puntatore è passato a uno stato inattivo; cioè, ha fatto contatto con la superficie del digitalizzatore.

POINTER_FLAG_UPDATE

0x00020000

Indica che si tratta di un semplice aggiornamento che non include modifiche dello stato del puntatore.

POINTER_FLAG_UP

0x00040000

Indica che questo puntatore è passato a uno stato attivo; cioè, contatto con la superficie del digitalizzatore terminata.

POINTER_FLAG_WHEEL

0x00080000

Indica l'input associato a una rotellina del puntatore. Per i puntatori del mouse, equivale all'azione della rotellina del mouse (WM_MOUSEHWHEEL).

POINTER_FLAG_HWHEEL

0x00100000

Indica l'input associato a un puntatore h-wheel. Per i puntatori del mouse, equivale all'azione della rotellina orizzontale del mouse (WM_MOUSEHWHEEL).

POINTER_FLAG_CAPTURECHANGED

0x00200000

Indica che questo puntatore è stato acquisito da (associato a) un altro elemento e che l'elemento originale ha perso l'acquisizione (vedere WM_POINTERCAPTURECHANGED).

POINTER_FLAG_HASTRANSFORM

0x00400000

Indica che questo puntatore ha una trasformazione associata.

Osservazioni

XBUTTON1 e XBUTTON2 sono pulsanti aggiuntivi usati in molti dispositivi del mouse. Restituiscono gli stessi dati dei pulsanti standard del mouse.

Fabbisogno

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Intestazione	Winuser.h

Vedere anche

costanti

POINTER_INFO

POINTER_BUTTON_CHANGE_TYPE