Struct sdl2::EventPump

pub struct EventPump { /* fields omitted */ }

A thread-safe type that encapsulates SDL event-pumping functions.

Methods

impl EventPump

pub fn is_event_enabled(&self, event_type: EventType) -> bool

Query if an event type is enabled.

pub fn enable_event(&mut self, event_type: EventType) -> bool

Enable an event type. Returns if the event type was enabled before the call.

pub fn disable_event(&mut self, event_type: EventType) -> bool

Disable an event type. Returns if the event type was enabled before the call.

pub fn poll_event(&mut self) -> Option<Event>

Polls for currently pending events.

If no events are pending, None is returned.

Important traits for EventPollIterator<'a>

impl<'a> Iterator for EventPollIterator<'a> type Item = Event;

pub fn poll_iter(&mut self) -> EventPollIterator

Returns a polling iterator that calls poll_event(). The iterator will terminate once there are no more pending events.

Example

let sdl_context = sdl2::init().unwrap();
let mut event_pump = sdl_context.event_pump().unwrap();

for event in event_pump.poll_iter() {
    use sdl2::event::Event;
    match event {
        Event::KeyDown {..} => { /*...*/ },
        _ => ()
    }
}

pub fn pump_events(&mut self)

Pumps the event loop, gathering events from the input devices.

pub fn wait_event(&mut self) -> Event

Waits indefinitely for the next available event.

pub fn wait_event_timeout(&mut self, timeout: u32) -> Option<Event>

Waits until the specified timeout (in milliseconds) for the next available event.

Important traits for EventWaitIterator<'a>

impl<'a> Iterator for EventWaitIterator<'a> type Item = Event;

pub fn wait_iter(&mut self) -> EventWaitIterator

Returns a waiting iterator that calls wait_event().

Note: The iterator will never terminate.

Important traits for EventWaitTimeoutIterator<'a>

impl<'a> Iterator for EventWaitTimeoutIterator<'a> type Item = Event;

pub fn wait_timeout_iter(&mut self, timeout: u32) -> EventWaitTimeoutIterator

Returns a waiting iterator that calls wait_event_timeout().

Note: The iterator will never terminate, unless waiting for an event exceeds the specified timeout.

pub fn keyboard_state(&self) -> KeyboardState

pub fn mouse_state(&self) -> MouseState

pub fn relative_mouse_state(&self) -> RelativeMouseState

Trait Implementations

impl Drop for EventPump

fn drop(&mut self)

Executes the destructor for this type.