Zeigerflags

Werte, die im ZeigerFlags-Feld der POINTER_INFO-Struktur angezeigt werden können.

POINTER_FLAG_NONE

0x00000000

Standard

POINTER_FLAG_NEW

0x00000001

Gibt die Ankunft eines neuen Zeigers an.

POINTER_FLAG_INRANGE

0x00000002

Gibt an, dass dieser Zeiger weiterhin vorhanden ist. Wenn dieses Flag nicht festgelegt ist, gibt dies an, dass der Zeiger den Erkennungsbereich verlassen hat.

Dieses Flag wird in der Regel nicht nur festgelegt, wenn ein zeigender Zeiger den Erkennungsbereich verlässt (POINTER_FLAG_UPDATE festgelegt ist) oder wenn ein Zeiger in Kontakt mit einer Fensteroberfläche den Erkennungsbereich verlässt (POINTER_FLAG_UP festgelegt ist).

POINTER_FLAG_INCONTACT

0x00000004

Gibt an, dass dieser Zeiger mit der Digitizeroberfläche in Kontakt steht. Wenn dieses Flag nicht festgelegt ist, gibt es einen zeigernden Zeiger an.

POINTER_FLAG_FIRSTBUTTON

0x00000010

Gibt eine primäre Aktion an, analog zu einer linken Maustaste nach unten.

Ein Touchzeiger hat dieses Flag festgelegt, wenn er mit der Digitizeroberfläche in Kontakt kommt.

Ein Stiftzeiger hat dieses Flag festgelegt, wenn er mit der Digitizeroberfläche in Kontakt kommt, ohne dass Schaltflächen gedrückt werden.

Bei einem Mauszeiger ist dieses Flag festgelegt, wenn die linke Maustaste ausfällt.

POINTER_FLAG_SECONDBUTTON

0x00000020

Gibt eine sekundäre Aktion an, analog zu einer rechten Maustaste nach unten.

Ein Touchzeiger verwendet dieses Flag nicht.

Ein Stiftzeiger hat dieses Flag festgelegt, wenn er mit der Digitizeroberfläche in Kontakt kommt und die Stiftlauftaste gedrückt ist.

Bei einem Mauszeiger ist dieses Flag festgelegt, wenn die rechte Maustaste ausfällt.

POINTER_FLAG_THIRDBUTTON

0x00000040

Analog zu einer Mausradtaste nach unten.

Ein Touchzeiger verwendet dieses Flag nicht.

Ein Stiftzeiger verwendet dieses Flag nicht.

Bei einem Mauszeiger ist dieses Flag festgelegt, wenn die Maustaste ausfällt.

POINTER_FLAG_FOURTHBUTTON

0x00000080

Analog zu einer ersten erweiterten Maustaste (XButton1) nach unten.

Ein Touchzeiger verwendet dieses Flag nicht.

Ein Stiftzeiger verwendet dieses Flag nicht.

Bei einem Mauszeiger ist dieses Flag festgelegt, wenn die erste erweiterte Maustaste (XBUTTON1) ausfällt.

POINTER_FLAG_FIFTHBUTTON

0x00000100

Analog zu einer zweiten erweiterten Maustaste (XButton2) nach unten.

Ein Touchzeiger verwendet dieses Flag nicht.

Ein Stiftzeiger verwendet dieses Flag nicht.

Bei einem Mauszeiger ist dieses Flag festgelegt, wenn die zweite erweiterte Maustaste (XBUTTON2) ausfällt.

POINTER_FLAG_PRIMARY

0x00002000

Gibt an, dass dieser Zeiger als primärer Zeiger festgelegt wurde. Ein primärer Zeiger ist ein einzelner Zeiger, der Aktionen ausführen kann, die über diejenigen hinausgehen, die für nicht primäre Zeiger verfügbar sind. Wenn beispielsweise ein primärer Zeiger kontakt mit der Oberfläche eines Fensters kontaktiert, kann er dem Fenster die Möglichkeit bieten, sich zu aktivieren, indem er eine WM_POINTERACTIVATE Nachricht sendet.

Der primäre Zeiger wird anhand aller aktuellen Benutzerinteraktionen auf dem System (Maus, Berührung, Stift usw.) identifiziert. Daher ist der primäre Zeiger möglicherweise nicht Ihrer App zugeordnet. Der erste Kontakt in einer Multitouchinteraktion wird als primärer Zeiger festgelegt. Sobald ein primärer Zeiger identifiziert wurde, müssen alle Kontakte aufgehoben werden, bevor ein neuer Kontakt als primärer Zeiger identifiziert werden kann. Für Apps, die keine Zeigereingabe verarbeiten, werden nur die Ereignisse des primären Zeigers zu Mausereignissen heraufgestuft.

POINTER_FLAG_CONFIDENCE

0x000004000

Vertrauen ist ein Vorschlag des Quellgeräts darüber, ob der Zeiger eine beabsichtigte oder versehentliche Interaktion darstellt. Dies ist besonders relevant für PT_TOUCH Zeiger, bei denen eine versehentliche Interaktion (z. B. mit der Handfläche) Eingaben auslösen kann. Das Vorhandensein dieses Flags weist darauf hin, dass das Quellgerät eine hohe Sicherheit hat, dass diese Eingabe Teil einer beabsichtigten Interaktion ist.

POINTER_FLAG_CANCELED

0x000008000

Gibt an, dass der Zeiger auf ungewöhnliche Weise abfährt, z. B. wenn das System ungültige Eingaben für den Zeiger empfängt oder wenn ein Gerät mit aktiven Zeigern abrupt abfährt. Wenn die Anwendung, die die Eingabe erhält, dazu in der Lage ist, sollte sie die Interaktion als nicht abgeschlossen behandeln und alle Auswirkungen des betreffenden Zeigers umkehren.

POINTER_FLAG_DOWN

0x00010000

Gibt an, dass dieser Zeiger in einen down-Zustand übergestellt wurde; Das heißt, es hat Kontakt mit der Digitizeroberfläche.

POINTER_FLAG_UPDATE

0x00020000

Gibt an, dass dies ein einfaches Update ist, das keine Zeigerzustandsänderungen enthält.

POINTER_FLAG_UP

0x00040000

Gibt an, dass dieser Zeiger in den Status "Up" übergewechselt wurde. das heißt, der Kontakt mit der Digitizeroberfläche ist beendet.

POINTER_FLAG_WHEEL

0x00080000

Gibt eine Eingabe an, die einem Zeigerrad zugeordnet ist. Bei Mauszeigern entspricht dies der Aktion des Mauslaufrads (WM_MOUSEHWHEEL).

POINTER_FLAG_HWHEEL

0x00100000

Gibt eine Eingabe an, die einem Zeiger-H-Rad zugeordnet ist. Bei Mauszeigern entspricht dies der Aktion des horizontalen Mauslaufrads (WM_MOUSEHWHEEL).

POINTER_FLAG_CAPTURECHANGED

0x00200000

Gibt an, dass dieser Zeiger von einem anderen Element erfasst wurde (zugeordnet) wurde und das ursprüngliche Element die Erfassung verloren hat (siehe WM_POINTERCAPTURECHANGED).

POINTER_FLAG_HASTRANSFORM

0x00400000

Gibt an, dass dieser Zeiger über eine zugeordnete Transformation verfügt.

Bemerkungen

XBUTTON1 und XBUTTON2 sind zusätzliche Tasten, die auf vielen Mausgeräten verwendet werden. Sie geben dieselben Daten wie Standardmaustasten zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Header	Winuser.h

Siehe auch

Konstanten

POINTER_INFO

POINTER_BUTTON_CHANGE_TYPE