Trait tao::platform::run_return::EventLoopExtRunReturn [−][src]
pub trait EventLoopExtRunReturn { type UserEvent; fn run_return<F>(&mut self, event_handler: F)
where
F: FnMut(Event<'_, Self::UserEvent>, &EventLoopWindowTarget<Self::UserEvent>, &mut ControlFlow); }
Expand description
Additional methods on EventLoop
to return control flow to the caller.
Associated Types
type UserEvent
[src]
Expand description
A type provided by the user that can be passed through Event::UserEvent
.
Required methods
fn run_return<F>(&mut self, event_handler: F) where
F: FnMut(Event<'_, Self::UserEvent>, &EventLoopWindowTarget<Self::UserEvent>, &mut ControlFlow),
[src]
F: FnMut(Event<'_, Self::UserEvent>, &EventLoopWindowTarget<Self::UserEvent>, &mut ControlFlow),
Expand description
Initializes the tao
event loop.
Unlike run
, this function accepts non-'static
(i.e. non-move
) closures and returns
control flow to the caller when control_flow
is set to ControlFlow::Exit
.
Caveats
Despite its appearance at first glance, this is not a perfect replacement for
poll_events
. For example, this function will not return on Windows or macOS while a
window is getting resized, resulting in all application logic outside of the
event_handler
closure not running until the resize operation ends. Other OS operations
may also result in such freezes. This behavior is caused by fundamental limitations in the
underlying OS APIs, which cannot be hidden by tao
without severe stability repercussions.
You are strongly encouraged to use run
, unless the use of this is absolutely necessary.
Implementors
impl<T> EventLoopExtRunReturn for EventLoop<T>
[src]
impl<T> EventLoopExtRunReturn for EventLoop<T>
[src]type UserEvent = T
fn run_return<F>(&mut self, event_handler: F) where
F: FnMut(Event<'_, Self::UserEvent>, &EventLoopWindowTarget<Self::UserEvent>, &mut ControlFlow),
[src]
F: FnMut(Event<'_, Self::UserEvent>, &EventLoopWindowTarget<Self::UserEvent>, &mut ControlFlow),