SDL_CreateTray - Man Page

Create an icon to be placed in the operating system's tray, or equivalent.

Header File

Defined in SDL3/SDL_tray.h

Synopsis

#include "SDL3/SDL.h"

SDL_Tray* SDL_CreateTray(SDL_Surface *icon, const char *tooltip);

Description

Many platforms advise not using a system tray unless persistence is a necessary feature. Avoid needlessly creating a tray icon, as the user may feel like it clutters their interface.

Using tray icons require the video subsystem.

Function Parameters

icon

a surface to be used as icon. May be NULL.

tooltip

a tooltip to be displayed when the mouse hovers the icon in UTF-8 encoding. Not supported on all platforms. May be NULL.

Return Value

( SDL_Tray
*) Returns The newly created system tray icon.

Thread Safety

This function should only be called on the main thread.

Availability

This function is available since SDL 3.2.0.

See Also

·(3), SDL_CreateTrayMenu(3), ·(3), SDL_GetTrayMenu(3), ·(3), SDL_DestroyTray(3)

Referenced By

SDL_CreateTrayMenu(3), SDL_DestroyTray(3), SDL_GetTrayMenu(3), SDL_SetTrayIcon(3), SDL_SetTrayTooltip(3).

SDL 3.2.2 Simple Directmedia Layer SDL3 FUNCTIONS