(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_RaiseWindow

Request that a window be raised above other windows and gain the input focus.

Header File

Defined in <SDL3/SDL_video.h>

Syntax

bool SDL_RaiseWindow(SDL_Window *window);

Function Parameters

SDL_Window *

window

the window to raise.

Return Value

(bool) Returns true on success or false on failure; call SDL_GetError() for more information.

Remarks

The result of this request is subject to desktop window manager policy, particularly if raising the requested window would result in stealing focus from another application. If the window is successfully raised and gains input focus, an SDL_EVENT_WINDOW_FOCUS_GAINED event will be emitted, and the window will have the SDL_WINDOW_INPUT_FOCUS flag set.

Thread Safety

This function should only be called on the main thread.

Version

This function is available since SDL 3.1.3.

---

CategoryAPI, CategoryAPIFunction, CategoryVideo

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.