SDL_EventType

The types of events that can be delivered.

Values

ValueMeaning
SDL_EVENT_FIRST0

< Unused (do not remove)

SDL_EVENT_QUIT0x100

< User-requested quit

SDL_EVENT_TERMINATING

< The application is being terminated by the OS. This event must be handled in a callback set with SDL_AddEventWatch(). Called on iOS in applicationWillTerminate() Called on Android in onDestroy()

SDL_EVENT_LOW_MEMORY

< The application is low on memory, free memory if possible. This event must be handled in a callback set with SDL_AddEventWatch(). Called on iOS in applicationDidReceiveMemoryWarning() Called on Android in onTrimMemory()

SDL_EVENT_WILL_ENTER_BACKGROUND

< The application is about to enter the background. This event must be handled in a callback set with SDL_AddEventWatch(). Called on iOS in applicationWillResignActive() Called on Android in onPause()

SDL_EVENT_DID_ENTER_BACKGROUND

< The application did enter the background and may not get CPU for some time. This event must be handled in a callback set with SDL_AddEventWatch(). Called on iOS in applicationDidEnterBackground() Called on Android in onPause()

SDL_EVENT_WILL_ENTER_FOREGROUND

< The application is about to enter the foreground. This event must be handled in a callback set with SDL_AddEventWatch(). Called on iOS in applicationWillEnterForeground() Called on Android in onResume()

SDL_EVENT_DID_ENTER_FOREGROUND

< The application is now interactive. This event must be handled in a callback set with SDL_AddEventWatch(). Called on iOS in applicationDidBecomeActive() Called on Android in onResume()

SDL_EVENT_LOCALE_CHANGED

< The user's locale preferences have changed.

SDL_EVENT_SYSTEM_THEME_CHANGED

< The system theme changed

SDL_EVENT_DISPLAY_ORIENTATION0x151

< Display orientation has changed to data1

SDL_EVENT_DISPLAY_ADDED

< Display has been added to the system

SDL_EVENT_DISPLAY_REMOVED

< Display has been removed from the system

SDL_EVENT_DISPLAY_MOVED

< Display has changed position

SDL_EVENT_DISPLAY_DESKTOP_MODE_CHANGED

< Display has changed desktop mode

SDL_EVENT_DISPLAY_CURRENT_MODE_CHANGED

< Display has changed current mode

SDL_EVENT_DISPLAY_CONTENT_SCALE_CHANGED

< Display has changed content scale

SDL_EVENT_DISPLAY_FIRSTSDL_EVENT_DISPLAY_ORIENTATION
SDL_EVENT_DISPLAY_LASTSDL_EVENT_DISPLAY_CONTENT_SCALE_CHANGED
SDL_EVENT_WINDOW_SHOWN0x202

< Window has been shown

SDL_EVENT_WINDOW_HIDDEN

< Window has been hidden

SDL_EVENT_WINDOW_EXPOSED

< Window has been exposed and should be redrawn, and can be redrawn directly from event watchers for this event

SDL_EVENT_WINDOW_MOVED

< Window has been moved to data1, data2

SDL_EVENT_WINDOW_RESIZED

< Window has been resized to data1xdata2

SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED

< The pixel size of the window has changed to data1xdata2

SDL_EVENT_WINDOW_METAL_VIEW_RESIZED

< The pixel size of a Metal view associated with the window has changed

SDL_EVENT_WINDOW_MINIMIZED

< Window has been minimized

SDL_EVENT_WINDOW_MAXIMIZED

< Window has been maximized

SDL_EVENT_WINDOW_RESTORED

< Window has been restored to normal size and position

SDL_EVENT_WINDOW_MOUSE_ENTER

< Window has gained mouse focus

SDL_EVENT_WINDOW_MOUSE_LEAVE

< Window has lost mouse focus

SDL_EVENT_WINDOW_FOCUS_GAINED

< Window has gained keyboard focus

SDL_EVENT_WINDOW_FOCUS_LOST

< Window has lost keyboard focus

SDL_EVENT_WINDOW_CLOSE_REQUESTED

< The window manager requests that the window be closed

SDL_EVENT_WINDOW_HIT_TEST

< Window had a hit test that wasn't SDL_HITTEST_NORMAL

SDL_EVENT_WINDOW_ICCPROF_CHANGED

< The ICC profile of the window's display has changed

SDL_EVENT_WINDOW_DISPLAY_CHANGED

< Window has been moved to display data1

SDL_EVENT_WINDOW_DISPLAY_SCALE_CHANGED

< Window display scale has been changed

SDL_EVENT_WINDOW_SAFE_AREA_CHANGED

< The window safe area has been changed

SDL_EVENT_WINDOW_OCCLUDED

< The window has been occluded

SDL_EVENT_WINDOW_ENTER_FULLSCREEN

< The window has entered fullscreen mode

SDL_EVENT_WINDOW_LEAVE_FULLSCREEN

< The window has left fullscreen mode

SDL_EVENT_WINDOW_DESTROYED

< The window with the associated ID is being or has been destroyed. If this message is being handled in an event watcher, the window handle is still valid and can still be used to retrieve any properties associated with the window. Otherwise, the handle has already been destroyed and all resources associated with it are invalid

SDL_EVENT_WINDOW_HDR_STATE_CHANGED

< Window HDR properties have changed

SDL_EVENT_WINDOW_FIRSTSDL_EVENT_WINDOW_SHOWN
SDL_EVENT_WINDOW_LASTSDL_EVENT_WINDOW_HDR_STATE_CHANGED
SDL_EVENT_KEY_DOWN0x300

< Key pressed

SDL_EVENT_KEY_UP

< Key released

SDL_EVENT_TEXT_EDITING

< Keyboard text editing (composition)

SDL_EVENT_TEXT_INPUT

< Keyboard text input

SDL_EVENT_KEYMAP_CHANGED

< Keymap changed due to a system event such as an input language or keyboard layout change.

SDL_EVENT_KEYBOARD_ADDED

< A new keyboard has been inserted into the system

SDL_EVENT_KEYBOARD_REMOVED

< A keyboard has been removed

SDL_EVENT_TEXT_EDITING_CANDIDATES

< Keyboard text editing candidates

SDL_EVENT_MOUSE_MOTION0x400

< Mouse moved

SDL_EVENT_MOUSE_BUTTON_DOWN

< Mouse button pressed

SDL_EVENT_MOUSE_BUTTON_UP

< Mouse button released

SDL_EVENT_MOUSE_WHEEL

< Mouse wheel motion

SDL_EVENT_MOUSE_ADDED

< A new mouse has been inserted into the system

SDL_EVENT_MOUSE_REMOVED

< A mouse has been removed

SDL_EVENT_JOYSTICK_AXIS_MOTION0x600

< Joystick axis motion

SDL_EVENT_JOYSTICK_BALL_MOTION

< Joystick trackball motion

SDL_EVENT_JOYSTICK_HAT_MOTION

< Joystick hat position change

SDL_EVENT_JOYSTICK_BUTTON_DOWN

< Joystick button pressed

SDL_EVENT_JOYSTICK_BUTTON_UP

< Joystick button released

SDL_EVENT_JOYSTICK_ADDED

< A new joystick has been inserted into the system

SDL_EVENT_JOYSTICK_REMOVED

< An opened joystick has been removed

SDL_EVENT_JOYSTICK_BATTERY_UPDATED

< Joystick battery level change

SDL_EVENT_JOYSTICK_UPDATE_COMPLETE

< Joystick update is complete

SDL_EVENT_GAMEPAD_AXIS_MOTION0x650

< Gamepad axis motion

SDL_EVENT_GAMEPAD_BUTTON_DOWN

< Gamepad button pressed

SDL_EVENT_GAMEPAD_BUTTON_UP

< Gamepad button released

SDL_EVENT_GAMEPAD_ADDED

< A new gamepad has been inserted into the system

SDL_EVENT_GAMEPAD_REMOVED

< A gamepad has been removed

SDL_EVENT_GAMEPAD_REMAPPED

< The gamepad mapping was updated

SDL_EVENT_GAMEPAD_TOUCHPAD_DOWN

< Gamepad touchpad was touched

SDL_EVENT_GAMEPAD_TOUCHPAD_MOTION

< Gamepad touchpad finger was moved

SDL_EVENT_GAMEPAD_TOUCHPAD_UP

< Gamepad touchpad finger was lifted

SDL_EVENT_GAMEPAD_SENSOR_UPDATE

< Gamepad sensor was updated

SDL_EVENT_GAMEPAD_UPDATE_COMPLETE

< Gamepad update is complete

SDL_EVENT_GAMEPAD_STEAM_HANDLE_UPDATED

< Gamepad Steam handle has changed

SDL_EVENT_FINGER_DOWN0x700
SDL_EVENT_FINGER_UP
SDL_EVENT_FINGER_MOTION
SDL_EVENT_FINGER_CANCELED
SDL_EVENT_CLIPBOARD_UPDATE0x900

< The clipboard or primary selection changed

SDL_EVENT_DROP_FILE0x1000

< The system requests a file open

SDL_EVENT_DROP_TEXT

< text/plain drag-and-drop event

SDL_EVENT_DROP_BEGIN

< A new set of drops is beginning (NULL filename)

SDL_EVENT_DROP_COMPLETE

< Current set of drops is now complete (NULL filename)

SDL_EVENT_DROP_POSITION

< Position while moving over the window

SDL_EVENT_AUDIO_DEVICE_ADDED0x1100

< A new audio device is available

SDL_EVENT_AUDIO_DEVICE_REMOVED

< An audio device has been removed.

SDL_EVENT_AUDIO_DEVICE_FORMAT_CHANGED

< An audio device's format has been changed by the system.

SDL_EVENT_SENSOR_UPDATE0x1200

< A sensor was updated

SDL_EVENT_PEN_PROXIMITY_IN0x1300

< Pressure-sensitive pen has become available

SDL_EVENT_PEN_PROXIMITY_OUT

< Pressure-sensitive pen has become unavailable

SDL_EVENT_PEN_DOWN

< Pressure-sensitive pen touched drawing surface

SDL_EVENT_PEN_UP

< Pressure-sensitive pen stopped touching drawing surface

SDL_EVENT_PEN_BUTTON_DOWN

< Pressure-sensitive pen button pressed

SDL_EVENT_PEN_BUTTON_UP

< Pressure-sensitive pen button released

SDL_EVENT_PEN_MOTION

< Pressure-sensitive pen is moving on the tablet

SDL_EVENT_PEN_AXIS

< Pressure-sensitive pen angle/pressure/etc changed

SDL_EVENT_CAMERA_DEVICE_ADDED0x1400

< A new camera device is available

SDL_EVENT_CAMERA_DEVICE_REMOVED

< A camera device has been removed.

SDL_EVENT_CAMERA_DEVICE_APPROVED

< A camera device has been approved for use by the user.

SDL_EVENT_CAMERA_DEVICE_DENIED

< A camera device has been denied for use by the user.

SDL_EVENT_RENDER_TARGETS_RESET0x2000

< The render targets have been reset and their contents need to be updated

SDL_EVENT_RENDER_DEVICE_RESET

< The device has been reset and all textures need to be recreated

SDL_EVENT_RENDER_DEVICE_LOST

< The device has been lost and can't be recovered.

SDL_EVENT_PRIVATE00x4000
SDL_EVENT_PRIVATE1
SDL_EVENT_PRIVATE2
SDL_EVENT_PRIVATE3
SDL_EVENT_POLL_SENTINEL0x7F00

< Signals the end of an event poll cycle

SDL_EVENT_USER0x8000

Events SDL_EVENT_USER through SDL_EVENT_LAST are for your use, and should be allocated with SDL_RegisterEvents()

SDL_EVENT_LAST0xFFFF

This last event is only for bounding internal arrays

SDL_EVENT_ENUM_PADDING0x7FFFFFFF

Meta