Flagi komunikatów wskaźnika

Wartości używane w różnych makrach wskaźnika (zobacz Makra).

POINTER_MESSAGE_FLAG_NEW

POINTER_MESSAGE_FLAG_INRANGE

0x00000002
Wskazuje, że ten wskaźnik nadal istnieje. Jeśli ta flaga nie jest ustawiona, wskazuje, że wskaźnik ma zakres wykrywania po lewej stronie.

Ta flaga zazwyczaj nie jest ustawiana tylko wtedy, gdy wskaźnik myszy opuszcza zakres wykrywania (POINTER_FLAG_UPDATE jest ustawiony) lub gdy wskaźnik w kontakcie z powierzchnią okna pozostawia zakres wykrywania (POINTER_FLAG_UP jest ustawiony).

POINTER_MESSAGE_FLAG_INCONTACT

0x00000004
Wskazuje, że ten wskaźnik jest w kontakcie z powierzchnią cyfry. Jeśli ta flaga nie jest ustawiona, wskazuje wskaźnik aktywowania.

POINTER_MESSAGE_FLAG_FIRSTBUTTON

0x00000010
Wskazuje akcję podstawową, analogicznie do lewego przycisku myszy w dół. Wskaźnik dotykowy ma tę flagę ustawioną, gdy ma kontakt z powierzchnią cyfry. Wskaźnik pióra ma tę flagę ustawioną, gdy jest w kontakcie z powierzchnią digitizatora bez naciśnięcia przycisków. Wskaźnik myszy ma tę flagę ustawioną, gdy lewy przycisk myszy jest wyłączony.

POINTER_MESSAGE_FLAG_SECONDBUTTON

0x00000020
Wskazuje akcję pomocniczą, analogicznie do prawego przycisku myszy w dół. Wskaźnik dotykowy nie używa tej flagi. Wskaźnik pióra ma tę flagę ustawioną, gdy jest w kontakcie z powierzchnią cyfry z naciśnięciem przycisku beczki pióra. Wskaźnik myszy ma tę flagę ustawioną, gdy prawy przycisk myszy jest wyłączony.

POINTER_MESSAGE_FLAG_THIRDBUTTON

0x00000040
Analogicznie do przycisku kółka myszy w dół. Wskaźnik dotykowy nie używa tej flagi. Wskaźnik pióra nie używa tej flagi. Wskaźnik myszy ma tę flagę ustawioną, gdy przycisk kółka myszy jest wyłączony.

POINTER_MESSAGE_FLAG_FOURTHBUTTON

0x00000080
Analogicznie do pierwszego rozszerzonego przycisku myszy (XButton1) w dół. Wskaźnik dotykowy nie używa tej flagi. Wskaźnik pióra nie używa tej flagi. Wskaźnik myszy ma tę flagę ustawioną, gdy pierwszy rozszerzony przycisk myszy (XBUTTON1) nie działa.

POINTER_MESSAGE_FLAG_FIFTHBUTTON

0x00000100
Analogicznie do drugiego rozszerzonego przycisku myszy (XButton2) w dół. Wskaźnik dotykowy nie używa tej flagi. Wskaźnik pióra nie używa tej flagi. Wskaźnik myszy ma tę flagę ustawioną, gdy drugi rozszerzony przycisk myszy (XBUTTON2) nie działa.

POINTER_MESSAGE_FLAG_PRIMARY

0x00002000
Wskazuje, że ten wskaźnik został wyznaczony jako podstawowy wskaźnik. Podstawowy wskaźnik to pojedynczy wskaźnik, który może wykonywać akcje poza tymi dostępnymi dla wskaźników innych niż podstawowe. Na przykład gdy podstawowy wskaźnik nawiązuje kontakt z powierzchnią okna, może to spowodować aktywację okna przez wysłanie komunikatu WM_POINTERACTIVATE. Podstawowy wskaźnik jest identyfikowany ze wszystkich bieżących interakcji użytkownika w systemie (mysz, dotyk, pióro itd.). W związku z tym podstawowy wskaźnik może nie być skojarzony z aplikacją. Pierwszy kontakt w interakcji wielodotykowej jest ustawiany jako podstawowy wskaźnik. Po zidentyfikowaniu wskaźnika podstawowego wszystkie kontakty muszą zostać zniesione, zanim nowy kontakt będzie można zidentyfikować jako wskaźnik podstawowy. W przypadku aplikacji, które nie przetwarzają danych wejściowych wskaźnika, tylko zdarzenia wskaźnika podstawowego są promowane do zdarzeń myszy.

POINTER_MESSAGE_FLAG_CONFIDENCE

0x00000400
Pewność siebie to sugestia z urządzenia źródłowego o tym, czy wskaźnik reprezentuje zamierzone lub przypadkowe interakcje, co jest szczególnie istotne w przypadku wskaźników PT_TOUCH, w których przypadkowa interakcja (na przykład z dłonią) może wyzwalać dane wejściowe. Obecność tej flagi wskazuje, że urządzenie źródłowe ma wysoką pewność, że dane wejściowe są częścią zamierzonej interakcji.

POINTER_MESSAGE_FLAG_CANCELED

0x00000800
Wskazuje, że wskaźnik odbiega w nietypowy sposób, na przykład gdy system odbiera nieprawidłowe dane wejściowe wskaźnika lub gdy urządzenie z aktywnymi wskaźnikami nagle odchodzi. Jeśli aplikacja odbierający dane wejściowe jest w stanie to zrobić, powinna traktować interakcję jako nieukończoną i odwracać wszelkie skutki danego wskaźnika.

Uwagi

XBUTTON1 i XBUTTON2 to dodatkowe przyciski używane na wielu urządzeniach myszy. Zwracają one te same dane co standardowe przyciski myszy.

Wymaganie	Wartość
Minimalny obsługiwany klient	Windows 8 [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer	Windows Server 2012 [tylko aplikacje klasyczne]
Nagłówek	Winuser.h