From dc450ba90802005f12aec82857eef97d582cff96 Mon Sep 17 00:00:00 2001 From: Sam Lantinga Date: Thu, 28 Dec 2023 16:34:13 -0800 Subject: [PATCH] Added an example of creating a window with position --- docs/README-migration.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/docs/README-migration.md b/docs/README-migration.md index c2a58f185..f25731691 100644 --- a/docs/README-migration.md +++ b/docs/README-migration.md @@ -1323,7 +1323,21 @@ Rather than iterating over displays using display index, there is a new function } ``` -SDL_CreateWindow() has been simplified and no longer takes a window position. You can use SDL_CreateWindowWithProperties() if you need to set the window position when creating it. +SDL_CreateWindow() has been simplified and no longer takes a window position. You can use SDL_CreateWindowWithProperties() if you need to set the window position when creating it, e.g. +```c + SDL_PropertiesID props = SDL_CreateProperties(); + SDL_SetStringProperty(props, title); + SDL_SetNumberProperty(props, "x", x); + SDL_SetNumberProperty(props, "y", y); + SDL_SetNumberProperty(props, "width", width); + SDL_SetNumberProperty(props, "height", height); + SDL_SetNumberProperty(props, "flags", flags); + pWindow = SDL_CreateWindowWithProperties(props); + SDL_DestroyProperties(props); + if (window) { + ... + } +``` The SDL_WINDOWPOS_UNDEFINED_DISPLAY() and SDL_WINDOWPOS_CENTERED_DISPLAY() macros take a display ID instead of display index. The display ID 0 has a special meaning in this case, and is used to indicate the primary display.