Struct Action 

pub struct Action {
    pub id: Arc<str>,
    pub label: Arc<str>,
    pub icon: Option<Arc<str>>,
    pub shortcut: Option<KeyChord>,
    pub enabled: bool,
    pub checked: Option<bool>,
}

A high-level user-invokable command. One Action ties together the menu item, toolbar button, and keyboard shortcut that all do the same thing - the model Qt’s QAction and GTK 4’s GAction use.

Lives in ActionRegistry (or a similar resource) per the OS plan (section 470). Backends translate the action into a menu item, hotkey, or toolbar button as appropriate.

Fields

id: Arc<str>

Stable id used to dispatch ActionInvoked { id } and to look the action up across hot-reloads.

label: Arc<str>

Human-visible label.

icon: Option<Arc<str>>

Optional icon identifier (asset path or theme name).

shortcut: Option<KeyChord>

Optional keyboard shortcut.

enabled: bool

true when the action can be invoked.

checked: Option<bool>

Some(true|false) for a check / radio action; None for a plain action.

Implementations

impl Action

pub fn new(id: impl Into<Arc<str>>, label: impl Into<Arc<str>>) -> Self

Construct a plain enabled action with no shortcut, icon, or check state.

pub fn with_shortcut(self, chord: impl Into<KeyChord>) -> Self

Builder: set the keyboard shortcut.

pub fn with_icon(self, icon: impl Into<Arc<str>>) -> Self

Builder: set the icon.

pub fn enabled(self, on: bool) -> Self

Builder: set the enabled flag.

pub fn checked(self, on: bool) -> Self

Builder: turn into a check action with the supplied initial state.

Trait Implementations

impl Clone for Action

fn clone(&self) -> Action

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Action

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

Formats the value using the given formatter.

impl From<&str> for Action

fn from(entry: &str) -> Self

Read one id:label entry of an action spec. An entry with no : uses its whole text as both id and label, and a lone - is the separator.