Skip to main content

Application

Struct Application 

Source
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

Source

pub fn new() -> Self

Creates an application using the current theme and default window options.

Source

pub fn window(self, options: WindowOptions) -> Self

Replaces the native window, presentation and root text settings.

Source

pub fn title(self, title: impl Into<String>) -> Self

Sets the native window’s title.

Source

pub fn size(self, width: f32, height: f32) -> Self

Initial inner size in logical pixels.

Source

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.

Source

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.

Source

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.

Source

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.

Source

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§

Source§

impl Default for Application

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

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> 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<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

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> 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> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

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

Source§

type Error = !

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

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

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

Source§

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