Struct zng::style::Style

pub struct Style(/* private fields */);

W Represents a set of properties that can be applied to any styleable widget.

Style can be instantiated using the same syntax as any widget, but it produces a StyleBuilder instance instead of a widget. Widgets that have StyleMix<P> can be modified using properties defined in a style, the properties are dynamically spliced into each widget instance.

Extend/Replace

Style instances extend the contextual style by default, meaning all properties set on the style are inserted over the parent style, so properties set on the contextual style that are not reset in the new style are retained. You can set replace on a style to true to fully remove all contextual properties and only use the new style properties.

Inherit Style

Note that you can declare a custom style widget using the same inheritance mechanism of normal widgets, as long as they build to StyleBuilder. This is different from the extend/replace mechanism as it operates on the style type, not the instances.

Implementations

impl Style

pub fn widget_new() -> Style

Start building a new instance.

pub fn widget_type() -> WidgetType

Gets the widget type info.

impl Style

pub fn widget_build(&mut self) -> StyleBuilder

Build the style.

impl Style

pub fn replace(&self, replace: impl IntoValue<bool>)

c Fully replace the contextual style.

This is not enabled by default, if set to true the contextual style properties are removed.

Methods from Deref<Target = NonWidgetBase>

pub fn widget_builder(&mut self) -> &mut WidgetBuilder

Returns a mutable reference to the widget builder.

pub fn widget_when(&mut self) -> Option<&mut WhenInfo>

Returns a mutable reference to the when block if called inside a when block.

pub fn widget_take(&mut self) -> WidgetBuilder

Takes the widget builder, finishing the widget macro build.

After this call trying to set a property using self will panic, the returned builder can still be manipulated directly.

pub fn widget_build(&mut self) -> WidgetBuilder

Finishes the build.

This is the fallback build that simply returns the builder, inheritors should override this method.

pub fn widget_importance(&mut self) -> &mut Importance

Returns a mutable reference to the importance of the next property assigns, unsets or when blocks.

Note that during the widget_intrinsic call this is Importance::WIDGET and after it is Importance::INSTANCE.

pub fn start_when_block( &mut self, inputs: Box<[WhenInput]>, state: Box<dyn VarBoxed<bool>>, expr: &'static str, location: SourceLocation, )

Start building a when block, all properties set after this call are pushed in the when block.

pub fn end_when_block(&mut self)

End the current when block, all properties set after this call are pushed in the widget.

Trait Implementations

impl Deref for Style

type Target = NonWidgetBase

The resulting type after dereferencing.

fn deref(&self) -> &<Style as Deref>::Target

Dereferences the value.

impl DerefMut for Style

fn deref_mut(&mut self) -> &mut <Style as Deref>::Target

Mutably dereferences the value.