SDL_HINT_WIN...CLUDE_HOTKEYS(3)

πŸ“¦
version 3.4.18 Β· 5 versions
, in fedora 43, fedora 44

✨ SDL_HINT_WINDOWS_RAW_KEYBOARD_EXCLUDE_HOTKEYS ✨

okay bestie, you know how this whole thing lives in the SDL3 FUNCTIONS manual? yeah. this is that page. it's a lil hint, it's got a long name, and it's lowkey iconic πŸ’…


πŸŽ€ NAME πŸŽ€

SDL_HINT_WINDOWS_RAW_KEYBOARD_EXCLUDE_HOTKEYS β€” a variable that controls whether or not the RIDEV_NOHOTKEYS flag gets set when you enable Windows raw keyboard events. that's it, that's the whole vibe πŸ¦‹


🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_WINDOWS_RAW_KEYBOARD_EXCLUDE_HOTKEYS "SDL_WINDOWS_RAW_KEYBOARD_EXCLUDE_HOTKEYS"

like, you literally just #include the header and the macro is right there waiting for you, no cap 🫢


πŸ’– DESCRIPTION πŸ’–

so here's the tea β˜•: when this hint is doing its thing, it blocks any hotkeys that have been registered by applications from having any effect beyond generating raw WM_INPUT events. meaning the hotkey still shows up as a raw input event, it just doesn't... do the hotkey thing. it's giving "i see you but i'm not answering" energy 😭

important disclaimer bestie: this flag does not affect system-hotkeys like ALT-TAB or CTRL-ALT-DEL. those are built different, they're above this whole situation, main character energy fr fr πŸ‘‘

but it does affect the Windows Logo key πŸͺŸ, because that one is a userland hotkey registered by explorer.exe. so like, yeah. the flag can absolutely body that one. sorry to the Start menu i guess πŸ’€

⭐ the values you can set it to ⭐

  • "0" β€” hotkeys are not excluded. this is the default, so if you say nothing, this is what you get πŸ™ˆ
  • "1" β€” hotkeys are excluded. bye hotkeys πŸ‘‹βœ¨
this hint can be set anytime. whenever. no rules, no schedule, just vibes πŸ¦‹

🌈 AVAILABILITY 🌈

this hint is available since SDL 3.4.0. so if you're on something older, it's simply not there yet, and that's just the way it is, no hard feelings πŸŽ€


🫢 SEE ALSO 🫢

there's nothing else listed here bestie, this page is a solo act and honestly? respect πŸ’œ


that's the whole page!! now go forth and exclude (or don't exclude) those hotkeys with confidence, you absolute legend πŸ‘‘πŸ’…

Simple Directmedia Layer β€” SDL 3.4.18, mwah, sending you this page with love, go slay your keyboard events 🌸✨

πŸ“¦ where this page comes from