SDL_CreateTrayMenu(3)

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

💖 SDL_CreateTrayMenu 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the man pages — this one's SDL_CreateTrayMenu(3) and it's lowkey the moment your system tray icon gets a whole menu to call its own. 🌸

✨ NAME ✨

SDL_CreateTrayMenu — Create a menu for a system tray. 🎀

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_tray.h>

SDL_TrayMenu * SDL_CreateTrayMenu(SDL_Tray *tray);

💅 DESCRIPTION 💅

so here's the tea: this should be called at most once per tray icon. that's it, that's the rule. one menu per icon, don't be greedy. 🙈

This function does the same thing as SDL_CreateTraySubmenu(), except that it takes a SDL_Tray instead of a SDL_TrayEntry. same energy, different parameter, iykyk. ✨

And the best part?? A menu does not need to be destroyed — it will be destroyed with the tray. no cleanup era required, it's giving self-sufficient queen behavior. 👑

🎀 FUNCTION PARAMETERS 🎀

  • tray — the tray to bind the menu to. that's your girl, the tray icon getting the glow-up. 💖

⭐ RETURN VALUE ⭐

Returns the newly created menu. fresh out the oven, still warm. 🔥

🧚 THREAD SAFETY 🧚

This function should be called on the thread that created the tray. fr fr, don't be out here calling it from some random thread — stay loyal to the one that birthed the tray. 😭

🌈 AVAILABILITY 🌈

This function is available since SDL 3.2.0. so if you're on anything older, it's not you, it's the version. 💀

👑 SEE ALSO 👑

go read those too, bestie, they're all part of the same friend group. 🫶

and that's the whole page!! brought to you by the fine folks at Simple Directmedia Layer, version SDL 3.4.18 — slay, iconic, no cap. 💅✨🌸

📦 where this page comes from