SDL_SetWindowProgressState(3)

πŸ“¦
version 3.4.18 Β· 5 versions
, in fedora 43, fedora 44

✨ NAME ✨

SDL_SetWindowProgressState β€” bestie, this one sets the state of the progress bar for the given window's taskbar icon πŸ’…

Like. Your app is doing a Thing. And you want the lil taskbar icon to say that. This is the function that says it. πŸŽ€


🌸 SYNOPSIS 🌸

#include <SDL3/SDL_video.h>

bool SDL_SetWindowProgressState(SDL_Window *window, SDL_ProgressState state);

πŸ’– FUNCTION PARAMETERS πŸ’–

  • window β€” the window whose progress state is to be modified. Yes, this window, the one you're pointing at. 🫢
  • state β€” the progress state. And listen, super important: SDL_PROGRESS_STATE_NONE stops displaying the progress bar. Poof. Gone. No bar. πŸ«₯

⭐ RETURN VALUE ⭐

Returns true on success or false on failure β€” no in-between, it's giving binary icon behaviour honestly 😭

If it fails, call SDL_GetError() for more information. She will tell you what went wrong. Always ask her. πŸ™ˆ


🧚 THREAD SAFETY 🧚

This function should only be called on the main thread.

Not me calling this from a worker thread πŸ’€ do NOT do that. Main thread only. Periodt. πŸ‘‘

🌈 AVAILABILITY 🌈

This function is available since SDL 3.4.0. So if you're on something older, that's a you problem bestie, go update πŸ”₯


okay that's literally it, go make your taskbar icon glow up βœ¨πŸ¦‹πŸ’œ

Signed, sealed, delivered by the Simple Directmedia Layer girlies β€” this is SDL 3.4.18 energy, mwah πŸ’‹πŸŽ€

πŸ“¦ where this page comes from