SDL_ActiveEvent(3) SDL API Reference SDL_ActiveEvent(3)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).
DESCRIPTIONSDL_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_APP-
MOUSEFOCUS 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 win-
dow is first created.
SEE ALSO
SDL_Event, SDL_GetAppState
SDL Tue 11 Sep 2001, 22:59 SDL_ActiveEvent(3)