Struct WidgetBuilder

pub struct WidgetBuilder {

    pub name: String,
    pub width: f32,
    pub height: f32,
    pub desired_position: Matrix<f32, Const<2>, Const<1>, ArrayStorage<f32, 2, 1>>,
    pub vertical_alignment: VerticalAlignment,
    pub horizontal_alignment: HorizontalAlignment,
    pub max_size: Option<Matrix<f32, Const<2>, Const<1>, ArrayStorage<f32, 2, 1>>>,
    pub min_size: Option<Matrix<f32, Const<2>, Const<1>, ArrayStorage<f32, 2, 1>>>,
    pub background: Option<StyledProperty<Brush>>,
    pub foreground: Option<StyledProperty<Brush>>,
    pub row: usize,
    pub column: usize,
    pub margin: Thickness,
    pub children: Vec<Handle<UiNode>>,
    pub is_hit_test_visible: bool,
    pub visibility: bool,
    pub z_index: usize,
    pub allow_drag: bool,
    pub allow_drop: bool,
    pub user_data: Option<Arc<Mutex<RawMutex, dyn Any + Send>>>,
    pub draw_on_top: bool,
    pub enabled: bool,
    pub cursor: Option<CursorIcon>,
    pub opacity: Option<f32>,
    pub tooltip: Option<RcUiNodeHandle>,
    pub tooltip_time: f32,
    pub context_menu: Option<RcUiNodeHandle>,
    pub preview_messages: bool,
    pub handle_os_events: bool,
    pub need_update: bool,
    pub layout_transform: Matrix<f32, Const<3>, Const<3>, ArrayStorage<f32, 3, 3>>,
    pub render_transform: Matrix<f32, Const<3>, Const<3>, ArrayStorage<f32, 3, 3>>,
    pub clip_to_bounds: bool,
    pub id: Uuid,
    pub tab_index: Option<usize>,
    pub tab_stop: bool,
    pub accepts_input: bool,
}

Widget builder creates Widget instances.

Fields

name: String

Name of the widget.

width: f32

Width of the widget.

height: f32

Height of the widget.

desired_position: Matrix<f32, Const<2>, Const<1>, ArrayStorage<f32, 2, 1>>

Desired position of the widget.

vertical_alignment: VerticalAlignment

Vertical alignment of the widget.

horizontal_alignment: HorizontalAlignment

Horizontal alignment of the widget.

max_size: Option<Matrix<f32, Const<2>, Const<1>, ArrayStorage<f32, 2, 1>>>

Max size of the widget.

min_size: Option<Matrix<f32, Const<2>, Const<1>, ArrayStorage<f32, 2, 1>>>

Min size of the widget.

background: Option<StyledProperty<Brush>>

Background brush of the widget.

foreground: Option<StyledProperty<Brush>>

Foreground brush of the widget.

row: usize

Row index of the widget.

column: usize

Column index of the widget.

margin: Thickness

Margin of the widget.

children: Vec<Handle<UiNode>>

Children handles of the widget.

is_hit_test_visible: bool

Whether the hit test is enabled or not.

visibility: bool

Whether the widget is visible or not.

z_index: usize

Z index of the widget.

allow_drag: bool

Whether the dragging of the widget is allowed or not.

allow_drop: bool

Whether the drop of the widget is allowed or not.

user_data: Option<Arc<Mutex<RawMutex, dyn Any + Send>>>

User-defined data.

draw_on_top: bool

Whether to draw the widget on top of any other or not.

enabled: bool

Whether the widget is enabled or not.

cursor: Option<CursorIcon>

Cursor of the widget.

opacity: Option<f32>

Opacity of the widget.

tooltip: Option<RcUiNodeHandle>

Tooltip of the widget.

tooltip_time: f32

Visibility interval (in seconds) of the tooltip of the widget.

context_menu: Option<RcUiNodeHandle>

Context menu of the widget.

preview_messages: bool

Whether the preview messages is enabled or not.

handle_os_events: bool

Whether the widget will handle OS events or not.

need_update: bool

Whether the widget will be updated or not.

layout_transform: Matrix<f32, Const<3>, Const<3>, ArrayStorage<f32, 3, 3>>

Layout transform of the widget.

render_transform: Matrix<f32, Const<3>, Const<3>, ArrayStorage<f32, 3, 3>>

Render transform of the widget.

clip_to_bounds: bool

Whether the widget bounds should be clipped by its parent or not.

id: Uuid

Unique id of the widget.

tab_index: Option<usize>

Defines the order in which this widget will get keyboard focus when Tab key is pressed. If set to None, Tab key won’t do anything on such widget. Default is None.

tab_stop: bool

A flag, that defines whether the Tab key navigation is enabled or disabled for this widget.

accepts_input: bool

A flag, that indicates that the widget accepts user input.

Implementations

impl WidgetBuilder

pub fn new() -> WidgetBuilder

Creates new widget builder with the default values.

pub fn with_preview_messages(self, state: bool) -> WidgetBuilder

Enables or disables message previewing of the widget. It basically defines whether the crate::Control::preview_message will be called or not.

pub fn with_handle_os_events(self, state: bool) -> WidgetBuilder

Enables or disables OS event handling of the widget. It basically defines whether the crate::Control::handle_os_event will be called or not.

pub fn with_need_update(self, state: bool) -> WidgetBuilder

Enables or disables updating of the widget. It basically defines whether the crate::Control::update will be called or not.

pub fn with_width(self, width: f32) -> WidgetBuilder

Sets the desired width of the widget.

pub fn with_height(self, height: f32) -> WidgetBuilder

Sets the desired height of the widget.

pub fn with_clip_to_bounds(self, clip_to_bounds: bool) -> WidgetBuilder

Enables or disables clipping of widget’s bound to its parent’s bounds.

pub fn with_enabled(self, enabled: bool) -> WidgetBuilder

Enables or disables the widget.

pub fn with_vertical_alignment(self, valign: VerticalAlignment) -> WidgetBuilder

Sets the desired vertical alignment of the widget.

pub fn with_horizontal_alignment( self, halign: HorizontalAlignment, ) -> WidgetBuilder

Sets the desired horizontal alignment of the widget.

pub fn with_max_size( self, max_size: Matrix<f32, Const<2>, Const<1>, ArrayStorage<f32, 2, 1>>, ) -> WidgetBuilder

Sets the max size of the widget.

pub fn with_min_size( self, min_size: Matrix<f32, Const<2>, Const<1>, ArrayStorage<f32, 2, 1>>, ) -> WidgetBuilder

Sets the min size of the widget.

pub fn with_background(self, brush: StyledProperty<Brush>) -> WidgetBuilder

Sets the desired background brush of the widget.

pub fn with_foreground(self, brush: StyledProperty<Brush>) -> WidgetBuilder

Sets the desired foreground brush of the widget.

pub fn on_row(self, row: usize) -> WidgetBuilder

Sets the desired row index of the widget.

pub fn on_column(self, column: usize) -> WidgetBuilder

Sets the desired column index of the widget.

pub fn with_margin(self, margin: Thickness) -> WidgetBuilder

Sets the desired margin of the widget.

pub fn with_uniform_margin(self, margin: f32) -> WidgetBuilder

Sets the desired, uniform margin of the widget.

pub fn with_desired_position( self, desired_position: Matrix<f32, Const<2>, Const<1>, ArrayStorage<f32, 2, 1>>, ) -> WidgetBuilder

Sets the desired position of the widget.

pub fn with_layout_transform( self, layout_transform: Matrix<f32, Const<3>, Const<3>, ArrayStorage<f32, 3, 3>>, ) -> WidgetBuilder

Sets the desired layout transform of the widget.

pub fn with_render_transform( self, render_transform: Matrix<f32, Const<3>, Const<3>, ArrayStorage<f32, 3, 3>>, ) -> WidgetBuilder

Sets the desired render transform of the widget.

pub fn with_z_index(self, z_index: usize) -> WidgetBuilder

Sets the desired Z index of the widget.

pub fn with_child(self, handle: Handle<UiNode>) -> WidgetBuilder

Adds a child handle to the widget. Handle::NONE values are ignored.

pub fn with_draw_on_top(self, draw_on_top: bool) -> WidgetBuilder

Enables or disables top-most widget drawing.

pub fn with_children<I>(self, children: I) -> WidgetBuilder

where I: IntoIterator<Item = Handle<UiNode>>,

Sets the desired set of children nodes.

pub fn with_name(self, name: &str) -> WidgetBuilder

Sets the desired widget name.

pub fn with_hit_test_visibility(self, state: bool) -> WidgetBuilder

Enables or disables hit test of the widget.

pub fn with_visibility(self, visibility: bool) -> WidgetBuilder

Sets the desired widget visibility.

pub fn with_allow_drop(self, allow_drop: bool) -> WidgetBuilder

Enables or disables an ability to drop other widgets on this widget.

pub fn with_allow_drag(self, allow_drag: bool) -> WidgetBuilder

Enables or disables dragging of the widget.

pub fn with_user_data( self, user_data: Arc<Mutex<RawMutex, dyn Any + Send>>, ) -> WidgetBuilder

Sets the desired widget user data.

pub fn with_cursor(self, cursor: Option<CursorIcon>) -> WidgetBuilder

Sets the desired widget cursor.

pub fn with_opacity(self, opacity: Option<f32>) -> WidgetBuilder

Sets the desired widget opacity.

pub fn with_id(self, id: Uuid) -> WidgetBuilder

Sets the desired widget id.

pub fn with_tooltip(self, tooltip: RcUiNodeHandle) -> WidgetBuilder

Sets the desired tooltip for the node.

Important

The widget will share the tooltip, which means that when widget will be deleted, the tooltip will be deleted only if there’s no one use the tooltip anymore.

pub fn with_opt_tooltip(self, tooltip: Option<RcUiNodeHandle>) -> WidgetBuilder

Sets the desired tooltip for the node.

Important

The widget will share the tooltip, which means that when widget will be deleted, the tooltip will be deleted only if there’s no one use the tooltip anymore.

pub fn with_tooltip_time(self, tooltip_time: f32) -> WidgetBuilder

Sets the desired tooltip time.

pub fn with_context_menu(self, context_menu: RcUiNodeHandle) -> WidgetBuilder

The context menu receives PopupMessages for being displayed, and so should support those.

pub fn with_tab_index(self, tab_index: Option<usize>) -> WidgetBuilder

Sets the desired tab index.

pub fn with_tab_stop(self, tab_stop: bool) -> WidgetBuilder

Sets a flag, that defines whether the Tab key navigation is enabled or disabled for this widget.

pub fn with_accepts_input(self, accepts_input: bool) -> WidgetBuilder

Sets a flag, that indicates that the widget accepts user input.

pub fn build(self, ctx: &BuildContext<'_>) -> Widget

Finishes building of the base widget.

Trait Implementations

impl Default for WidgetBuilder

fn default() -> WidgetBuilder

Returns the “default value” for a type.