SDL_HINT_WINDOWS_ENABLE_MENU_MNEMONICS(3)

NAME
SDL_HINT_WINDOWS_ENABLE_MENU_MNEMONICS - A variable controlling whether menus can be opened with their keyboard shortcut (Alt+mnemonic).

HEADER FILE
Defined in SDL3/SDL_hints.h

SYNOPSIS
#include "SDL3/SDL.h"

#define SDL_HINT_WINDOWS_ENABLE_MENU_MNEMONICS SDL_WINDOWS_ENABLE_MENU_MNEMONICS"

DESCRIPTION
If the mnemonics are enabled, then menus can be opened by pressing the Alt key and the corresponding mnemonic (for example, Alt+F opens the File menu). However, in case an invalid mnemonic is pressed, Windows makes an audible beep to convey that nothing happened. This is true even if the window has no menu at all!

Because most SDL applications don't have menus, and some want to use the Alt key for other purposes, SDL disables mnemonics (and the beeping) by default.

Note: This also affects keyboard events: with mnemonics enabled, when a menu is opened from the keyboard, you will not receive a KEYUP event for the mnemonic key, and might not receive one for Alt.

The variable can be set to the following values:

• "0": Alt+mnemonic does nothing, no beeping. (default)

• "1": Alt+mnemonic opens menus, invalid mnemonics produce a beep.

This hint can be set anytime.

AVAILABILITY
This hint is available since SDL 3.2.0.