Scroll to navigation

SDL_CreatePopupWindow(3) SDL3 FUNCTIONS SDL_CreatePopupWindow(3)

NAME

SDL_CreatePopupWindow - Create a child popup window of the specified parent window.

SYNOPSIS

#include "SDL3/SDL.h"
SDL_Window* SDL_CreatePopupWindow(SDL_Window *parent, int offset_x, int offset_y, int w, int h, SDL_WindowFlags flags);

DESCRIPTION

must contain exactly one of the following: - SDL_WINDOW_TOOLTIP and will not pass any input events. - SDL_WINDOW_POPUP_MENU popup menu. The topmost popup menu will implicitly gain the keyboard focus.

The following flags are not relevant to popup window creation and will be ignored:

• ' SDL_WINDOW_MINIMIZED

• ' SDL_WINDOW_MAXIMIZED

• ' SDL_WINDOW_FULLSCREEN

• ' SDL_WINDOW_BORDERLESS

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 window.

Popup windows cannot be minimized, maximized, made fullscreen, raised, flash, be made a modal window, be the parent of a modal window, or grab the mouse and/or keyboard. Attempts to do so will fail.

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.

If a parent window is hidden, any child popup windows will be recursively hidden as well. Child popup windows not explicitly hidden will be restored when the parent is shown.

If the parent window is destroyed, any child popup windows will be recursively destroyed as well.

FUNCTION PARAMETERS

the parent of the window, must not be NULL
the x position of the popup window relative to the origin of the parent
the y position of the popup window relative to the origin of the parent window
the width of the window
the height of the window

SDL_WINDOW_TOOLTIP
or SDL_WINDOW_POPUP
MENU, and zero or more additional SDL_WindowFlags
OR'd together.

RETURN VALUE

Returns the window that was created or NULL on failure; call

SDL_GetError () for more information.

AVAILABILITY

This function is available since SDL 3.0.0.

SEE ALSO

SDL_CreateWindow(3), SDL_CreateWindowWithProperties(3), SDL_DestroyWindow(3), SDL_GetWindowParent(3)

SDL 3.1.0 SDL