Struct winit::event_loop::EventLoop

source ·
pub struct EventLoop<T: 'static> { /* private fields */ }
Expand description

Provides a way to retrieve events from the system and from the windows that were registered to the events loop.

An EventLoop can be seen more or less as a “context”. Calling EventLoop::new initializes everything that will be required to create windows. For example on Linux creating an event loop opens a connection to the X or Wayland server.

To wake up an EventLoop from a another thread, see the EventLoopProxy docs.

Note that this cannot be shared across threads (due to platform-dependant logic forbidding it), as such it is neither Send nor Sync. If you need cross-thread access, the Window created from this can be sent to an other thread, and the EventLoopProxy allows you to wake up an EventLoop from another thread.

Implementations§

source§

impl EventLoop<()>

source§

impl<T> EventLoop<T>

source

pub fn with_user_event() -> Result<EventLoop<T>, EventLoopError>

👎Deprecated: Use EventLoopBuilder::<T>::with_user_event().build() instead.
source

pub fn run<F>(self, event_handler: F) -> Result<(), EventLoopError>
where F: FnMut(Event<T>, &EventLoopWindowTarget<T>),

Runs the event loop in the calling thread and calls the given event_handler closure to dispatch any pending events.

Since the closure is 'static, it must be a move closure if it needs to access any data from the calling context.

See the set_control_flow() docs on how to change the event loop’s behavior.

Platform-specific
  • iOS: Will never return to the caller and so values not passed to this function will not be dropped before the process exits.

  • Web: Will act as if it never returns to the caller by throwing a Javascript exception (that Rust doesn’t see) that will also mean that the rest of the function is never executed and any values not passed to this function will not be dropped.

    Web applications are recommended to use EventLoopExtWebSys::spawn() 1 instead of run() to avoid the need for the Javascript exception trick, and to make it clearer that the event loop runs asynchronously (via the browser’s own, internal, event loop) and doesn’t block the current thread of execution like it does on other platforms.

    This function won’t be available with target_feature = "exception-handling".


  1. EventLoopExtWebSys::spawn() is only available on WASM. 

source

pub fn create_proxy(&self) -> EventLoopProxy<T>

Creates an EventLoopProxy that can be used to dispatch user events to the main event loop.

Methods from Deref<Target = EventLoopWindowTarget<T>>§

source

pub fn available_monitors(&self) -> impl Iterator<Item = MonitorHandle>

Returns the list of all the monitors available on the system.

source

pub fn primary_monitor(&self) -> Option<MonitorHandle>

Returns the primary monitor of the system.

Returns None if it can’t identify any monitor as a primary one.

Platform-specific

Wayland / Web: Always returns None.

source

pub fn listen_device_events(&self, allowed: DeviceEvents)

Change if or when DeviceEvents are captured.

Since the DeviceEvent capture can lead to high CPU usage for unfocused windows, winit will ignore them by default for unfocused windows on Linux/BSD. This method allows changing this at runtime to explicitly capture them again.

Platform-specific
  • Wayland / macOS / iOS / Android / Orbital: Unsupported.
source

pub fn set_control_flow(&self, control_flow: ControlFlow)

Sets the ControlFlow.

source

pub fn control_flow(&self) -> ControlFlow

Gets the current ControlFlow.

source

pub fn exit(&self)

This exits the event loop.

See LoopExiting.

source

pub fn exiting(&self) -> bool

Returns if the EventLoop is about to stop.

See exit().

Trait Implementations§

source§

impl<T> AsFd for EventLoop<T>

source§

fn as_fd(&self) -> BorrowedFd<'_>

Get the underlying EventLoop’s fd which you can register into other event loop, like calloop or mio. When doing so, the loop must be polled with the pump_events API.

source§

impl<T> AsRawFd for EventLoop<T>

source§

fn as_raw_fd(&self) -> RawFd

Get the underlying EventLoop’s raw fd which you can register into other event loop, like calloop or mio. When doing so, the loop must be polled with the pump_events API.

source§

impl<T> Debug for EventLoop<T>

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl<T> Deref for EventLoop<T>

§

type Target = EventLoopWindowTarget<T>

The resulting type after dereferencing.
source§

fn deref(&self) -> &EventLoopWindowTarget<T>

Dereferences the value.
source§

impl<T> EventLoopExtPumpEvents for EventLoop<T>

§

type UserEvent = T

A type provided by the user that can be passed through Event::UserEvent.
source§

fn pump_events<F>( &mut self, timeout: Option<Duration>, event_handler: F ) -> PumpStatus

Pump the EventLoop to check for and dispatch pending events. Read more
source§

impl<T> EventLoopExtRunOnDemand for EventLoop<T>

§

type UserEvent = T

A type provided by the user that can be passed through Event::UserEvent.
source§

fn run_on_demand<F>(&mut self, event_handler: F) -> Result<(), EventLoopError>

Runs the event loop in the calling thread and calls the given event_handler closure to dispatch any window system events. Read more
source§

impl<T> HasDisplayHandle for EventLoop<T>

source§

fn display_handle(&self) -> Result<DisplayHandle<'_>, HandleError>

Get a handle to the display controller of the windowing system.

Auto Trait Implementations§

§

impl<T> !RefUnwindSafe for EventLoop<T>

§

impl<T> !Send for EventLoop<T>

§

impl<T> !Sync for EventLoop<T>

§

impl<T> Unpin for EventLoop<T>
where T: Unpin,

§

impl<T> !UnwindSafe for EventLoop<T>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> AsSource for T
where T: AsFd,

source§

fn source(&self) -> BorrowedFd<'_>

Returns the borrowed file descriptor.
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> Downcast for T
where T: Any,

source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
source§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> HasRawDisplayHandle for T
where T: HasDisplayHandle + ?Sized,

source§

fn raw_display_handle(&self) -> Result<RawDisplayHandle, HandleError>

👎Deprecated: Use HasDisplayHandle instead
source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more