gitea/SDL3_fork
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Sync SDL3 wiki -> header

Browse Source 
[ci skip]
This commit is contained in:
SDL Wiki Bot
2026-02-04 20:51:27 +00:00
parent 70e16a8d13
commit 3b43b55e2a
1 changed files with 20 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
include/SDL3/SDL_tray.h
View File

@@ -104,9 +104,8 @@ typedef void (SDLCALL *SDL_TrayCallback)(void *userdata, SDL_TrayEntry *entry);
* it will be invoked. May be NULL. * it will be invoked. May be NULL.
* \param tray the tray that was clicked. * \param tray the tray that was clicked.
* \returns true to show the tray menu after the callback returns, false to * \returns true to show the tray menu after the callback returns, false to
* skip showing the menu. This return value is only used for left * skip showing the menu. This return value is only used for left and
* and right click callbacks; other mouse events ignore the return * right click callbacks; other mouse events ignore the return value.
* value.
* *
* \since This datatype is available since SDL 3.6.0. * \since This datatype is available since SDL 3.6.0.
* *
@@ -152,26 +151,25 @@ extern SDL_DECLSPEC SDL_Tray * SDLCALL SDL_CreateTray(SDL_Surface *icon, const c
* *
* - `SDL_PROP_TRAY_CREATE_ICON_POINTER`: an SDL_Surface to be used as the * - `SDL_PROP_TRAY_CREATE_ICON_POINTER`: an SDL_Surface to be used as the
* tray icon. May be NULL. * tray icon. May be NULL.
* - `SDL_PROP_TRAY_CREATE_TOOLTIP_STRING`: a tooltip to be displayed when * - `SDL_PROP_TRAY_CREATE_TOOLTIP_STRING`: a tooltip to be displayed when the
* the mouse hovers the icon in UTF-8 encoding. Not supported on all * mouse hovers the icon in UTF-8 encoding. Not supported on all platforms.
* platforms. May be NULL.
* - `SDL_PROP_TRAY_CREATE_USERDATA_POINTER`: an optional pointer to
* associate with the tray, which will be passed to click callbacks.
* May be NULL. * May be NULL.
* - `SDL_PROP_TRAY_CREATE_LEFTCLICK_CALLBACK_POINTER`: an SDL_TrayClickCallback * - `SDL_PROP_TRAY_CREATE_USERDATA_POINTER`: an optional pointer to associate
* to be invoked when the tray icon is left-clicked. Not supported on all * with the tray, which will be passed to click callbacks. May be NULL.
* platforms. The callback should return true to show the default menu, or * - `SDL_PROP_TRAY_CREATE_LEFTCLICK_CALLBACK_POINTER`: an
* false to skip showing it. May be NULL. * SDL_TrayClickCallback to be invoked when the tray icon is left-clicked.
* - `SDL_PROP_TRAY_CREATE_RIGHTCLICK_CALLBACK_POINTER`: an SDL_TrayClickCallback * Not supported on all platforms. The callback should return true to show
* to be invoked when the tray icon is right-clicked. Not supported on all * the default menu, or false to skip showing it. May be NULL.
* platforms. The callback should return true to show the default menu, or * - `SDL_PROP_TRAY_CREATE_RIGHTCLICK_CALLBACK_POINTER`: an
* false to skip showing it. May be NULL. * SDL_TrayClickCallback to be invoked when the tray icon is right-clicked.
* - `SDL_PROP_TRAY_CREATE_MIDDLECLICK_CALLBACK_POINTER`: an SDL_TrayClickCallback * Not supported on all platforms. The callback should return true to show
* to be invoked when the tray icon is middle-clicked. Not supported on all * the default menu, or false to skip showing it. May be NULL.
* platforms. May be NULL. * - `SDL_PROP_TRAY_CREATE_MIDDLECLICK_CALLBACK_POINTER`: an
* - `SDL_PROP_TRAY_CREATE_DOUBLECLICK_CALLBACK_POINTER`: an SDL_TrayClickCallback * SDL_TrayClickCallback to be invoked when the tray icon is middle-clicked.
* to be invoked when the tray icon is double-clicked. Not supported on all * Not supported on all platforms. May be NULL.
* platforms. May be NULL. * - `SDL_PROP_TRAY_CREATE_DOUBLECLICK_CALLBACK_POINTER`: an
* SDL_TrayClickCallback to be invoked when the tray icon is double-clicked.
* Not supported on all platforms. May be NULL.
* *
* \param props the properties to use. * \param props the properties to use.
* \returns The newly created system tray icon. * \returns The newly created system tray icon.