Enum cacao::image::MacSystemIcon

pub enum MacSystemIcon {
    PreferencesGeneral,
    PreferencesAdvanced,
    PreferencesUserAccounts,
    Add,
    Remove,
    Folder,
}

These icons are system-provided icons that are guaranteed to exist in all versions of macOS that Cacao supports. These will use SFSymbols on Big Sur and onwards (11.0+), and the correct controls for prior macOS versions.

Note that this list is by default small, as icons that match across OS’s is limited in nature. You’ll need to determine if and/or how you choose to support icons for systems older than Big Sur; SFSymbols does not exist on Catalina, Mojave, and earlier.

You can opt to include vector assets in your bundle, or draw icons with Image::draw by converting Core Graphics calls (e.g, PaintCode can work well for this).

Variants

PreferencesGeneral

A standard “General” preferences icon. This is intended for usage in Preferences toolbars.

PreferencesAdvanced

A standard “Advanced” preferences icon. This is intended for usage in Preferences toolbars.

PreferencesUserAccounts

A standard “Accounts” preferences icon. This is intended for usage in Preferences toolbars.

Add

Returns a stock “+” icon that’s common to the system. Use this for buttons that need the symbol.

Remove

A stock “-” icon that’s common to the system. Use this for buttons that need the symbol.

Folder

Returns a Folder icon.

Implementations

impl MacSystemIcon

pub fn to_id(&self) -> id

Maps system icons to their pre-11.0 framework identifiers.

pub fn to_sfsymbol_str(&self) -> &'static str

Maps system icons to their SFSymbols-counterparts for use on 11.0+.

Trait Implementations

impl Debug for MacSystemIcon

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

Formats the value using the given formatter.