# SDL_CreateTraySubmenu

Create a submenu for a system tray entry.

## Header File

Defined in [<SDL3/SDL_tray.h>](https://github.com/libsdl-org/SDL/blob/main/include/SDL3/SDL_tray.h)

## Syntax

```c
SDL_TrayMenu * SDL_CreateTraySubmenu(SDL_TrayEntry *entry);
```

## Function Parameters

|                                  |           |                                     |
| -------------------------------- | --------- | ----------------------------------- |
| [SDL_TrayEntry](SDL_TrayEntry) * | **entry** | the tray entry to bind the menu to. |

## Return Value

([SDL_TrayMenu](SDL_TrayMenu) *) Returns the newly created menu.

## Remarks

This should be called at most once per tray entry.

This function does the same thing as
[SDL_CreateTrayMenu](SDL_CreateTrayMenu), except that it takes a
[SDL_TrayEntry](SDL_TrayEntry) instead of a [SDL_Tray](SDL_Tray).

A menu does not need to be destroyed; it will be destroyed with the tray.

## Thread Safety

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

## Version

This function is available since SDL 3.2.0.

## See Also

- [SDL_InsertTrayEntryAt](SDL_InsertTrayEntryAt)
- [SDL_GetTraySubmenu](SDL_GetTraySubmenu)
- [SDL_GetTrayMenuParentEntry](SDL_GetTrayMenuParentEntry)

----
[CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction), [CategoryTray](CategoryTray)

