SDL_GetTrayMenu(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_GetTrayMenu 💖

okay bestie, this one's from the SDL3 functions crew — it's the little getter that hands you back a tray menu you already made. no cap, that's the whole vibe. 🎀

✨ NAME ✨

SDL_GetTrayMenu — gets a previously created tray menu. that's it, that's the job. 💅

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_tray.h>

SDL_TrayMenu * SDL_GetTrayMenu(SDL_Tray *tray);

🦋 DESCRIPTION 🦋

so here's the lore: you should have already called SDL_CreateTrayMenu() on the tray object. this function is literally just the "hey, can I see that again?" button — it lets you fetch it again later. lowkey it's a lil reunion. 🫶

the way that this is the same thing as SDL_GetTraySubmenu(), except it takes a SDL_Tray instead of a SDL_TrayEntry? iconic. same energy, different input type, iykyk. ✨

and here's the part that's actually a relief: a menu does not need to be destroyed. it will be destroyed with the tray. so no manual cleanup arc for you, the tray handles it. periodt. 💅

🎀 FUNCTION PARAMETERS 🎀

  • tray — the tray entry to bind the menu to.

⭐ RETURN VALUE ⭐

returns the newly created menu. that's your menu, bestie, go be a main character with it. 👑

🧵 THREAD SAFETY 🧵

this function should be called on the thread that created the tray. like, same thread, same energy, no jumping around. 🌈

🌟 AVAILABILITY 🌟

this function is available since SDL 3.2.0. ✨

💜 SEE ALSO 💜

okay so that's the whole page!! this lil cutie comes to you from the Simple Directmedia Layer squad, version SDL 3.4.18, and it's SDL_GetTrayMenu(3) forever and ever. go get your menu back, you absolute legend. 🦋💖✨

📦 where this page comes from