Flag puntatore

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

POINTER_FLAG_NONE

0x00000000

Predefinito

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 a contatto con una superficie di finestra lascia l'intervallo di rilevamento (POINTER_FLAG_UP è impostato).

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 del mouse sinistro verso il basso.

Un puntatore a 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 è giù.

POINTER_FLAG_SECONDBUTTON

0x00000020

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

Un puntatore a tocco non usa questo flag.

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

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

POINTER_FLAG_THIRDBUTTON

0x00000040

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

Un puntatore a 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 è giù.

POINTER_FLAG_FOURTHBUTTON

0x00000080

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

Un puntatore a 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

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

Un puntatore a tocco non usa questo flag.

Un puntatore penna non usa questo flag.

Un puntatore del mouse ha questo flag impostato quando il secondo pulsante del mouse esteso (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 fa contatto con una superficie di una finestra, può fornire la finestra un'opportunità di attivazione inviando un messaggio di WM_POINTERACTIVATE .

Il puntatore primario 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 multi-tocco 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, vengono promossi solo gli eventi del puntatore primario agli eventi del mouse.

POINTER_FLAG_CONFIDENCE

0x000004000

La fiducia è un suggerimento del dispositivo di origine sul fatto che il puntatore rappresenti un'interazione intenzionale o accidentale, che è 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 attendibilità che questo input fa parte di un'interazione prevista.

POINTER_FLAG_CANCELED

0x000008000

Indica che il puntatore viene interrotto in modo anomalo, ad esempio quando il sistema riceve un input non valido per il puntatore o quando un dispositivo con puntatori attivi viene interrotto 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; ovvero, 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 di up; ovvero, contatto con la superficie del digitalizzatore terminata.

POINTER_FLAG_WHEEL

0x00080000

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

POINTER_FLAG_HWHEEL

0x00100000

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

POINTER_FLAG_CAPTURECHANGED

0x00200000

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

POINTER_FLAG_HASTRANSFORM

0x00400000

Indica che questo puntatore ha una trasformazione associata.

Commenti

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

Requisiti

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

Vedi anche

Costanti

POINTER_INFO

POINTER_BUTTON_CHANGE_TYPE