SDL_SetTrayEntryLabel(3)

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

✨ SDL_SetTrayEntryLabel ✨

okay bestie, so this is a page from the SDL3 FUNCTIONS collection, and today's main character is SDL_SetTrayEntryLabel — she sets the label of an entry. that's it, that's the job 💅

🌸 NAME 🌸

SDL_SetTrayEntryLabel — sets the label of an entry. short, sweet, iconic.

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_tray.h>

void SDL_SetTrayEntryLabel(SDL_TrayEntry *entry, const char *label);

like… two args, returns nothing, no drama. she just does the thing 🫶

💖 DESCRIPTION 💖

so here's the tea. an entry can NOT switch between being a separator and being an ordinary entry. it's giving "you are what you are, periodt."

translation, fr fr:

  • you cannot set a non-NULL label on an entry that has a NULL label (those are the separators, babes)
  • and you cannot set a NULL label on an entry that has a non-NULL label

and if you try? the function will silently fail. no error, no message, no little warning bell 🔔 — just silence. not me getting ghosted by my own function call 😭

lowkey important: "silently fail" means nothing happens and nobody tells you. no exit code drama, no console scream. she just ignores you and moves on. vibe check: failed 💀

🎀 FUNCTION PARAMETERS 🎀

  • entry — the entry to be updated. this is the glow-up target 💖
  • label — the new label for the entry, in UTF-8 encoding. yes bestie, UTF-8, we love a multilingual queen ✨

🧚 THREAD SAFETY 🧚

this function should be called on the thread that created the tray. do not go wandering into other threads with this one, she has trust issues. stay in your lane, stay on your thread, stay slaying 👑

⭐ AVAILABILITY ⭐

this function is available since SDL 3.2.0. so if you're on something older… no she's not there yet, sorry bestie 🙈

👑 SEE ALSO 👑

your little reading list, go off:

🍓 one last reminder before you go: separators stay separators, labels stay labels, and you cannot flip between them. it's giving fixed identity, and honestly? respect. 💜

and that's a wrap, bestie! this page was brought to you by Simple Directmedia Layer, version SDL 3.4.18 🌈 mwah, go set some labels, you've got this 💅✨

📦 where this page comes from