komunikat WM_POINTERCAPTURECHANGED

Wysłane do okna, które traci przechwytywanie wskaźnika wejściowego.

Okno odbiera ten komunikat za pośrednictwem funkcji WindowProc.

#define WM_POINTERCAPTURECHANGED           0x024C

Parametry

wParam

Zawiera informacje o wskaźniku wejściowym, który jest utracony. Użyj GET_POINTERID_WPARAM, aby uzyskać identyfikator wskaźnika.

lParam

Zawiera uchwyt do okna, który przechwytuje wskaźnik wejściowy. Ta wartość może mieć wartość NULL, jeśli wskaźnik nie jest już przechwytywany przez okno.

Jeśli ten komunikat jest generowany na podstawie przetwarzania wewnętrznego, wartość może być dojściem do okna odbierającego komunikat.

Wartość zwracana

Jeśli aplikacja przetwarza ten komunikat, powinna zwrócić zero.

Jeśli aplikacja nie przetworzy tego komunikatu, powinna wywołać DefWindowProc.

Uwagi

Okno powinno użyć tego powiadomienia, aby zatrzymać przetwarzanie kolejnych komunikatów i zainicjować wszelkie oczyszczanie wymagane do utraty wskaźnika. Przetwarzanie gestów skojarzonych ze wskaźnikiem powinno również zostać zakończone (na przykład przez wywołanie StopInteractionContext) i ponowne skojarzenie pozostałych kontaktów z oknem.

Zazwyczaj jeśli okno odbiera powiadomienie WM_POINTERCAPTURECHANGED, żadne kolejne powiadomienia związane ze wskaźnikiem wejściowym nie są odbierane. W związku z tym nie zależą od sparowanych powiadomień, takich jak WM_POINTERENTER i WM_POINTERLEAVE.

WM_POINTERCAPTURECHANGED nie zawiera POINTER_INFO danych. Inne niż ustawiono flagę POINTER_FLAG_CAPTURECHANGED, dane zwrócone przez GetPointerInfo (lub dowolny wariant) są identyczne z danymi zwróconą przed powiadomieniem.

Jeśli aplikacja nie przetworzy tego powiadomienia, defWindowProc może wygenerować co najmniej jeden komunikat WM_GESTURE lub, jeśli gest nie zostanie rozpoznany, defWindowProc może wygenerować dane wejściowe myszy.

Jeśli aplikacja selektywnie używa niektórych danych wejściowych wskaźnika i przekazuje resztę do DefWindowProc, wynikowe zachowanie jest niezdefiniowane.

Wymagania

Zobacz też

wiadomości