int SDL_CaptureMouse(SDL_bool enabled)

Zwraca 0 przy sukcesie lub -1, jeśli przechwytywanie myszki nie jest wspierane; wywołaj funkcję SDL_GetError(), aby otrzymać więcej informacji na temat błędu.

Przechwytywanie umożliwia twojej aplikacji otrzymywanie zdarzeń myszki globalnie, zamiast jedynie w twoim oknie. Nie wszystkie platformy wideo obsługują tę funkcję. Gdy przechwytywanie jest uaktywnione, bieżące okno będzie otrzymywało wszystkie zdarzenia myszki, lecz w przeciwieństwie do trybu względnego, zmiany nie są wprowadzane w położeniu kursora i nie będzie on ograniczony do powierzchni twojego okna.

Funkcja ta może również zablokować myszkę dla innych okien – zarówno w twojej aplikacji jak i w innych w systemie – zatem powinieneś używać jej oszczędnie i tylko przez krótkie okresy czasu. Na przykład, możesz śledzić myszkę, gdy użytkownik coś nią przeciąga po ekranie aż do momentu, gdy zwolni przycisk myszki. Nie zaleca się przechwytywania myszki na długie okresy czasu, np. przez cały czas działania twojej aplikacji.

Po przechwyceniu zdarzenia myszki wciąż zgłaszają współrzędne względem bieżącego okna (leżącego na wierzchu), lecz współrzędne te mogą dotyczyć obszarów poza jego granicami (również wartości ujemne mogą się pojawić). Przechwytywanie dozwolone jest jedynie dla okna, które znajduje się na wierzchu. Jeśli okno straci skupienie podczas przechwytywania, przechwytywanie zostanie automatycznie wyłączone.

Gdy przechwytywanie jest uaktywnione, bieżące okno będzie miało ustawiony znacznik SDL_WINDOW_MOUSE_CAPTURE.

Funkcja dostępna jest od SDL 2.0.4.