Trait cosmic::app::Application

pub trait Application
where
    Self: Sized + 'static,
{
    type Executor: Executor;
    type Flags;
    type Message: Clone + Debug + Send + 'static;

    const APP_ID: &'static str;

    // Required methods
    fn core(&self) -> &Core;
    fn core_mut(&mut self) -> &mut Core;
    fn init(core: Core, flags: Self::Flags) -> (Self, Task<Self::Message>);
    fn view(&self) -> Element<'_, Self::Message>;

    // Provided methods
    fn context_drawer(&self) -> Option<Element<'_, Self::Message>> { ... }
    fn context_header_actions(&self) -> Vec<Element<'_, Message<Self::Message>>> { ... }
    fn context_drawer_header(
        &self,
    ) -> Option<Element<'_, Message<Self::Message>>> { ... }
    fn context_drawer_footer(
        &self,
    ) -> Option<Element<'_, Message<Self::Message>>> { ... }
    fn dialog(&self) -> Option<Element<'_, Self::Message>> { ... }
    fn footer(&self) -> Option<Element<'_, Self::Message>> { ... }
    fn header_start(&self) -> Vec<Element<'_, Self::Message>> { ... }
    fn header_center(&self) -> Vec<Element<'_, Self::Message>> { ... }
    fn header_end(&self) -> Vec<Element<'_, Self::Message>> { ... }
    fn nav_bar(&self) -> Option<Element<'_, Message<Self::Message>>> { ... }
    fn nav_context_menu(
        &self,
        id: Id,
    ) -> Option<Vec<Tree<'_, Message<Self::Message>>>> { ... }
    fn nav_model(&self) -> Option<&Model> { ... }
    fn on_app_exit(&mut self) -> Option<Self::Message> { ... }
    fn on_close_requested(&self, id: Id) -> Option<Self::Message> { ... }
    fn on_context_drawer(&mut self) -> Task<Self::Message> { ... }
    fn on_escape(&mut self) -> Task<Self::Message> { ... }
    fn on_nav_select(&mut self, id: Id) -> Task<Self::Message> { ... }
    fn on_nav_context(&mut self, id: Id) -> Task<Self::Message> { ... }
    fn on_search(&mut self) -> Task<Self::Message> { ... }
    fn on_window_resize(&mut self, id: Id, width: f32, height: f32) { ... }
    fn subscription(&self) -> Subscription<Self::Message> { ... }
    fn update(&mut self, message: Self::Message) -> Task<Self::Message> { ... }
    fn system_theme_update(
        &mut self,
        keys: &[&'static str],
        new_theme: &Theme,
    ) -> Task<Self::Message> { ... }
    fn system_theme_mode_update(
        &mut self,
        keys: &[&'static str],
        new_theme: &ThemeMode,
    ) -> Task<Self::Message> { ... }
    fn view_window(&self, id: Id) -> Element<'_, Self::Message> { ... }
    fn style(&self) -> Option<Appearance> { ... }
}

An interactive cross-platform COSMIC application.

Required Associated Types

type Executor: Executor

Default async executor to use with the app.

type Flags

Argument received [Application::new].

type Message: Clone + Debug + Send + 'static

Message type specific to our app.

Required Associated Constants

const APP_ID: &'static str

An ID that uniquely identifies the application. The standard is to pick an ID based on a reverse-domain name notation. IE: com.system76.Settings

Required Methods

fn core(&self) -> &Core

Grants access to the COSMIC Core.

fn core_mut(&mut self) -> &mut Core

Grants access to the COSMIC Core.

fn init(core: Core, flags: Self::Flags) -> (Self, Task<Self::Message>)

Creates the application, and optionally emits command on initialize.

fn view(&self) -> Element<'_, Self::Message>

Constructs the view for the main window.

Provided Methods

fn context_drawer(&self) -> Option<Element<'_, Self::Message>>

Displays a context drawer on the side of the application window when Some.

fn context_header_actions(&self) -> Vec<Element<'_, Message<Self::Message>>>

App-specific actions at the start of the context drawer header

fn context_drawer_header(&self) -> Option<Element<'_, Message<Self::Message>>>

Non-scrolling elements placed below the context drawer title row

fn context_drawer_footer(&self) -> Option<Element<'_, Message<Self::Message>>>

Elements placed below the context drawer scrollable

fn dialog(&self) -> Option<Element<'_, Self::Message>>

Displays a dialog in the center of the application window when Some.

fn footer(&self) -> Option<Element<'_, Self::Message>>

Displays a footer at the bottom of the application window when Some.

fn header_start(&self) -> Vec<Element<'_, Self::Message>>

Attaches elements to the start section of the header.

fn header_center(&self) -> Vec<Element<'_, Self::Message>>

Attaches elements to the center of the header.

fn header_end(&self) -> Vec<Element<'_, Self::Message>>

Attaches elements to the end section of the header.

fn nav_bar(&self) -> Option<Element<'_, Message<Self::Message>>>

Allows overriding the default nav bar widget.

fn nav_context_menu( &self, id: Id, ) -> Option<Vec<Tree<'_, Message<Self::Message>>>>

Shows a context menu for the active nav bar item.

fn nav_model(&self) -> Option<&Model>

Allows COSMIC to integrate with your application’s nav_bar::Model.

fn on_app_exit(&mut self) -> Option<Self::Message>

Called before closing the application. Returning a message will override closing windows.

fn on_close_requested(&self, id: Id) -> Option<Self::Message>

Called when a window requests to be closed.

fn on_context_drawer(&mut self) -> Task<Self::Message>

fn on_escape(&mut self) -> Task<Self::Message>

Called when the escape key is pressed.

fn on_nav_select(&mut self, id: Id) -> Task<Self::Message>

Called when a navigation item is selected.

fn on_nav_context(&mut self, id: Id) -> Task<Self::Message>

Called when a context menu is requested for a navigation item.

fn on_search(&mut self) -> Task<Self::Message>

Called when the search function is requested.

fn on_window_resize(&mut self, id: Id, width: f32, height: f32)

Called when a window is resized.

fn subscription(&self) -> Subscription<Self::Message>

Event sources that are to be listened to.

fn update(&mut self, message: Self::Message) -> Task<Self::Message>

Respond to an application-specific message.

fn system_theme_update( &mut self, keys: &[&'static str], new_theme: &Theme, ) -> Task<Self::Message>

Respond to a system theme change

fn system_theme_mode_update( &mut self, keys: &[&'static str], new_theme: &ThemeMode, ) -> Task<Self::Message>

Respond to a system theme mode change

fn view_window(&self, id: Id) -> Element<'_, Self::Message>

Constructs views for other windows.

fn style(&self) -> Option<Appearance>

Overrides the default style for applications

Object Safety

This trait is not object safe.

Implementors