Zeigernachrichtenkennzeichnungen

Werte, die in verschiedenen Zeigermakros verwendet werden (siehe Makros).

POINTER_MESSAGE_FLAG_NEW

POINTER_MESSAGE_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_MESSAGE_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_MESSAGE_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_MESSAGE_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_MESSAGE_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_MESSAGE_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_MESSAGE_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_MESSAGE_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_MESSAGE_FLAG_CONFIDENCE

0x00000400
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_MESSAGE_FLAG_CANCELED

0x00000800
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.

Bemerkungen

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

Anforderung	Wert
Mindestens unterstützter Client	Windows 8 [nur Desktop-Apps]
Mindestens unterstützter Server	Windows Server 2012 [nur Desktop-Apps]
Kopfball	Winuser.h