Sync SDL3 wiki -> header

This commit is contained in:
SDL Wiki Bot
2023-03-13 17:57:18 +00:00
parent 1f35fd6939
commit 689ea5361e

View File

@@ -667,26 +667,23 @@ extern DECLSPEC SDL_Window *SDLCALL SDL_CreateWindow(const char *title, int w, i
/** /**
* Create a child popup window of the specified parent window. * Create a child popup window of the specified parent window.
* *
* 'flags' **must** contain exactly one of the following: * 'flags' **must** contain exactly one of the following: -
* - 'SDL_WINDOW_TOOLTIP': The popup window is a tooltip and will not pass any * 'SDL_WINDOW_TOOLTIP': The popup window is a tooltip and will not pass any
* input events. * input events. - 'SDL_WINDOW_POPUP_MENU': The popup window is a popup menu.
* - 'SDL_WINDOW_POPUP_MENU': The popup window is a popup menu. The topmost * The topmost popup menu will implicitly gain the keyboard focus.
* popup menu will implicitly gain the keyboard focus.
* *
* The following flags are not relevant to popup window creation and will be ignored: * The following flags are not relevant to popup window creation and will be
* - 'SDL_WINDOW_MINIMIZED' * ignored: - 'SDL_WINDOW_MINIMIZED' - 'SDL_WINDOW_MAXIMIZED' -
* - 'SDL_WINDOW_MAXIMIZED' * 'SDL_WINDOW_FULLSCREEN' - 'SDL_WINDOW_BORDERLESS' -
* - 'SDL_WINDOW_FULLSCREEN' * 'SDL_WINDOW_SKIP_TASKBAR'
* - 'SDL_WINDOW_BORDERLESS'
* - 'SDL_WINDOW_SKIP_TASKBAR'
* *
* The parent parameter **must** be non-null and a valid window. The parent of * The parent parameter **must** be non-null and a valid window. The parent of
* a popup window can be either a regular, toplevel window, or another popup * a popup window can be either a regular, toplevel window, or another popup
* window. * window.
* *
* Popup windows cannot be minimized, maximized, made fullscreen, raised, flash, * Popup windows cannot be minimized, maximized, made fullscreen, raised,
* be made a modal window, be the parent of a modal window, or grab the mouse * flash, be made a modal window, be the parent of a modal window, or grab the
* and/or keyboard. Attempts to do so will fail. * mouse and/or keyboard. Attempts to do so will fail.
* *
* Popup windows implicitly do not have a border/decorations and do not appear * Popup windows implicitly do not have a border/decorations and do not appear
* on the taskbar/dock or in lists of windows such as alt-tab menus. * on the taskbar/dock or in lists of windows such as alt-tab menus.