SDL_CreateTraySubmenu(3)

💖 SDL_CreateTraySubmenu 💖

okay bestie, welcome to the SDL3 FUNCTIONS page for SDL_CreateTraySubmenu(3) — yes that's the manual section number, she's fancy like that. let's get into it ✨

---

🌸 NAME 🌸

SDL_CreateTraySubmenu — Create a submenu for a system tray entry.

like, a menu inside a menu. nesting era. 🪆

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_tray.h>

SDL_TrayMenu * SDL_CreateTraySubmenu(SDL_TrayEntry *entry);

---

✨ DESCRIPTION ✨

okay so. this one should be called at most once per tray entry. one entry, one submenu. that's the whole vibe. don't be greedy 💅

this function does the same thing as SDL_CreateTrayMenu, except that it takes a SDL_TrayEntry instead of a SDL_Tray. same energy, different argument type, iykyk.

and here's the best part: a menu does not need to be destroyed. it gets destroyed with the tray. no cleanup arc, no manual free, no nothing. it's giving "the tray handles it, you just live your life" 🦋

---

🫶 FUNCTION PARAMETERS 🫶

• entry — the tray entry to bind the menu to. that's her. that's the one getting a whole submenu attached. iconic behavior honestly 👑

---

⭐ RETURN VALUE ⭐

Returns the newly created menu. brand new, fresh out of the oven, ready to be filled with stuff 🍓

---

🧚 THREAD SAFETY 🧚

this function should be called on the thread that created the tray. not a different thread, bestie. same thread. the tray's thread. periodt. don't cross the streams 💀

---

🌈 AVAILABILITY 🌈

this function is available since SDL 3.2.0. so if you're on anything older, sorry babe, no submenu for you 😭

---

👑 SEE ALSO 👑

• SDL_InsertTrayEntryAt(3)
• SDL_GetTraySubmenu(3)
• SDL_GetTrayMenuParentEntry(3)

---

lowkey a whole submenu system living inside your system tray. main character energy fr fr 💅

okay that's the page!! this one was brought to you by Simple Directmedia Layer, version SDL 3.4.18 — go make a tray, make a submenu, make it cute. bye bestie 🎀✨🦋