pub struct Application { /* private fields */ }Expand description
Runs a retained UI in one native window. The event loop sleeps while idle; animations request redraws paced by the swapchain’s presentation mode.
Implementations§
Source§impl Application
impl Application
Sourcepub fn new() -> Self
pub fn new() -> Self
Creates an application using the current theme and default window options.
Sourcepub fn window(self, options: WindowOptions) -> Self
pub fn window(self, options: WindowOptions) -> Self
Replaces the native window, presentation and root text settings.
Sourcepub fn key_bindings(
self,
bindings: impl IntoIterator<Item = KeyBinding>,
) -> Self
pub fn key_bindings( self, bindings: impl IntoIterator<Item = KeyBinding>, ) -> Self
Appends shortcuts to the action keymap used by the focused element path.
Register action handlers with kova_native_widgets::Interactive::on_action.
Sourcepub fn on_file_drop(self, callback: impl FnMut(PathBuf) + 'static) -> Self
pub fn on_file_drop(self, callback: impl FnMut(PathBuf) + 'static) -> Self
Registers a callback for files dropped onto the application window.
The operating system reports each dropped file separately, so the callback runs once per file when multiple files are dropped together.
Sourcepub fn on_close_request(self, callback: impl FnMut() -> bool + 'static) -> Self
pub fn on_close_request(self, callback: impl FnMut() -> bool + 'static) -> Self
Intercepts window close requests. Return true to close or false to
keep the window open. With no callback, close requests are accepted.
Sourcepub fn run_for(self, duration: Duration) -> Self
pub fn run_for(self, duration: Duration) -> Self
Ends the event loop after a bounded duration, even when the UI is idle. Useful for native startup smoke tests and automated example runs.
Sourcepub fn run<E: IntoElement>(
self,
build: impl FnMut() -> E + 'static,
) -> KovaResult<RunReport>
pub fn run<E: IntoElement>( self, build: impl FnMut() -> E + 'static, ) -> KovaResult<RunReport>
Mounts the root builder and runs until the window closes.
Signals read directly by build rebuild its region. Read frequently
changing state in text/bind closures to update individual nodes.
State that must survive root rebuilds should be owned outside build.
Call this on the main thread with an active native windowing session.
The returned RunReport describes frames actually presented. Platform,
GPU initialization and rendering failures are returned as KovaError.
Trait Implementations§
Auto Trait Implementations§
impl !RefUnwindSafe for Application
impl !Send for Application
impl !Sync for Application
impl !UnwindSafe for Application
impl Freeze for Application
impl Unpin for Application
impl UnsafeUnpin for Application
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
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>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
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)
fn as_any(&self) -> &(dyn Any + 'static)
&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)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.