include/SDL_hints.h
changeset 12059 320b43d5e5a7
parent 11896 5607348c333f
child 12088 399cc39583cc
equal deleted inserted replaced
12058:1a1133e9c7d4 12059:320b43d5e5a7
   751  * The value of this hint is used at runtime, so it can be changed at any time.
   751  * The value of this hint is used at runtime, so it can be changed at any time.
   752  */
   752  */
   753 #define SDL_HINT_ANDROID_SEPARATE_MOUSE_AND_TOUCH "SDL_ANDROID_SEPARATE_MOUSE_AND_TOUCH"
   753 #define SDL_HINT_ANDROID_SEPARATE_MOUSE_AND_TOUCH "SDL_ANDROID_SEPARATE_MOUSE_AND_TOUCH"
   754 
   754 
   755  /**
   755  /**
       
   756  * \brief A variable to control whether we trap the Android back button to handle it manually.
       
   757  *        This is necessary for the right mouse button to work on some Android devices, or
       
   758  *        to be able to trap the back button for use in your code reliably.  If set to true,
       
   759  *        the back button will show up as an SDL_KEYDOWN / SDL_KEYUP pair with a keycode of 
       
   760  *        SDL_SCANCODE_AC_BACK.
       
   761  *
       
   762  * The variable can be set to the following values:
       
   763  *   "0"       - Back button will be handled as usual for system. (default)
       
   764  *   "1"       - Back button will be trapped, allowing you to handle the key press
       
   765  *               manually.  (This will also let right mouse click work on systems 
       
   766  *               where the right mouse button functions as back.)
       
   767  *
       
   768  * The value of this hint is used at runtime, so it can be changed at any time.
       
   769  */
       
   770 #define SDL_HINT_ANDROID_TRAP_BACK_BUTTON "SDL_ANDROID_TRAP_BACK_BUTTON"
       
   771 
       
   772  /**
   756  * \brief A variable to control whether the return key on the soft keyboard
   773  * \brief A variable to control whether the return key on the soft keyboard
   757  *        should hide the soft keyboard on Android and iOS.
   774  *        should hide the soft keyboard on Android and iOS.
   758  *
   775  *
   759  * The variable can be set to the following values:
   776  * The variable can be set to the following values:
   760  *   "0"       - The return key will be handled as a key event. This is the behaviour of SDL <= 2.0.3. (default)
   777  *   "0"       - The return key will be handled as a key event. This is the behaviour of SDL <= 2.0.3. (default)