Enum IconId 

#[non_exhaustive]
pub enum IconId<'a> {
    Role(IconRole),
    Name(&'a str),
    Custom(&'a dyn IconProvider),
}

Identifies what icon to load: a semantic role, a platform-specific name, or a custom provider.

Constructed via From impls – users rarely reference this type directly. Pass an IconRole, &str, or &dyn IconProvider to a per-set loader’s new() constructor (e.g. FreedesktopLoader::new or MaterialLoader::new).

Examples

use native_theme::icons::IconId;
use native_theme::theme::IconRole;

// All of these work via Into<IconId>:
let _: IconId = IconRole::ActionSave.into();
let _: IconId = "edit-copy".into();

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Role(IconRole)

Load by semantic role (most common).

Name(&'a str)

Load by platform-specific name string.

Custom(&'a dyn IconProvider)

Load via a custom IconProvider implementation.

Trait Implementations

impl<'a> Debug for IconId<'a>

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

Formats the value using the given formatter.

impl<'a, T: IconProvider> From<&'a T> for IconId<'a>

A provider by reference, such as a variant of the icon enum native-theme-build generates: MaterialLoader::new(&AppIcon::PlayPause).

fn from(provider: &'a T) -> Self

Converts to this type from the input type.

impl<'a> From<&'a dyn IconProvider> for IconId<'a>

fn from(provider: &'a dyn IconProvider) -> Self

Converts to this type from the input type.

impl<'a> From<&'a str> for IconId<'a>

fn from(name: &'a str) -> Self

Converts to this type from the input type.

impl From<IconRole> for IconId<'_>

fn from(role: IconRole) -> Self

Converts to this type from the input type.