SDL Wiki
(This is the legacy documentation for stable SDL2, the current stable version; SDL3 is the current development version.)


Add a function to watch a particular hint.

Header File

Defined in SDL_hints.h, but apps should only #include "SDL.h"!


void SDL_AddHintCallback(const char *name,
                         SDL_HintCallback callback,
                         void *userdata);

Function Parameters

name the hint to watch
callback An SDL_HintCallback function that will be called when the hint value changes
userdata a pointer to pass to the callback function


This function is available since SDL 2.0.0.

See Also


// Callback function that prints message if new value of hint is 1

void callback(void* f_name, const char* name, const char* oldValue, const char* newValue) {
  if (newValue == (const char*)"1") {
    printf("Hi %s\n", static_cast<char*>(f_name));






while(SDL_PollEvent(&event) != 0)
   // You can change hint here


SDL_AddHintCallback(SDL_HINT_XINPUT_ENABLED, callback, const_cast<char*>("SDL"));

CategoryAPI, CategoryAPIFunction, CategoryHints

[ edit | delete | history | feedback | raw ]

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