devela::_dep::sdl3::sys::tray

Function SDL_InsertTrayEntryAt

pub unsafe extern "C" fn SDL_InsertTrayEntryAt(
    menu: *mut SDL_TrayMenu,
    pos: i32,
    label: *const i8,
    flags: u32,
) -> *mut SDL_TrayEntry
Available on crate feature dep_sdl3 only.
Expand description

Insert a tray entry at a given position.

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.

§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

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.

§Availability

This function is available since SDL 3.2.0.

§See also