Zeigerflags

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

POINTER_FLAG_NONE

0x00000000

Standard

POINTER_FLAG_NEW

0x00000001

Gibt den Eingang eines neuen Zeigers an.

POINTER_FLAG_INRANGE

0x00000002

Gibt an, dass dieser Zeiger weiterhin vorhanden ist. Wenn dieses Flag nicht festgelegt ist, gibt es an, dass der Zeiger über den linken Erkennungsbereich verfügt.

Dieses Flag wird in der Regel nicht nur festgelegt, wenn ein Zeiger mit dem Mauszeiger 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 Zeigenzeiger an.

POINTER_FLAG_FIRSTBUTTON

0x00000010

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

Für einen Touchzeiger ist dieses Flag festgelegt, wenn es mit der Digitizeroberfläche in Kontakt steht.

Für einen Stiftzeiger ist dieses Flag festgelegt, wenn es mit der Digitizeroberfläche in Kontakt steht und keine Schaltflächen gedrückt werden.

Für einen Mauszeiger ist dieses Flag festgelegt, wenn die linke Maustaste gedrückt ist.

POINTER_FLAG_SECONDBUTTON

0x00000020

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

Ein Fingereingabezeiger verwendet dieses Flag nicht.

Für einen Stiftzeiger ist dieses Flag festgelegt, wenn es mit der Digitizeroberfläche in Kontakt steht und die Stiftschaltfläche gedrückt wird.

Für einen Mauszeiger ist dieses Flag festgelegt, wenn die rechte Maustaste gedrückt ist.

POINTER_FLAG_THIRDBUTTON

0x00000040

Analog zu einer Mausradschaltfläche nach unten.

Ein Fingereingabezeiger verwendet dieses Flag nicht.

Ein Stiftzeiger verwendet dieses Flag nicht.

Für einen Mauszeiger ist dieses Flag festgelegt, wenn das Mausrad gedrückt ist.

POINTER_FLAG_FOURTHBUTTON

0x00000080

Analog zu einer ersten erweiterten Mausschaltfläche (XButton1) nach unten.

Ein Fingereingabezeiger verwendet dieses Flag nicht.

Ein Stiftzeiger verwendet dieses Flag nicht.

Für einen Mauszeiger ist dieses Flag festgelegt, wenn die erste erweiterte Mausschaltfläche (XBUTTON1) ausgeschaltet ist.

POINTER_FLAG_FIFTHBUTTON

0x00000100

Analog zu einer zweiten erweiterten Mausschaltfläche (XButton2) nach unten.

Ein Fingereingabezeiger verwendet dieses Flag nicht.

Ein Stiftzeiger verwendet dieses Flag nicht.

Für einen Mauszeiger ist dieses Flag festgelegt, wenn die zweite erweiterte Mausschaltfläche (XBUTTON2) ausgeschaltet ist.

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 nimmt, kann er dem Fenster die Möglichkeit geben, sich zu aktivieren, indem er ihm eine WM_POINTERACTIVATE Nachricht sendet.

Der primäre Zeiger wird aus allen aktuellen Benutzerinteraktionen auf dem System identifiziert (Maus, Fingereingabe, Stift usw.). Daher ist der primäre Zeiger ihrer App möglicherweise nicht zugeordnet. Der erste Kontakt in einer Multitouch-Interaktion 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 zeigereingaben nicht verarbeiten, werden nur die Ereignisse des primären Zeigers zu Mausereignissen heraufgestuft.

POINTER_FLAG_CONFIDENCE

0x000004000

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

POINTER_FLAG_CANCELED

0x000008000

Gibt an, dass der Zeiger auf ungewöhnliche Weise abweicht, z. B. wenn das System ungültige Eingaben für den Zeiger empfängt oder wenn ein Gerät mit aktiven Zeigern plötzlich ausfällt. Wenn die Anwendung, die die Eingabe empfängt, 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 Abwärtszustand übergewechselt wurde. d.h. es hat Kontakt mit der Digitizeroberfläche hergestellt.

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 einen Nach-oben-Zustand übergewechselt wurde. Das heißt, der Kontakt mit der Digitizeroberfläche wurde beendet.

POINTER_FLAG_WHEEL

0x00080000

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

POINTER_FLAG_HWHEEL

0x00100000

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

POINTER_FLAG_CAPTURECHANGED

0x00200000

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

POINTER_FLAG_HASTRANSFORM

0x00400000

Gibt an, dass diesem Zeiger eine Transformation zugeordnet ist.

Bemerkungen

XBUTTON1 und XBUTTON2 sind zusätzliche Schaltflächen, die auf vielen Mausgeräten verwendet werden. Sie geben die gleichen Daten wie Standard-Maustasten zurück.

Requirements (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

Weitere Informationen

Konstanten

POINTER_INFO

POINTER_BUTTON_CHANGE_TYPE