opensolaris man page for sdl_activeevent

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).

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 min-
       imised/iconified (gain=0) or restored.

	      Note:

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

SEE ALSO
       SDL_Event, SDL_GetAppState

SDL
							      Tue 11 Sep 2001, 22:59						SDL_ActiveEvent(3)