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

SDL_SetWindowInputFocus

Explicitly set input focus to the window.

Header File

Syntax

int SDL_SetWindowInputFocus(SDL_Window *window);

Function Parameters

window

the window that should get the input focus

Return Value

Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.

Remarks

You almost certainly want SDL_RaiseWindow() instead of this function. Use this with caution, as you might give focus to a window that is completely obscured by other windows.

Version

This function is available since SDL 3.0.0.