#pragma section-numbers off
#pragma camelcase off
||<tablewidth="100%" style="color: #FF0000;" :> DRAFT||


##*^*^*^*^*See http://wiki.libsdl.org/moin.cgi/SGFunctions for details on editing this page*^*^*^*^*


= SDL_AddHintCallback =
Use this function to add a function to watch a particular hint.


<<TableOfContents()>>


== Syntax ==
{{{#!highlight cpp
void SDL_AddHintCallback(const char*      name,
                         SDL_HintCallback callback,
                         void*            userdata)
}}}


== Function Parameters ==
||'''name'''||the hint to watch||
||'''callback'''||the function to call when the hint value changes||
||'''userdata'''||a pointer to pass to the callback function||


== Code Examples ==
{{{#!highlight cpp
You can add your code example here
}}}

##Leave this section as-is unless you have a code example to put in.  In that case, replace You can add your code example here with your code example following the Style Guide instructions.  Leave the rest of the markup alone and delete this comment.


== Remarks ==
The function prototype for '''callback''' is:
 {{{#!highlight cpp
void SDL_HintCallback(void*       userdata,
                      const char* name,
                      const char* oldValue,
                      const char* newValue)
}}}
 . where its parameters are:
 ||`userdata`||what was passed as '''userdata''' to [[SDL_AddHintCallback]]()||
 ||`name`||what was passed as '''name''' to [[SDL_AddHintCallback]]()||
 ||`oldValue`||the old value||
 ||`newValue`||the new value||

== Version ==
This function is available since SDL 2.0.0.

== Related Functions ==
 .[[SDL_DelHintCallback]]

----
[[CategoryAPI]], [[CategoryHints]]
##See the Style Guide for instructions on editing the footer.