Flagi wskaźnika

Wartości, które mogą pojawić się w wskaźnikFlags polu struktury POINTER_INFO.

POINTER_FLAG_NONE

0x00000000

Domyślny

POINTER_FLAG_NEW

0x00000001

Wskazuje przybycie nowego wskaźnika.

POINTER_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_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_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_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_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_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_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_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_FLAG_CONFIDENCE

0x000004000

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_FLAG_CANCELED

0x000008000

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.

POINTER_FLAG_DOWN

0x00010000

Wskazuje, że ten wskaźnik został przeniesiony do stanu w dół; oznacza to, że nawiązał kontakt z powierzchnią digitizatora.

POINTER_FLAG_UPDATE

0x00020000

Wskazuje, że jest to prosta aktualizacja, która nie zawiera zmian stanu wskaźnika.

POINTER_FLAG_UP

0x00040000

Wskazuje, że ten wskaźnik został przeniesiony do stanu w górę; oznacza to, że kontakt z powierzchnią digitizatora zakończył się.

POINTER_FLAG_WHEEL

0x00080000

Wskazuje dane wejściowe skojarzone z kołem wskaźnika. W przypadku wskaźników myszy jest to odpowiednik akcji kółka przewijania myszy (WM_MOUSEHWHEEL).

POINTER_FLAG_HWHEEL

0x00100000

Wskazuje dane wejściowe skojarzone ze wskaźnikiem h-wheel. W przypadku wskaźników myszy jest to odpowiednik akcji kółka przewijania poziomego myszy (WM_MOUSEHWHEEL).

POINTER_FLAG_CAPTURECHANGED

0x00200000

Wskazuje, że ten wskaźnik został przechwycony przez element (skojarzony z) innym elementem, a oryginalny element utracił przechwytywanie (zobacz WM_POINTERCAPTURECHANGED).

POINTER_FLAG_HASTRANSFORM

0x00400000

Wskazuje, że ten wskaźnik ma skojarzona transformacja.

Uwagi

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

Wymagania

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

Zobacz też

stałe

POINTER_INFO

POINTER_BUTTON_CHANGE_TYPE