Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
SDL_SetEventFilter(3)
Edit
PageHistory
Diff
Info
LikePages
SDL_!SetEventFilter !!!SDL_!SetEventFilter NAME SYNOPSIS DESCRIPTION SEE ALSO ---- !!NAME SDL_!SetEventFilter- Sets up a filter to process all events before they are posted to the event queue. !!SYNOPSIS __#include __ __void SDL_!SetEventFilter__(__SDL_!EventFilter filter__); !!DESCRIPTION This function sets up a filter to process all events before they are posted to the event queue. This is a very powerful and flexible feature. The filter is prototyped as: typedef int (*SDL_!EventFilter)(const SDL_Event *event); If the filter returns __1__, then the event will be added to the internal queue. If it returns __0__, then the event will be dropped from the queue. This allows selective filtering of dynamically. There is one caveat when dealing with the __SDL_QUITEVENT__ event type. The event filter is only called when the window manager desires to close the application window. If the event filter returns 1, then the window will be closed, otherwise the window will remain open if possible. If the quit event is generated by an interrupt signal, it will bypass the internal queue and be delivered to the application at the next event poll. __Note:__ Events pushed onto the queue with __SDL_!PushEvent__ or __SDL_!PeepEvents__ do not get passed through the event filter. __Note:__ ''Be Careful!'' The event filter function may run in a different thread so be careful what you do within it. !!SEE ALSO __SDL_Event__, __SDL_!GetEventFilter__, __SDL_!PushEvent__ ----
One page links to
SDL_SetEventFilter(3)
:
SDLManPages
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
