# Event Handling

'''Include File(s):'''  [http://hg.libsdl.org/SDL/file/default/include/SDL_events.h SDL_events.h]


## Introduction
Event handling allows your application to receive input from the user. Event handling is initialized (along with video) with a call to:

<syntaxhighlight lang='c'>
SDL_Init(SDL_INIT_VIDEO);
</syntaxhighlight>

 (''see'' [[CategoryInit|Initialization & Shutdown]] and [[SDL_Init]]() ''for details'')

Internally, SDL stores all the events waiting to be handled in an event queue.  Using functions like [[SDL_PollEvent]](), [[SDL_PeepEvents]]() and [[SDL_WaitEvent]]() you can observe and handle waiting input events.

The event queue itself is composed of a series of [[SDL_Event]] structures, one for each waiting event. [[SDL_Event]] structures are read from the queue with the [[SDL_PollEvent]]() function and it is then up to the application to process the information stored with them.

## Enumerations
<<FullSearchCached(category:CategoryEvents -category:CategoryStruct -category:CategoryAPI -title:SGEnumerations)>>

## Structures
<<FullSearchCached(category:CategoryEvents -category:CategoryEnum -category:CategoryAPI -title:SGStructures)>>

## Functions
<<FullSearchCached(category:CategoryEvents -category:CategoryEnum -category:CategoryStruct -title:SGFunctions)>>

<!-- BEGIN CATEGORY LIST -->
- [SDL_AddEventWatch](SDL_AddEventWatch)
- [SDL_AudioDeviceEvent](SDL_AudioDeviceEvent)
- [SDL_DelEventWatch](SDL_DelEventWatch)
- [SDL_DropEvent](SDL_DropEvent)
- [SDL_Event](SDL_Event)
- [SDL_EventFilter](SDL_EventFilter)
- [SDL_EventType](SDL_EventType)
- [SDL_FilterEvents](SDL_FilterEvents)
- [SDL_Finger](SDL_Finger)
- [SDL_FlushEvent](SDL_FlushEvent)
- [SDL_FlushEvents](SDL_FlushEvents)
- [SDL_GamepadAxisEvent](SDL_GamepadAxisEvent)
- [SDL_GamepadButtonEvent](SDL_GamepadButtonEvent)
- [SDL_GamepadDeviceEvent](SDL_GamepadDeviceEvent)
- [SDL_GetEventFilter](SDL_GetEventFilter)
- [SDL_GetNumTouchDevices](SDL_GetNumTouchDevices)
- [SDL_GetNumTouchFingers](SDL_GetNumTouchFingers)
- [SDL_GetTouchDevice](SDL_GetTouchDevice)
- [SDL_GetTouchFinger](SDL_GetTouchFinger)
- [SDL_HasEvent](SDL_HasEvent)
- [SDL_HasEvents](SDL_HasEvents)
- [SDL_JoyAxisEvent](SDL_JoyAxisEvent)
- [SDL_JoyButtonEvent](SDL_JoyButtonEvent)
- [SDL_JoyDeviceEvent](SDL_JoyDeviceEvent)
- [SDL_JoyHatEvent](SDL_JoyHatEvent)
- [SDL_KeyboardEvent](SDL_KeyboardEvent)
- [SDL_MouseButtonEvent](SDL_MouseButtonEvent)
- [SDL_MouseMotionEvent](SDL_MouseMotionEvent)
- [SDL_MouseWheelEvent](SDL_MouseWheelEvent)
- [SDL_PeepEvents](SDL_PeepEvents)
- [SDL_PollEvent](SDL_PollEvent)
- [SDL_PumpEvents](SDL_PumpEvents)
- [SDL_PushEvent](SDL_PushEvent)
- [SDL_QuitEvent](SDL_QuitEvent)
- [SDL_QuitRequested](SDL_QuitRequested)
- [SDL_RegisterEvents](SDL_RegisterEvents)
- [SDL_SensorEvent](SDL_SensorEvent)
- [SDL_SetEventFilter](SDL_SetEventFilter)
- [SDL_SysWMEvent](SDL_SysWMEvent)
- [SDL_TextEditingEvent](SDL_TextEditingEvent)
- [SDL_TextInputEvent](SDL_TextInputEvent)
- [SDL_TouchFingerEvent](SDL_TouchFingerEvent)
- [SDL_UserEvent](SDL_UserEvent)
- [SDL_WaitEvent](SDL_WaitEvent)
- [SDL_WaitEventTimeout](SDL_WaitEventTimeout)
- [SDL_WindowEvent](SDL_WindowEvent)
<!-- END CATEGORY LIST -->

----
[CategoryCategory](CategoryCategory)