====== (This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!) ======
= SDL_EventState =

Set the state of processing events by type.

== Syntax ==

<syntaxhighlight lang='c'>
Uint8 SDL_EventState(Uint32 type, int state);
</syntaxhighlight>

== Function Parameters ==

{|
|'''type'''
|the type of event; see [[SDL_EventType]] for details
|-
|'''state'''
|how to process the event
|}

== Return Value ==

Returns <code>[[SDL_DISABLE]]</code> or <code>[[SDL_ENABLE]]</code>,
representing the processing state of the event before this function makes
any changes to it.

== Remarks ==

<code>state</code> may be any of the following:

* <code>[[SDL_QUERY]]</code>: returns the current processing state of the specified event
* <code>[[SDL_IGNORE]]</code> (aka <code>[[SDL_DISABLE]]</code>): the event will automatically be dropped from the event queue and will not be filtered
* <code>[[SDL_ENABLE]]</code>: the event will be processed normally

== Version ==

This function is available since SDL 3.0.0.

== Related Functions ==

:[[SDL_GetEventState]]

----
[[CategoryAPI]], [[CategoryEvents]]