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

SDL_AddHintCallback

Add a function to watch a particular hint.

Header File

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

Syntax

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

Version

This function is available since SDL 2.0.0.

See Also

Example

// 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));
  }
}

...

SDL_SetHint(SDL_HINT_XINPUT_ENABLED, "0");

...

SDL_Init(SDL_INIT_EVERYTHING);

...

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.