SDL_GetTrayMenuParentEntry(3)

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

✨ SDL_GetTrayMenuParentEntry ✨

okay bestie, welcome to SDL_GetTrayMenuParentEntry(3) — yes it's a mouthful, yes it's from the SDL3 functions squad, and yes it's about to make your tray menus make sense 💅

🎀 NAME 🎀

SDL_GetTrayMenuParentEntry — the girl who tells you which entry a menu is a submenu of, when that menu is, in fact, a submenu. no cap, that's the whole job 🦋

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_tray.h>

SDL_TrayEntry * SDL_GetTrayMenuParentEntry(SDL_TrayMenu *menu);

💖 DESCRIPTION 💖

so here's the vibe check: for literally any given menu, either this function or SDL_GetTrayMenuParentTray() is gonna hand you a non-NULL back. one of them always comes through, bestie. that's the whole dynamic — a menu either has a parent tray, or it's living its submenu life nested under an entry, and this function is the one that catches the submenu case 🌈

🫶 FUNCTION PARAMETERS 🫶

  • menu — the menu you're asking about, i.e. the menu for which to get the parent entry. it's giving "who's your parent, babe" 💜

⭐ RETURN VALUE ⭐

Returns the parent entry, or NULL if this menu is not a submenu. no submenu, no parent entry, no drama. the NULL is not a bug, it's just her being honest with you 🙈

🔥 THREAD SAFETY 🔥

this one has RULES, bestie: call it on the thread that created the tray. periodt. don't be out here calling it from a random thread and then acting surprised 😭

👑 AVAILABILITY 👑

this function has been serving looks since SDL 3.2.0. iconic behavior, honestly 💅

💀 SEE ALSO 💀

iykyk, go read those next 🧚

mwah 💋 that's a wrap — brought to you by the Simple Directmedia Layer girlies, page version SDL 3.4.18. slay, bye bestie! 🍓

📦 where this page comes from