SDL_SetTrayEntryLabel(3)

SDL_SetTrayEntryLabel3

Sets the label of an entry.

Usage

#include "SDL3/SDL.h"

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

Header file

Defined in SDL3/SDL_tray.h

Overview

An entry cannot change between a separator and an ordinary entry; that is, it is not possible to set a non-NULL label on an entry that has a NULL label (separators), or to set a NULL label to an entry that has a non-NULL label. The function will silently fail if that happens.

Function parameters

entry

the entry to be updated.

label

the new label for the entry in UTF-8 encoding.

Thread safety

This function should be called on the thread that created the tray.

Availability

This function is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.