SDL_HINT_WIN...TE_WHEN_SHOWN(3)

💖 SDL_HINT_WINDOW_ACTIVATE_WHEN_SHOWN 💖

okay bestie, welcome to the SDL3 FUNCTIONS manual, and lemme tell you about this lil variable that controls whether your window gets activated when SDL_ShowWindow gets called. it's giving "do I get the spotlight or nah" energy and honestly? iconic. 🎀

---

✨ NAME ✨

SDL_HINT_WINDOW_ACTIVATE_WHEN_SHOWN — a variable controlling whether the window is activated when the SDL_ShowWindow function is called.

like, that's it. that's the whole job. but it's a very important job. 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_WINDOW_ACTIVATE_WHEN_SHOWN "SDL_WINDOW_ACTIVATE_WHEN_SHOWN"

so you just #include the header, and the macro is already sitting there waiting for you like a good little bestie. no cap. 🫶

---

💜 DESCRIPTION 💜

okay so here's the tea ☕ — this variable can be set to the following values:

• "0" — the window is NOT activated when the SDL_ShowWindow function is called. it shows up but it does not steal focus, it's lowkey minding its own business. 🙈
• "1" — the window IS activated when the SDL_ShowWindow function is called. main character energy fr fr. 👑 (this is the default)

and the best part? this hint can be set anytime. like, no weird timing rules, no "you had to do it before init" nonsense. set it whenever, bestie. ✨

---

🦋 AVAILABILITY 🦋

this hint is available since SDL 3.2.0. so if you're on anything older, sorry babe, you're not invited to this party. 😭

---

reminder: this is a hint, so it's the vibe you're requesting, not a blood oath. keep your values exactly as written — "0" and "1" — and don't go inventing new ones. 💖

---

that's the whole page, bestie! go forth and activate (or don't activate) those windows with confidence. 🌈⭐🍓

signing off with love from the Simple Directmedia Layer crew — this one's from SDL 3.4.18 — mwah, catch you in the next manpage 💅💖🧚