Struct Application

pub struct Application<P>
where
    P: Program,
{ /* private fields */ }

The underlying definition and configuration of an iced application.

You can use this API to create and run iced applications step by step—without coupling your logic to a trait or a specific type.

You can create an Application with the application helper.

Implementations

impl<P> Application<P>

where P: Program,

pub fn run(self) -> Result<(), Error>

where Application<P>: 'static, <P as Program>::Message: MaybeDebug + MaybeClone,

Runs the Application.

pub fn settings(self, settings: Settings) -> Application<P>

Sets the Settings that will be used to run the Application.

pub fn antialiasing(self, antialiasing: bool) -> Application<P>

Sets the Settings::antialiasing of the Application.

pub fn default_font(self, default_font: Font) -> Application<P>

Sets the default Font of the Application.

pub fn font(self, font: impl Into<Cow<'static, [u8]>>) -> Application<P>

Adds a font to the list of fonts that will be loaded at the start of the Application.

pub fn window(self, window: Settings) -> Application<P>

Sets the window::Settings of the Application.

Overwrites any previous window::Settings.

pub fn centered(self) -> Application<P>

Sets the window::Settings::position to window::Position::Centered in the Application.

pub fn exit_on_close_request( self, exit_on_close_request: bool, ) -> Application<P>

Sets the window::Settings::exit_on_close_request of the Application.

pub fn window_size(self, size: impl Into<Size>) -> Application<P>

Sets the window::Settings::size of the Application.

pub fn transparent(self, transparent: bool) -> Application<P>

Sets the window::Settings::transparent of the Application.

pub fn resizable(self, resizable: bool) -> Application<P>

Sets the window::Settings::resizable of the Application.

pub fn decorations(self, decorations: bool) -> Application<P>

Sets the window::Settings::decorations of the Application.

pub fn position(self, position: Position) -> Application<P>

Sets the window::Settings::position of the Application.

pub fn level(self, level: Level) -> Application<P>

Sets the window::Settings::level of the Application.

pub fn title( self, title: impl TitleFn<<P as Program>::State>, ) -> Application<impl Program<State = <P as Program>::State, Message = <P as Program>::Message, Theme = <P as Program>::Theme>>

Sets the title of the Application.

pub fn subscription( self, f: impl Fn(&<P as Program>::State) -> Subscription<<P as Program>::Message>, ) -> Application<impl Program<State = <P as Program>::State, Message = <P as Program>::Message, Theme = <P as Program>::Theme>>

Sets the subscription logic of the Application.

pub fn theme( self, f: impl ThemeFn<<P as Program>::State, <P as Program>::Theme>, ) -> Application<impl Program<State = <P as Program>::State, Message = <P as Program>::Message, Theme = <P as Program>::Theme>>

Sets the theme logic of the Application.

pub fn style( self, f: impl Fn(&<P as Program>::State, &<P as Program>::Theme) -> Style, ) -> Application<impl Program<State = <P as Program>::State, Message = <P as Program>::Message, Theme = <P as Program>::Theme>>

Sets the style logic of the Application.

pub fn scale_factor( self, f: impl Fn(&<P as Program>::State) -> f32, ) -> Application<impl Program<State = <P as Program>::State, Message = <P as Program>::Message, Theme = <P as Program>::Theme>>

Sets the scale factor of the Application.

pub fn executor<E>( self, ) -> Application<impl Program<State = <P as Program>::State, Message = <P as Program>::Message, Theme = <P as Program>::Theme>>

where E: Executor,

Sets the executor of the Application.

pub fn presets( self, presets: impl IntoIterator<Item = Preset<<P as Program>::State, <P as Program>::Message>>, ) -> Application<P>

Sets the boot presets of the Application.

Presets can be used to override the default booting strategy of your application during testing to create reproducible environments.

Trait Implementations

impl<P> Debug for Application<P>

where P: Debug + Program, <P as Program>::State: Debug, <P as Program>::Message: Debug,

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

Formats the value using the given formatter.

impl<P> Program for Application<P>

where P: Program,

type State = <P as Program>::State

The state of the program.

type Message = <P as Program>::Message

The message of the program.

type Theme = <P as Program>::Theme

The theme of the program.

type Renderer = <P as Program>::Renderer

The renderer of the program.

type Executor = <P as Program>::Executor

The executor of the program.

fn name() -> &'static str

Returns the unique name of the Program.

fn settings(&self) -> Settings

fn window(&self) -> Option<Settings>

fn boot( &self, ) -> (<Application<P> as Program>::State, Task<<Application<P> as Program>::Message>)

fn update( &self, state: &mut <Application<P> as Program>::State, message: <Application<P> as Program>::Message, ) -> Task<<Application<P> as Program>::Message>

fn view<'a>( &self, state: &'a <Application<P> as Program>::State, window: Id, ) -> Element<'a, <Application<P> as Program>::Message, <Application<P> as Program>::Theme, <Application<P> as Program>::Renderer>

fn title( &self, state: &<Application<P> as Program>::State, window: Id, ) -> String

fn subscription( &self, state: &<Application<P> as Program>::State, ) -> Subscription<<Application<P> as Program>::Message>

fn theme( &self, state: &<Application<P> as Program>::State, window: Id, ) -> Option<<Application<P> as Program>::Theme>

fn style( &self, state: &<Application<P> as Program>::State, theme: &<Application<P> as Program>::Theme, ) -> Style

fn scale_factor( &self, state: &<Application<P> as Program>::State, window: Id, ) -> f64

fn presets( &self, ) -> &[Preset<<Application<P> as Program>::State, <Application<P> as Program>::Message>]