SDL_InsertTrayEntryAt3
Insert a tray entry at a given position.
Usage
#include "SDL3/SDL.h"
SDL_TrayEntry * SDL_InsertTrayEntryAt(SDL_TrayMenu *menu, int pos, const char *label, SDL_TrayEntryFlags flags);
Header file
Defined in SDL3/SDL_tray.h
Overview
If label is NULL, the entry will be a separator. Many functions won't work for an entry that is a separator.
An entry does not need to be destroyed; it will be destroyed with the tray.
Function parameters
- menu
-
the menu to append the entry to.
- pos
-
the desired position for the new entry. Entries at or following this place will be moved. If pos is -1, the entry is appended.
- label
-
the text to be displayed on the entry, in UTF-8 encoding, or NULL for a separator.
- flags
-
a combination of flags, some of which are mandatory.
Return value
( SDL_TrayEntry
*) Returns the newly created entry, or NULL if pos is out of bounds.
Thread safety
This function should be called on the thread that created the tray.