(This is the legacy documentation for SDL2, the previous stable version; SDL3 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

SDL_Window *

window

the window that should get the input focus.

Return Value

(int) 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 2.0.5.