Man Linux: Main Page and Category List

NAME

       SDL_ActiveEvent - Application visibility event structure

STRUCTURE DEFINITION

       typedef struct{
         Uint8 type;
         Uint8 gain;
         Uint8 state;
       } SDL_ActiveEvent;

STRUCTURE DATA

       type                SDL_ACTIVEEVENT.

       gain                0 if the event is a loss or 1 if it is a gain.

       state               SDL_APPMOUSEFOCUS  if  mouse  focus  was  gained or
                           lost, SDL_APPINPUTFOCUS if input focus  was  gained
                           or  lost,  or  SDL_APPACTIVE if the application was
                           iconified (gain=0) or restored(gain=1).

DESCRIPTION

       SDL_ActiveEvent is a member of the SDL_Event union and is used when  an
       event of type SDL_ACTIVEEVENT is reported.

       When  the  mouse  leaves  or enters the window area a SDL_APPMOUSEFOCUS
       type activation event occurs, if the mouse entered the window then gain
       will  be  1,  otherwise  gain  will  be  0.  A  SDL_APPINPUTFOCUS  type
       activation event occurs when the application loses  or  gains  keyboard
       focus.  This  usually  occurs  when another application is made active.
       Finally, a SDL_APPACTIVE type event  occurs  when  the  application  is
       either minimised/iconified (gain=0) or restored.

              Note:

              This  event  does  not occur when an application window is first
              created.

SEE ALSO

       SDL_Event, SDL_GetAppState