SDL_HINT_WINDOW_ALLOW_TOPMOST(3)

💖 SDL_HINT_WINDOW_ALLOW_TOPMOST 💖

okay bestie, welcome to the SDL3 functions girlies manual — this one's a lil hint, and it's giving "please stop putting your window on top of everything" energy. let's get into it 🫶

---

✨ NAME ✨

SDL_HINT_WINDOW_ALLOW_TOPMOST — if you set it to "0" then SDL will never set the topmost flag on an SDL Window, even if the application literally asks for it. like, respectfully, no. 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_WINDOW_ALLOW_TOPMOST "SDL_WINDOW_ALLOW_TOPMOST"

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ — this is a debugging aid for developers, and it is not expected to be used by end users. it's a dev-tools-only kind of vibe, iykyk.

The variable can be set to the following values:

• "0" — don't allow topmost 🙅
• "1" — allow topmost (default) 👑

This hint can be set anytime. no timing drama, no "wait until after init", just set it whenever you want. iconic behavior fr fr ✨

---

🌈 AVAILABILITY 🌈

This hint is available since SDL 3.2.0. so if you're on something older… bestie, it's not there 😭

---

that's the whole page, no cap. every flag, every value, every default, all accounted for. main character documentation energy only 👑

signing off with love from the Simple Directmedia Layer crew — this is the SDL 3.4.18 era, so you know it's fresh 🎀