SDL_HINT_WINDOW_FRAME_USABLE_WHILE_CURSOR_HIDDEN(3)

🌸 NAME 🌸

SDL_HINT_WINDOW_FRAME_USABLE_WHILE_CURSOR_HIDDEN — okay bestie, this is a hint variable that controls whether the window frame and the title bar stay interactive when the cursor is hidden. That's it, that's the whole job. 💅

This one lives in the SDL3 functions manual, so if you were looking for the SDL3 girlies, you're in the right place. 🫶

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_hints.h>

#define SDL_HINT_WINDOW_FRAME_USABLE_WHILE_CURSOR_HIDDEN "SDL_WINDOW_FRAME_USABLE_WHILE_CURSOR_HIDDEN"

Like, the macro name and the string are literally the same thing. No cap. Copy it exactly, SDL_WINDOW_FRAME_USABLE_WHILE_CURSOR_HIDDEN, character for character. 🔥

---

💖 DESCRIPTION 💖

So the variable can be set to the following values, and there are exactly two, so this is a quick vibe check:

• "0" — the window frame is not interactive when the cursor is hidden. No move, no resize, etc. She's just standing there, pretty but unresponsive. 💀
• "1" — the window frame is interactive when the cursor is hidden. (this is the default, so if you never touch this hint, this is the energy you're getting 👑)

This hint can be set anytime. Anytime, bestie. Before init, after init, mid-scroll, whenever. The hint does not gatekeep. ✨

---

🦋 AVAILABILITY 🦋

This hint has been around since SDL 3.2.0. So if your SDL is older than that, this hint is not going to show up, and that's not a you problem, that's a version problem. 🙈

---

🎀 SEE ALSO 🎀

ngl there's nothing extra listed here, just this hint doing its one (1) thing and doing it well. Iconic behaviour fr fr. 🌈

---

Little reminder: the default is "1", so the frame stays clickable-by-default when the cursor dips out. If you want it frozen, you have to say you want it frozen. The hint will not read your mind. 😭

That's the whole page, babes. This one came to you from Simple Directmedia Layer, SDL 3.4.18, under the manual page name SDL_HINT_WIND...CURSOR_HIDDEN(3). Go hide your cursor and click something, you've earned it. 💖🎀🦋