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

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>

Syntax

#define SDL_HINT_WINDOWS_ENABLE_MENU_MNEMONICS "SDL_WINDOWS_ENABLE_MENU_MNEMONICS"

Remarks

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.

Version

This hint is available since SDL 3.1.3.

---

CategoryAPI, CategoryAPIMacro, CategoryHints

[ 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.