(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)

SDL_CreateWindowWithProperties

Create a window with the specified properties.

Syntax

SDL_Window* SDL_CreateWindowWithProperties(SDL_PropertiesID props);

Function Parameters

props the properties to use

Return Value

Returns the window that was created or NULL on failure; call SDL_GetError() for more information.

Remarks

These are the supported properties:

These are additional supported properties on macOS:

These are additional supported properties on Wayland:

These are additional supported properties on Windows:

These are additional supported properties with X11:

The window is implicitly shown if the "hidden" property is not set.

Windows with the "tooltip" and "menu" properties are popup windows and have the behaviors and guidelines outlined in [SDL_CreatePopupWindow](SDL_CreatePopupWindow)().

Version

This function is available since SDL 3.0.0.


CategoryAPI