Note that you might get a different size window than you expect

This commit is contained in:
Sam Lantinga 2025-04-03 08:47:23 -07:00
parent ab34ea5a26
commit df32827407
1 changed files with 6 additions and 0 deletions

View File

@ -1062,6 +1062,8 @@ extern SDL_DECLSPEC SDL_Window ** SDLCALL SDL_GetWindows(int *count);
/** /**
* Create a window with the specified dimensions and flags. * Create a window with the specified dimensions and flags.
* *
* The window size is a request and may be different than expected based on the desktop layout and window manager policies. Your application should be prepared to handle a window of any size.
*
* `flags` may be any of the following OR'd together: * `flags` may be any of the following OR'd together:
* *
* - `SDL_WINDOW_FULLSCREEN`: fullscreen window at desktop resolution * - `SDL_WINDOW_FULLSCREEN`: fullscreen window at desktop resolution
@ -1148,6 +1150,8 @@ extern SDL_DECLSPEC SDL_Window * SDLCALL SDL_CreateWindow(const char *title, int
/** /**
* Create a child popup window of the specified parent window. * Create a child popup window of the specified parent window.
* *
* The window size is a request and may be different than expected based on the desktop layout and window manager policies. Your application should be prepared to handle a window of any size.
*
* The flags parameter **must** contain at least one of the following: * The flags parameter **must** contain at least 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
@ -1210,6 +1214,8 @@ extern SDL_DECLSPEC SDL_Window * SDLCALL SDL_CreatePopupWindow(SDL_Window *paren
/** /**
* Create a window with the specified properties. * Create a window with the specified properties.
* *
* The window size is a request and may be different than expected based on the desktop layout and window manager policies. Your application should be prepared to handle a window of any size.
*
* These are the supported properties: * These are the supported properties:
* *
* - `SDL_PROP_WINDOW_CREATE_ALWAYS_ON_TOP_BOOLEAN`: true if the window should * - `SDL_PROP_WINDOW_CREATE_ALWAYS_ON_TOP_BOOLEAN`: true if the window should