SDL_GetMouseFocus(3)

💖 SDL_GetMouseFocus 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the man pages, and today's main character is SDL_GetMouseFocus — yes she's from SDL3, yes she's serving, let's get into it ✨

---

🌸 NAME 🌸

SDL_GetMouseFocus — get the window which currently has mouse focus.

Like. Which window is the mouse vibing with rn. That one. 🖱️💫

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_mouse.h>

SDL_Window * SDL_GetMouseFocus(void);

no arguments, no drama, she takes zero parameters and she's not sorry 💅

---

🎀 RETURN VALUE 🎀

Returns the window with mouse focus. that's it, that's the whole thing. the window that has the mouse focus? yeah, she hands it to you. 🫶

---

🦋 THREAD SAFETY 🦋

okay so this is the important one, bestie, listen up:

This function should only be called on the main thread. no cap. do NOT be calling this from some random worker thread, she will not appreciate it 😭

main thread only, periodt. 🧚

---

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0. so if you're on an older SDL, sorry babe, she doesn't exist yet 🙈

---

👑 that's the whole page 💀

literally iconic, no notes.

so like, this lil page came to you straight from Simple Directmedia Layer, and the version tag on it is SDL 3.4.18 — that's the source and the version, mwah 💖

go forth and get your mouse focus, bestie. slay. ⭐🦋🎀