Zeigerkennzeichnungen

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

POINTER_FLAG_NONE

0x00000000

Vorgabe

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 es an, dass der Zeiger den Erkennungsbereich verlassen hat.

Diese Kennzeichnung wird in der Regel nicht nur festgelegt, wenn ein 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 Digitalisiereroberfläche in Kontakt steht. Wenn dieses Flag nicht festgelegt ist, gibt es einen Zeiger mit dem Mauszeiger an.

POINTER_FLAG_FIRSTBUTTON

0x00000010

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

Ein Touchzeiger hat diese Kennzeichnung festgelegt, wenn er mit der Digitalisierungsoberfläche in Kontakt steht.

Ein Stiftzeiger hat dieses Kennzeichen festgelegt, wenn er mit der Digitalisierungsgerätoberfläche kontaktiert ist, ohne dass Schaltflächen gedrückt werden.

Ein Mauszeiger hat dieses Kennzeichen 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 Kennzeichen nicht.

Ein Stiftzeiger hat diese Kennzeichnung festgelegt, wenn er mit der Digitalisierungsgerätoberfläche mit gedrückter Drucktaste des Stifts in Kontakt steht.

Ein Mauszeiger hat diese Kennzeichnung festgelegt, wenn die rechte Maustaste gedrückt ist.

POINTER_FLAG_THIRDBUTTON

0x00000040

Analog zu einer Mausradtaste nach unten.

Ein Fingereingabezeiger verwendet dieses Kennzeichen nicht.

Ein Stiftzeiger verwendet dieses Kennzeichen nicht.

Ein Mauszeiger hat diese Kennzeichnung festgelegt, wenn die Maustaste gedrückt ist.

POINTER_FLAG_FOURTHBUTTON

0x00000080

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

Ein Fingereingabezeiger verwendet dieses Kennzeichen nicht.

Ein Stiftzeiger verwendet dieses Kennzeichen nicht.

Ein Mauszeiger hat diese Kennzeichnung festgelegt, wenn die erste erweiterte Maustaste (XBUTTON1) gedrückt ist.

POINTER_FLAG_FIFTHBUTTON

0x00000100

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

Ein Fingereingabezeiger verwendet dieses Kennzeichen nicht.

Ein Stiftzeiger verwendet dieses Kennzeichen nicht.

Ein Mauszeiger hat diese Kennzeichnung festgelegt, wenn die zweite erweiterte Maustaste (XBUTTON2) nach unten 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 für nicht primäre Zeiger verfügbar sind. Wenn beispielsweise ein primärer Zeiger Kontakt mit einer Fensteroberfläche macht, kann es dem Fenster die Möglichkeit bieten, es zu aktivieren, indem er eine WM_POINTERACTIVATE Nachricht sendet.

Der primäre Zeiger wird aus allen aktuellen Benutzerinteraktionen auf dem System (Maus, Toucheingabe, Stift usw.) identifiziert. Daher ist der primäre Zeiger möglicherweise nicht mit Ihrer App verknüpft. 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. Bei Apps, die zeigereingaben nicht verarbeiten, werden nur die Ereignisse des primären Zeigers auf Mausereignisse heraufgestuft.

POINTER_FLAG_CONFIDENCE

0x000004000

Konfidenz ist ein Vorschlag des Quellgeräts darüber, ob der Zeiger eine beabsichtigte oder versehentliche Interaktion darstellt, die insbesondere für PT_TOUCH Zeiger relevant ist, 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 eine hohe Vertrauenswürdigkeit hat, dass diese Eingabe Teil einer beabsichtigten Interaktion ist.

POINTER_FLAG_CANCELED

0x000008000

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

POINTER_FLAG_DOWN

0x00010000

Gibt an, dass dieser Zeiger in einen Abwärtszustand umgestellt wurde; d. h., es hat Kontakt mit der Digitalisiereroberflä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 Aufwärtszustand umgestellt wurde; d. h., Kontakt mit der Digitalisierungsoberfläche endete.

POINTER_FLAG_WHEEL

0x00080000

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

POINTER_FLAG_HWHEEL

0x00100000

Gibt die Eingabe an, die einem Zeiger-H-Rad zugeordnet ist. Bei Mauszeigern entspricht dies der Aktion des horizontalen Bildlaufrads der Maus (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 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 Standard-Maustasten zurück.

Anforderungen

Siehe auch

Konstanten

POINTER_INFO

POINTER_BUTTON_CHANGE_TYPE