Trait MakeWidget

pub trait MakeWidget: Sized {
    // Required method
    fn make_widget(self) -> WidgetInstance;

    // Provided methods
    fn into_window(self) -> Window { ... }
    fn build_standalone_window(self) -> StandaloneWindowBuilder { ... }
    fn build_recorder(self) -> VirtualRecorderBuilder<Rgb8> { ... }
    fn with_styles(self, styles: impl IntoValue<Styles>) -> Style
       where Self: Sized { ... }
    fn with<C: ComponentDefinition>(
        self,
        name: &C,
        component: impl IntoValue<C::ComponentType>,
    ) -> Style
       where Value<C::ComponentType>: IntoComponentValue { ... }
    fn with_local<C: ComponentDefinition>(
        self,
        name: &C,
        component: impl IntoValue<C::ComponentType>,
    ) -> Style
       where Value<C::ComponentType>: IntoComponentValue { ... }
    fn with_dynamic<C: ComponentDefinition>(
        self,
        name: &C,
        dynamic: impl IntoDynamicComponentValue,
    ) -> Style
       where C::ComponentType: IntoComponentValue { ... }
    fn with_local_dynamic<C: ComponentDefinition>(
        self,
        name: &C,
        dynamic: impl IntoDynamicComponentValue,
    ) -> Style
       where C::ComponentType: IntoComponentValue { ... }
    fn with_shortcut<F>(
        self,
        key: impl Into<ShortcutKey>,
        modifiers: ModifiersState,
        callback: F,
    ) -> Shortcuts
       where F: FnMut(KeyEvent) -> EventHandling + Send + 'static { ... }
    fn with_repeating_shortcut<F>(
        self,
        key: impl Into<ShortcutKey>,
        modifiers: ModifiersState,
        callback: F,
    ) -> Shortcuts
       where F: FnMut(KeyEvent) -> EventHandling + Send + 'static { ... }
    fn h1(self) -> Style { ... }
    fn h2(self) -> Style { ... }
    fn h3(self) -> Style { ... }
    fn h4(self) -> Style { ... }
    fn h5(self) -> Style { ... }
    fn h6(self) -> Style { ... }
    fn xxxx_large(self) -> Style { ... }
    fn xxx_large(self) -> Style { ... }
    fn xx_large(self) -> Style { ... }
    fn x_large(self) -> Style { ... }
    fn large(self) -> Style { ... }
    fn default_size(self) -> Style { ... }
    fn small(self) -> Style { ... }
    fn x_small(self) -> Style { ... }
    fn hint(self) -> Style { ... }
    fn with_hint(self, hint: impl MakeWidget) -> Stack { ... }
    fn with_next_focus(
        self,
        next_focus: impl IntoValue<Option<WidgetId>>,
    ) -> WidgetInstance { ... }
    fn with_enabled(self, enabled: impl IntoValue<bool>) -> WidgetInstance { ... }
    fn into_default(self) -> WidgetInstance { ... }
    fn into_escape(self) -> WidgetInstance { ... }
    fn and(self, other: impl MakeWidget) -> WidgetList { ... }
    fn chain<W: MakeWidget>(
        self,
        others: impl IntoIterator<Item = W>,
    ) -> WidgetList { ... }
    fn expand(self) -> Expand { ... }
    fn expand_weighted(self, weight: u8) -> Expand { ... }
    fn expand_horizontally(self) -> Expand { ... }
    fn expand_vertically(self) -> Expand { ... }
    fn size<T>(self, size: Size<T>) -> Resize
       where T: Into<DimensionRange> { ... }
    fn width(self, width: impl Into<DimensionRange>) -> Resize { ... }
    fn height(self, height: impl Into<DimensionRange>) -> Resize { ... }
    fn into_button(self) -> Button { ... }
    fn to_button(&self) -> Button
       where Self: Clone { ... }
    fn into_checkbox(self, value: impl IntoDynamic<CheckboxState>) -> Checkbox { ... }
    fn to_checkbox(&self, value: impl IntoDynamic<CheckboxState>) -> Checkbox
       where Self: Clone { ... }
    fn centered(self) -> Align { ... }
    fn align_left(self) -> Align { ... }
    fn align_right(self) -> Align { ... }
    fn align_top(self) -> Align { ... }
    fn align_bottom(self) -> Align { ... }
    fn fit_horizontally(self) -> Align { ... }
    fn fit_vertically(self) -> Align { ... }
    fn scroll(self) -> Scroll { ... }
    fn vertical_scroll(self) -> Scroll { ... }
    fn horizontal_scroll(self) -> Scroll { ... }
    fn into_ref(self) -> WidgetRef { ... }
    fn contain(self) -> Container { ... }
    fn contain_level(self, level: impl IntoValue<ContainerLevel>) -> Container { ... }
    fn background_color(self, color: impl IntoValue<Color>) -> Container { ... }
    fn pad(self) -> Container { ... }
    fn pad_by(self, padding: impl IntoValue<Edges<Dimension>>) -> Container { ... }
    fn themed(self, theme: impl IntoValue<ThemePair>) -> Themed { ... }
    fn localized_in(
        self,
        locale: impl IntoValue<LanguageIdentifier>,
    ) -> Localized { ... }
    fn themed_mode(self, mode: impl IntoValue<ThemeMode>) -> ThemedMode { ... }
    fn collapse_horizontally(
        self,
        collapse_when: impl IntoDynamic<bool>,
    ) -> Collapse { ... }
    fn collapse_vertically(
        self,
        collapse_when: impl IntoDynamic<bool>,
    ) -> Collapse { ... }
    fn disclose(self) -> Disclose { ... }
    fn validation(self, validation: impl IntoDynamic<Validation>) -> Validated { ... }
    fn tooltip(self, layer: &OverlayLayer, tip: impl MakeWidget) -> Tooltipped { ... }
}

A type that can create a WidgetInstance.

Required Methods

fn make_widget(self) -> WidgetInstance

Returns a new widget.

Provided Methods

fn into_window(self) -> Window

Returns a new window containing self as the root widget.

fn build_standalone_window(self) -> StandaloneWindowBuilder

Returns a builder for a standalone window.

A standalone window can be either a VirtualWindow or a CushyWindow.

fn build_recorder(self) -> VirtualRecorderBuilder<Rgb8>

Returns a builder for a VirtualRecorder

fn with_styles(self, styles: impl IntoValue<Styles>) -> Style

where Self: Sized,

Associates styles with this widget.

This is equivalent to Style::new(styles, self).

fn with<C: ComponentDefinition>( self, name: &C, component: impl IntoValue<C::ComponentType>, ) -> Style

where Value<C::ComponentType>: IntoComponentValue,

Associates a style component with self.

fn with_local<C: ComponentDefinition>( self, name: &C, component: impl IntoValue<C::ComponentType>, ) -> Style

where Value<C::ComponentType>: IntoComponentValue,

Associates a style component with self, ensuring that no child widgets inherit this component.

fn with_dynamic<C: ComponentDefinition>( self, name: &C, dynamic: impl IntoDynamicComponentValue, ) -> Style

where C::ComponentType: IntoComponentValue,

Associates a style component with self, resolving its value using dynamic at runtime.

fn with_local_dynamic<C: ComponentDefinition>( self, name: &C, dynamic: impl IntoDynamicComponentValue, ) -> Style

where C::ComponentType: IntoComponentValue,

Associates a style component with self, resolving its value using dynamic at runtime. This component will not be inherited to child widgets.

fn with_shortcut<F>( self, key: impl Into<ShortcutKey>, modifiers: ModifiersState, callback: F, ) -> Shortcuts

where F: FnMut(KeyEvent) -> EventHandling + Send + 'static,

Invokes callback when key is pressed while modifiers are pressed.

This shortcut will only be invoked if focus is within self or a child of self, or if the returned widget becomes the root widget of a window.

fn with_repeating_shortcut<F>( self, key: impl Into<ShortcutKey>, modifiers: ModifiersState, callback: F, ) -> Shortcuts

where F: FnMut(KeyEvent) -> EventHandling + Send + 'static,

Invokes callback when key is pressed while modifiers are pressed. If the shortcut is held, the callback will be invoked on repeat events.

This shortcut will only be invoked if focus is within self or a child of self, or if the returned widget becomes the root widget of a window.

fn h1(self) -> Style

Styles self with the largest of 6 heading styles.

fn h2(self) -> Style

Styles self with the second largest of 6 heading styles.

fn h3(self) -> Style

Styles self with the third largest of 6 heading styles.

fn h4(self) -> Style

Styles self with the third smallest of 6 heading styles.

fn h5(self) -> Style

Styles self with the second smallest of 6 heading styles.

fn h6(self) -> Style

Styles self with the smallest of 6 heading styles.

fn xxxx_large(self) -> Style

Styles self with the largest text size.

fn xxx_large(self) -> Style

Styles self with the second largest text size.

fn xx_large(self) -> Style

Styles self with the third largest text size.

fn x_large(self) -> Style

Styles self with the fourth largest text size.

fn large(self) -> Style

Styles self with the fifth largest text size.

fn default_size(self) -> Style

Styles self with the third smallest text size.

fn small(self) -> Style

Styles self with the second smallest text size.

fn x_small(self) -> Style

Styles self with the smallest text size.

fn hint(self) -> Style

Styles self as an informational hint message.

fn with_hint(self, hint: impl MakeWidget) -> Stack

Attaches hint as an informational hint message below self.

The spacing between self and hint is half of IntrinsicPadding.

fn with_next_focus( self, next_focus: impl IntoValue<Option<WidgetId>>, ) -> WidgetInstance

Sets the widget that should be focused next.

Cushy automatically determines reverse tab order by using this same relationship.

fn with_enabled(self, enabled: impl IntoValue<bool>) -> WidgetInstance

Sets this widget to be enabled/disabled based on enabled and returns self.

If this widget is disabled, all children widgets will also be disabled.

Panics

This function can only be called when one instance of the widget exists. If any clones exist, a panic will occur.

fn into_default(self) -> WidgetInstance

Sets this widget as a “default” widget.

Default widgets are automatically activated when the user signals they are ready for the default action to occur.

Example widgets this is used for are:

• Submit buttons on forms
• Ok buttons

fn into_escape(self) -> WidgetInstance

Sets this widget as an “escape” widget.

Escape widgets are automatically activated when the user signals they are ready to escape their current situation.

Example widgets this is used for are:

• Close buttons
• Cancel buttons

fn and(self, other: impl MakeWidget) -> WidgetList

Returns a collection of widgets using self and other.

fn chain<W: MakeWidget>(self, others: impl IntoIterator<Item = W>) -> WidgetList

Chains self and others into a WidgetList.

fn expand(self) -> Expand

Expands self to grow to fill its parent.

fn expand_weighted(self, weight: u8) -> Expand

Expands self to grow to fill its parent proportionally with other weighted siblings.

fn expand_horizontally(self) -> Expand

Expands self to grow to fill its parent horizontally.

fn expand_vertically(self) -> Expand

Expands self to grow to fill its parent vertically.

fn size<T>(self, size: Size<T>) -> Resize

where T: Into<DimensionRange>,

Resizes self to size.

fn width(self, width: impl Into<DimensionRange>) -> Resize

Resizes self to width.

width can be an any of:

• Dimension
• [Px]
• Lp
• A range of any fo the above.

fn height(self, height: impl Into<DimensionRange>) -> Resize

Resizes self to height.

height can be an any of:

• Dimension
• [Px]
• Lp
• A range of any fo the above.

fn into_button(self) -> Button

Returns this widget as the contents of a clickable button.

fn to_button(&self) -> Button

where Self: Clone,

Returns this widget as the contents of a clickable button.

fn into_checkbox(self, value: impl IntoDynamic<CheckboxState>) -> Checkbox

Returns this widget as the label of a Checkbox.

fn to_checkbox(&self, value: impl IntoDynamic<CheckboxState>) -> Checkbox

where Self: Clone,

Returns this widget as the label of a Checkbox.

fn centered(self) -> Align

Aligns self to the center vertically and horizontally.

fn align_left(self) -> Align

Aligns self to the left.

fn align_right(self) -> Align

Aligns self to the right.

fn align_top(self) -> Align

Aligns self to the top.

fn align_bottom(self) -> Align

Aligns self to the bottom.

fn fit_horizontally(self) -> Align

Fits self horizontally within its parent.

fn fit_vertically(self) -> Align

Fits self vertically within its parent.

fn scroll(self) -> Scroll

Allows scrolling self both vertically and horizontally.

fn vertical_scroll(self) -> Scroll

Allows scrolling self vertically.

fn horizontal_scroll(self) -> Scroll

Allows scrolling self horizontally.

fn into_ref(self) -> WidgetRef

Creates a WidgetRef for use as child widget.

fn contain(self) -> Container

Wraps self in a Container.

fn contain_level(self, level: impl IntoValue<ContainerLevel>) -> Container

Wraps self in a Container with the specified level.

fn background_color(self, color: impl IntoValue<Color>) -> Container

Returns a new widget that renders color behind self.

fn pad(self) -> Container

Wraps self with the default padding.

fn pad_by(self, padding: impl IntoValue<Edges<Dimension>>) -> Container

Wraps self with the specified padding.

fn themed(self, theme: impl IntoValue<ThemePair>) -> Themed

Applies theme to self and its children.

fn localized_in(self, locale: impl IntoValue<LanguageIdentifier>) -> Localized

Applies theme to self and its children.

fn themed_mode(self, mode: impl IntoValue<ThemeMode>) -> ThemedMode

Applies mode to self and its children.

fn collapse_horizontally( self, collapse_when: impl IntoDynamic<bool>, ) -> Collapse

Returns a widget that collapses self horizontally based on the dynamic boolean value.

This widget will be collapsed when the dynamic contains true, and revealed when the dynamic contains false.

fn collapse_vertically(self, collapse_when: impl IntoDynamic<bool>) -> Collapse

Returns a widget that collapses self vertically based on the dynamic boolean value.

This widget will be collapsed when the dynamic contains true, and revealed when the dynamic contains false.

fn disclose(self) -> Disclose

Returns a new widget that allows hiding and showing contents.

fn validation(self, validation: impl IntoDynamic<Validation>) -> Validated

Returns a widget that shows validation errors and/or hints.

fn tooltip(self, layer: &OverlayLayer, tip: impl MakeWidget) -> Tooltipped

Returns a widget that shows tip on layer when self is hovered.

Object Safety

This trait is not object safe.

Implementors

impl MakeWidget for WidgetInstance

impl<T> MakeWidget for T

where T: MakeWidgetWithTag,