Struct EventLoopBuilder

pub struct EventLoopBuilder<T: 'static> { /* private fields */ }

Object that allows building the event loop.

This is used to make specifying options that affect the whole application easier. But note that constructing multiple event loops is not supported.

Implementations

impl EventLoopBuilder<()>

pub fn new() -> Self

Start building a new event loop.

impl<T> EventLoopBuilder<T>

pub fn with_user_event() -> Self

Start building a new event loop, with the given type as the user event type.

pub fn build(&mut self) -> EventLoop<T>

Builds a new event loop.

For cross-platform compatibility, the EventLoop must be created on the main thread. Attempting to create the event loop on a different thread will panic. This restriction isn’t strictly necessary on all platforms, but is imposed to eliminate any nasty surprises when porting to platforms that require it. EventLoopBuilderExt::any_thread functions are exposed in the relevant platform module if the target platform supports creating an event loop on any thread.

Usage will result in display backend initialisation, this can be controlled on linux using an environment variable WINIT_UNIX_BACKEND. Legal values are x11 and wayland. If it is not set, winit will try to connect to a wayland connection, and if it fails will fallback on x11. If this variable is set with any other value, winit will panic.

Platform-specific

• iOS: Can only be called on the main thread.

Trait Implementations

impl<T: Default + 'static> Default for EventLoopBuilder<T>

fn default() -> EventLoopBuilder<T>

Returns the “default value” for a type.

impl<T> EventLoopBuilderExtUnix for EventLoopBuilder<T>

fn with_any_thread(&mut self, any_thread: bool) -> &mut Self

Whether to allow the event loop to be created off of the main thread.

fn with_app_id<S: Into<String>>(&mut self, id: S) -> &mut Self

Set the gtk application id.