logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SDL_EventType - The types of events that can be delivered.

Availability

       This enum is available since SDL 3.2.0.

Simple Directmedia Layer                           SDL 3.2.10                               SDL_EventType(3type)

Header File

       Defined in SDL3/SDL_events.h

Name

       SDL_EventType - The types of events that can be delivered.

Synopsis

#include"SDL3/SDL.h"typedefenumSDL_EventType{SDL_EVENT_FIRST=0,/**<Unused(donotremove)*//*Applicationevents*/SDL_EVENT_QUIT=0x100,/**<User-requestedquit*//*TheseapplicationeventshavespecialmeaningoniOSandAndroid,seeREADME-ios.mdandREADME-android.mdfordetails*/SDL_EVENT_TERMINATING,/**<TheapplicationisbeingterminatedbytheOS.ThiseventmustbehandledinacallbacksetwithSDL_AddEventWatch().CalledoniOSinapplicationWillTerminate()CalledonAndroidinonDestroy()*/SDL_EVENT_LOW_MEMORY,/**<Theapplicationislowonmemory,freememoryifpossible.ThiseventmustbehandledinacallbacksetwithSDL_AddEventWatch().CalledoniOSinapplicationDidReceiveMemoryWarning()CalledonAndroidinonTrimMemory()*/SDL_EVENT_WILL_ENTER_BACKGROUND,/**<Theapplicationisabouttoenterthebackground.ThiseventmustbehandledinacallbacksetwithSDL_AddEventWatch().CalledoniOSinapplicationWillResignActive()CalledonAndroidinonPause()*/SDL_EVENT_DID_ENTER_BACKGROUND,/**<TheapplicationdidenterthebackgroundandmaynotgetCPUforsometime.ThiseventmustbehandledinacallbacksetwithSDL_AddEventWatch().CalledoniOSinapplicationDidEnterBackground()CalledonAndroidinonPause()*/SDL_EVENT_WILL_ENTER_FOREGROUND,/**<Theapplicationisabouttoentertheforeground.ThiseventmustbehandledinacallbacksetwithSDL_AddEventWatch().CalledoniOSinapplicationWillEnterForeground()CalledonAndroidinonResume()*/SDL_EVENT_DID_ENTER_FOREGROUND,/**<Theapplicationisnowinteractive.ThiseventmustbehandledinacallbacksetwithSDL_AddEventWatch().CalledoniOSinapplicationDidBecomeActive()CalledonAndroidinonResume()*/SDL_EVENT_LOCALE_CHANGED,/**<Theuser'slocalepreferenceshavechanged.*/SDL_EVENT_SYSTEM_THEME_CHANGED,/**<Thesystemthemechanged*//*Displayevents*//*0x150wasSDL_DISPLAYEVENT,reservethenumberforsdl2-compat*/SDL_EVENT_DISPLAY_ORIENTATION=0x151,/**<Displayorientationhaschangedtodata1*/SDL_EVENT_DISPLAY_ADDED,/**<Displayhasbeenaddedtothesystem*/SDL_EVENT_DISPLAY_REMOVED,/**<Displayhasbeenremovedfromthesystem*/SDL_EVENT_DISPLAY_MOVED,/**<Displayhaschangedposition*/SDL_EVENT_DISPLAY_DESKTOP_MODE_CHANGED,/**<Displayhaschangeddesktopmode*/SDL_EVENT_DISPLAY_CURRENT_MODE_CHANGED,/**<Displayhaschangedcurrentmode*/SDL_EVENT_DISPLAY_CONTENT_SCALE_CHANGED,/**<Displayhaschangedcontentscale*/SDL_EVENT_DISPLAY_FIRST=SDL_EVENT_DISPLAY_ORIENTATION,SDL_EVENT_DISPLAY_LAST=SDL_EVENT_DISPLAY_CONTENT_SCALE_CHANGED,/*Windowevents*//*0x200wasSDL_WINDOWEVENT,reservethenumberforsdl2-compat*//*0x201wasSDL_SYSWMEVENT,reservethenumberforsdl2-compat*/SDL_EVENT_WINDOW_SHOWN=0x202,/**<Windowhasbeenshown*/SDL_EVENT_WINDOW_HIDDEN,/**<Windowhasbeenhidden*/SDL_EVENT_WINDOW_EXPOSED,/**<Windowhasbeenexposedandshouldberedrawn,andcanberedrawndirectlyfromeventwatchersforthisevent*/SDL_EVENT_WINDOW_MOVED,/**<Windowhasbeenmovedtodata1,data2*/SDL_EVENT_WINDOW_RESIZED,/**<Windowhasbeenresizedtodata1xdata2*/SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED,/**<Thepixelsizeofthewindowhaschangedtodata1xdata2*/SDL_EVENT_WINDOW_METAL_VIEW_RESIZED,/**<ThepixelsizeofaMetalviewassociatedwiththewindowhaschanged*/SDL_EVENT_WINDOW_MINIMIZED,/**<Windowhasbeenminimized*/SDL_EVENT_WINDOW_MAXIMIZED,/**<Windowhasbeenmaximized*/SDL_EVENT_WINDOW_RESTORED,/**<Windowhasbeenrestoredtonormalsizeandposition*/SDL_EVENT_WINDOW_MOUSE_ENTER,/**<Windowhasgainedmousefocus*/SDL_EVENT_WINDOW_MOUSE_LEAVE,/**<Windowhaslostmousefocus*/SDL_EVENT_WINDOW_FOCUS_GAINED,/**<Windowhasgainedkeyboardfocus*/SDL_EVENT_WINDOW_FOCUS_LOST,/**<Windowhaslostkeyboardfocus*/SDL_EVENT_WINDOW_CLOSE_REQUESTED,/**<Thewindowmanagerrequeststhatthewindowbeclosed*/SDL_EVENT_WINDOW_HIT_TEST,/**<Windowhadahittestthatwasn'tSDL_HITTEST_NORMAL*/SDL_EVENT_WINDOW_ICCPROF_CHANGED,/**<TheICCprofileofthewindow'sdisplayhaschanged*/SDL_EVENT_WINDOW_DISPLAY_CHANGED,/**<Windowhasbeenmovedtodisplaydata1*/SDL_EVENT_WINDOW_DISPLAY_SCALE_CHANGED,/**<Windowdisplayscalehasbeenchanged*/SDL_EVENT_WINDOW_SAFE_AREA_CHANGED,/**<Thewindowsafeareahasbeenchanged*/SDL_EVENT_WINDOW_OCCLUDED,/**<Thewindowhasbeenoccluded*/SDL_EVENT_WINDOW_ENTER_FULLSCREEN,/**<Thewindowhasenteredfullscreenmode*/SDL_EVENT_WINDOW_LEAVE_FULLSCREEN,/**<Thewindowhasleftfullscreenmode*/SDL_EVENT_WINDOW_DESTROYED,/**<ThewindowwiththeassociatedIDisbeingorhasbeendestroyed.Ifthismessageisbeinghandledinaneventwatcher,thewindowhandleisstillvalidandcanstillbeusedtoretrieveanypropertiesassociatedwiththewindow.Otherwise,thehandlehasalreadybeendestroyedandallresourcesassociatedwithitareinvalid*/SDL_EVENT_WINDOW_HDR_STATE_CHANGED,/**<WindowHDRpropertieshavechanged*/SDL_EVENT_WINDOW_FIRST=SDL_EVENT_WINDOW_SHOWN,SDL_EVENT_WINDOW_LAST=SDL_EVENT_WINDOW_HDR_STATE_CHANGED,/*Keyboardevents*/SDL_EVENT_KEY_DOWN=0x300,/**<Keypressed*/SDL_EVENT_KEY_UP,/**<Keyreleased*/SDL_EVENT_TEXT_EDITING,/**<Keyboardtextediting(composition)*/SDL_EVENT_TEXT_INPUT,/**<Keyboardtextinput*/SDL_EVENT_KEYMAP_CHANGED,/**<Keymapchangedduetoasystemeventsuchasaninputlanguageorkeyboardlayoutchange.*/SDL_EVENT_KEYBOARD_ADDED,/**<Anewkeyboardhasbeeninsertedintothesystem*/SDL_EVENT_KEYBOARD_REMOVED,/**<Akeyboardhasbeenremoved*/SDL_EVENT_TEXT_EDITING_CANDIDATES,/**<Keyboardtexteditingcandidates*//*Mouseevents*/SDL_EVENT_MOUSE_MOTION=0x400,/**<Mousemoved*/SDL_EVENT_MOUSE_BUTTON_DOWN,/**<Mousebuttonpressed*/SDL_EVENT_MOUSE_BUTTON_UP,/**<Mousebuttonreleased*/SDL_EVENT_MOUSE_WHEEL,/**<Mousewheelmotion*/SDL_EVENT_MOUSE_ADDED,/**<Anewmousehasbeeninsertedintothesystem*/SDL_EVENT_MOUSE_REMOVED,/**<Amousehasbeenremoved*//*Joystickevents*/SDL_EVENT_JOYSTICK_AXIS_MOTION=0x600,/**<Joystickaxismotion*/SDL_EVENT_JOYSTICK_BALL_MOTION,/**<Joysticktrackballmotion*/SDL_EVENT_JOYSTICK_HAT_MOTION,/**<Joystickhatpositionchange*/SDL_EVENT_JOYSTICK_BUTTON_DOWN,/**<Joystickbuttonpressed*/SDL_EVENT_JOYSTICK_BUTTON_UP,/**<Joystickbuttonreleased*/SDL_EVENT_JOYSTICK_ADDED,/**<Anewjoystickhasbeeninsertedintothesystem*/SDL_EVENT_JOYSTICK_REMOVED,/**<Anopenedjoystickhasbeenremoved*/SDL_EVENT_JOYSTICK_BATTERY_UPDATED,/**<Joystickbatterylevelchange*/SDL_EVENT_JOYSTICK_UPDATE_COMPLETE,/**<Joystickupdateiscomplete*//*Gamepadevents*/SDL_EVENT_GAMEPAD_AXIS_MOTION=0x650,/**<Gamepadaxismotion*/SDL_EVENT_GAMEPAD_BUTTON_DOWN,/**<Gamepadbuttonpressed*/SDL_EVENT_GAMEPAD_BUTTON_UP,/**<Gamepadbuttonreleased*/SDL_EVENT_GAMEPAD_ADDED,/**<Anewgamepadhasbeeninsertedintothesystem*/SDL_EVENT_GAMEPAD_REMOVED,/**<Agamepadhasbeenremoved*/SDL_EVENT_GAMEPAD_REMAPPED,/**<Thegamepadmappingwasupdated*/SDL_EVENT_GAMEPAD_TOUCHPAD_DOWN,/**<Gamepadtouchpadwastouched*/SDL_EVENT_GAMEPAD_TOUCHPAD_MOTION,/**<Gamepadtouchpadfingerwasmoved*/SDL_EVENT_GAMEPAD_TOUCHPAD_UP,/**<Gamepadtouchpadfingerwaslifted*/SDL_EVENT_GAMEPAD_SENSOR_UPDATE,/**<Gamepadsensorwasupdated*/SDL_EVENT_GAMEPAD_UPDATE_COMPLETE,/**<Gamepadupdateiscomplete*/SDL_EVENT_GAMEPAD_STEAM_HANDLE_UPDATED,/**<GamepadSteamhandlehaschanged*//*Touchevents*/SDL_EVENT_FINGER_DOWN=0x700,SDL_EVENT_FINGER_UP,SDL_EVENT_FINGER_MOTION,SDL_EVENT_FINGER_CANCELED,/*0x800,0x801,and0x802weretheGestureeventsfromSDL2.Donotreusethesevalues!sdl2-compatneedsthem!*//*Clipboardevents*/SDL_EVENT_CLIPBOARD_UPDATE=0x900,/**<Theclipboardorprimaryselectionchanged*//*Draganddropevents*/SDL_EVENT_DROP_FILE=0x1000,/**<Thesystemrequestsafileopen*/SDL_EVENT_DROP_TEXT,/**<text/plaindrag-and-dropevent*/SDL_EVENT_DROP_BEGIN,/**<Anewsetofdropsisbeginning(NULLfilename)*/SDL_EVENT_DROP_COMPLETE,/**<Currentsetofdropsisnowcomplete(NULLfilename)*/SDL_EVENT_DROP_POSITION,/**<Positionwhilemovingoverthewindow*//*Audiohotplugevents*/SDL_EVENT_AUDIO_DEVICE_ADDED=0x1100,/**<Anewaudiodeviceisavailable*/SDL_EVENT_AUDIO_DEVICE_REMOVED,/**<Anaudiodevicehasbeenremoved.*/SDL_EVENT_AUDIO_DEVICE_FORMAT_CHANGED,/**<Anaudiodevice'sformathasbeenchangedbythesystem.*//*Sensorevents*/SDL_EVENT_SENSOR_UPDATE=0x1200,/**<Asensorwasupdated*//*Pressure-sensitivepenevents*/SDL_EVENT_PEN_PROXIMITY_IN=0x1300,/**<Pressure-sensitivepenhasbecomeavailable*/SDL_EVENT_PEN_PROXIMITY_OUT,/**<Pressure-sensitivepenhasbecomeunavailable*/SDL_EVENT_PEN_DOWN,/**<Pressure-sensitivepentoucheddrawingsurface*/SDL_EVENT_PEN_UP,/**<Pressure-sensitivepenstoppedtouchingdrawingsurface*/SDL_EVENT_PEN_BUTTON_DOWN,/**<Pressure-sensitivepenbuttonpressed*/SDL_EVENT_PEN_BUTTON_UP,/**<Pressure-sensitivepenbuttonreleased*/SDL_EVENT_PEN_MOTION,/**<Pressure-sensitivepenismovingonthetablet*/SDL_EVENT_PEN_AXIS,/**<Pressure-sensitivepenangle/pressure/etcchanged*//*Camerahotplugevents*/SDL_EVENT_CAMERA_DEVICE_ADDED=0x1400,/**<Anewcameradeviceisavailable*/SDL_EVENT_CAMERA_DEVICE_REMOVED,/**<Acameradevicehasbeenremoved.*/SDL_EVENT_CAMERA_DEVICE_APPROVED,/**<Acameradevicehasbeenapprovedforusebytheuser.*/SDL_EVENT_CAMERA_DEVICE_DENIED,/**<Acameradevicehasbeendeniedforusebytheuser.*//*Renderevents*/SDL_EVENT_RENDER_TARGETS_RESET=0x2000,/**<Therendertargetshavebeenresetandtheircontentsneedtobeupdated*/SDL_EVENT_RENDER_DEVICE_RESET,/**<Thedevicehasbeenresetandalltexturesneedtoberecreated*/SDL_EVENT_RENDER_DEVICE_LOST,/**<Thedevicehasbeenlostandcan'tberecovered.*//*Reservedeventsforprivateplatforms*/SDL_EVENT_PRIVATE0=0x4000,SDL_EVENT_PRIVATE1,SDL_EVENT_PRIVATE2,SDL_EVENT_PRIVATE3,/*Internalevents*/SDL_EVENT_POLL_SENTINEL=0x7F00,/**<Signalstheendofaneventpollcycle*//**EventsSDL_EVENT_USERthroughSDL_EVENT_LASTareforyouruse,*andshouldbeallocatedwithSDL_RegisterEvents()*/SDL_EVENT_USER=0x8000,/***Thislasteventisonlyforboundinginternalarrays*/SDL_EVENT_LAST=0xFFFF,/*ThisjustmakessuretheenumisthesizeofUint32*/SDL_EVENT_ENUM_PADDING=0x7FFFFFFF}SDL_EventType;

See Also