Struct WidgetBuilder 

pub struct WidgetBuilder {

    pub name: String,
    pub width: f32,
    pub height: f32,
    pub desired_position: Vector2<f32>,
    pub vertical_alignment: VerticalAlignment,
    pub horizontal_alignment: HorizontalAlignment,
    pub max_size: Option<Vector2<f32>>,
    pub min_size: Option<Vector2<f32>>,
    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<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: Matrix3<f32>,
    pub render_transform: Matrix3<f32>,
    pub clip_to_bounds: bool,
    pub id: Uuid,
    pub tab_index: Option<usize>,
    pub tab_stop: bool,
    pub accepts_input: bool,
    pub material: WidgetMaterial,
    pub style: StyleResource,
}

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: Vector2<f32>

Desired position of the widget.

vertical_alignment: VerticalAlignment

Vertical alignment of the widget.

horizontal_alignment: HorizontalAlignment

Horizontal alignment of the widget.

max_size: Option<Vector2<f32>>

Max size of the widget.

min_size: Option<Vector2<f32>>

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<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: Matrix3<f32>

Layout transform of the widget.

render_transform: Matrix3<f32>

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 the 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.

material: WidgetMaterial

A material that will be used for rendering.

style: StyleResource

Style of the widget.

Implementations

impl WidgetBuilder

pub fn new() -> Self

Creates new widget builder with the default values.

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

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) -> Self

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) -> Self

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) -> Self

Sets the desired width of the widget.

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

Sets the desired height of the widget.

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

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

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

Enables or disables the widget.

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

Sets the desired vertical alignment of the widget.

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

Sets the desired horizontal alignment of the widget.

pub fn with_max_size(self, max_size: Vector2<f32>) -> Self

Sets the max size of the widget.

pub fn with_min_size(self, min_size: Vector2<f32>) -> Self

Sets the min size of the widget.

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

Sets the desired background brush of the widget.

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

Sets the desired foreground brush of the widget.

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

Sets the desired row index of the widget.

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

Sets the desired column index of the widget.

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

Sets the desired margin of the widget.

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

Sets the desired, uniform margin of the widget.

pub fn with_desired_position(self, desired_position: Vector2<f32>) -> Self

Sets the desired position of the widget.

pub fn with_layout_transform(self, layout_transform: Matrix3<f32>) -> Self

Sets the desired layout transform of the widget.

pub fn with_render_transform(self, render_transform: Matrix3<f32>) -> Self

Sets the desired render transform of the widget.

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

Sets the desired Z index of the widget.

pub fn with_child(self, handle: Handle<impl ObjectOrVariant<UiNode>>) -> Self

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

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

Enables or disables top-most widget drawing.

pub fn with_children<I: IntoIterator<Item = Handle<UiNode>>>( self, children: I, ) -> Self

Sets the desired set of children nodes.

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

Sets the desired widget name.

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

Enables or disables hit test of the widget.

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

Sets the desired widget visibility.

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

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

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

Enables or disables dragging of the widget.

pub fn with_user_data_value_opt<T: Any + Send>( self, user_data: Option<T>, ) -> Self

Sets the desired widget user data.

pub fn with_user_data_value<T: Any + Send>(self, user_data: T) -> Self

Sets the desired widget user data.

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

Sets the desired widget user data.

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

Sets the desired widget cursor.

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

Sets the desired widget opacity.

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

Sets the desired widget id.

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

Sets the desired tooltip for the node.

Important

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

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

Sets the desired tooltip for the node.

Important

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

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

Sets the desired tooltip time.

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

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

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

Sets the desired tab index.

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

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) -> Self

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

pub fn with_material(self, material: WidgetMaterial) -> Self

Sets a material which will be used for rendering of this widget.

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

Finishes building of the base widget.

Trait Implementations

impl Default for WidgetBuilder

fn default() -> Self

Returns the “default value” for a type.