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

SDL_SetModState

Set the current key modifier state for the keyboard.

Header File

Syntax

void SDL_SetModState(SDL_Keymod modstate);

Function Parameters

SDL_Keymod

modstate

the desired SDL_Keymod for the keyboard.

Remarks

The inverse of SDL_GetModState(), SDL_SetModState() allows you to impose modifier key states on your application. Simply pass your desired modifier states into modstate. This value may be a bitwise, OR'd combination of SDL_Keymod values.

This does not change the keyboard state, only the key modifier flags that SDL reports.

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL 3.1.3.