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