SDL_SetWindowModal(3)

✨ SDL_SetWindowModal ✨

okay bestie, welcome to the SDL_SetWindowModal(3) glow-up 💅 this one lives in the SDL3 FUNCTIONS corner of the SDL3 manual and it's basically the on/off switch for whether a window gets to be all main character and demand everyone's attention 👑

---

🌸 NAME 🌸

SDL_SetWindowModal — toggle the state of the window as modal 🎀

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_video.h>

bool SDL_SetWindowModal(SDL_Window *window, bool modal);

---

💖 DESCRIPTION 💖

so here's the tea, fr fr: to turn modal status on for a window, that window has to currently be the child window of a parent. that's the vibe check. if it's not a child of a parent, then toggling modal status on is gonna fail 😭 no cap.

---

🎀 FUNCTION PARAMETERS 🎀

• window — the window on which to set the modal state. it's the one getting the makeover 💅
• modal — true to toggle modal status on, false to toggle it off. yes queen, it's just a lil boolean doing its thing ✨

---

💜 RETURN VALUE 💜

returns true on success or false on failure 🫶 and if it fails, don't just sit there spiraling — call SDL_GetError() for more information, she'll tell you what went wrong 💀

---

🌈 THREAD SAFETY 🌈

⚠️ this function should only be called on the main thread. literally do not try it anywhere else, bestie, that's not the move 🙈

---

⭐ AVAILABILITY ⭐

this function is available since SDL 3.2.0 — a true icon of the 3.2.0 era 👑

---

🔥 SEE ALSO 🔥

• SDL_SetWindowParent(3)
• SDL_WINDOW_MODAL(3)

iykyk, go read those next, they're part of the same friend group 🧚

---

mwah 💋 that's the whole page! this little love letter to your windows came from the Simple Directmedia Layer girlies, rocking SDL 3.4.18, and it's filed under SDL_SetWindowModal(3) — catch you in the next manpage, periodt 💅✨