Struct ICONS

pub struct ICONS;

Service that provides icon drawing widgets.

This service enables widgets to use icons in an optional way, without needing to bundle icon resources. It also enables app wide icon theming.

Implementations

impl ICONS

pub fn register(&self, icon: WidgetFn<IconRequestArgs>)

Register an icon handler.

The handler must return NilUiNode if it cannot handle the request. Later added handlers are called first.

pub fn register_fallback(&self, icon: WidgetFn<IconRequestArgs>)

Register an icon handler to be called if none of the register handlers can handle request.

The handler must return NilUiNode if it cannot handle the request. Later added handlers are called last.

pub fn get(&self, icon_name: impl IconNames) -> BoxedUiNode

Instantiate an icon drawing widget for the icon_name.

Returns NilUiNode if no registered handler can provide an icon.

pub fn get_or<U: UiNode>( &self, icon_name: impl IconNames, fallback: impl FnOnce() -> U, ) -> BoxedUiNode

Instantiate an icon drawing widget for the icon_name or call fallback to do it if no handler can handle the request.

pub fn req(&self, icon_name: impl IconNames) -> BoxedUiNode

Same as get, but also logs an error is there are no available icon for any of the names.

pub fn req_or<U: UiNode>( &self, icon_name: impl IconNames, fallback: impl FnOnce() -> U, ) -> BoxedUiNode