Enum WidgetMessage 

pub enum WidgetMessage {
    MouseDown {
        pos: Vector2<f32>,
        button: MouseButton,
    },
    MouseUp {
        pos: Vector2<f32>,
        button: MouseButton,
    },
    MouseMove {
        pos: Vector2<f32>,
        state: MouseState,
    },
    MouseWheel {
        pos: Vector2<f32>,
        amount: f32,
    },
    MouseLeave,
    MouseEnter,
    Text(char),
    KeyDown(KeyCode),
    KeyUp(KeyCode),
    GotFocus,
    DragStarted(Handle<UiNode>),
    DragOver(Handle<UiNode>),
    Drop(Handle<UiNode>),
    LostFocus,
    TopMost,
    Unlink,
    Remove,
    LinkWith(Handle<UiNode>),
    LinkWithReverse(Handle<UiNode>),
    Background(Brush),
    Foreground(Brush),
    Name(String),
    Width(f32),
    Height(f32),
    VerticalAlignment(VerticalAlignment),
    HorizontalAlignment(HorizontalAlignment),
    MaxSize(Vector2<f32>),
    MinSize(Vector2<f32>),
    Row(usize),
    Column(usize),
    Margin(Thickness),
    HitTestVisibility(bool),
    Visibility(bool),
    ZIndex(usize),
    DesiredPosition(Vector2<f32>),
    Enabled(bool),
    Center,
    Cursor(Option<CursorIcon>),
    Opacity(Option<f32>),
}

A set of messages for any kind of widgets (including user controls). These messages provides basic communication elements of the UI library.

Variants

MouseDown

Initiated when user clicks on a widget’s geometry.

Direction: From UI.

Fields

pos: Vector2<f32>

Position of cursor.

button: MouseButton

A button that was pressed.

MouseUp

Initiated when user releases mouse button while cursor is over widget’s geometry.

Direction: From UI.

Fields

pos: Vector2<f32>

Position of cursor.

button: MouseButton

A button that was released.

MouseMove

Initiated when user moves cursor over widget’s geometry.

Direction: From/To UI.

Fields

pos: Vector2<f32>

New position of cursor in screen coordinates.

state: MouseState

State of mouse buttons.

MouseWheel

Initiated when user scrolls mouse wheel while cursor is over widget’s geometry.

Direction: From/To UI.

Fields

pos: Vector2<f32>

Position of cursor.

amount: f32

Amount of lines per mouse wheel turn.

MouseLeave

Initiated when cursor leaves geometry of a widget.

Direction: From UI.

MouseEnter

Initiated when cursor enters geometry of a widget.

Direction: From UI.

Text(char)

Initiated when widget is in focus and user types something on a keyboard.

Direction: From/To UI.

KeyDown(KeyCode)

Initiated when widget is in focus and user presses a button on a keyboard.

Direction: From UI.

KeyUp(KeyCode)

Initiated when widget is in focus and user releases a button on a keyboard.

Direction: From UI.

GotFocus

Initiated when widget received focus. In most cases focus is received by clicking on widget.

Direction: From UI.

DragStarted(Handle<UiNode>)

Initiated when dragging of a widget has started.

Direction: From UI.

DragOver(Handle<UiNode>)

Initiated when user drags a widget over some other widget.

Direction: From UI.

Drop(Handle<UiNode>)

Initiated when user drops a widget onto some other widget.

Direction: From UI.

LostFocus

Initiated when widget has lost its focus.

Direction: From UI.

TopMost

A request to make widget topmost. Widget can be made topmost only in the same hierarchy level only!

Direction: From/To UI.

Unlink

A request to detach widget from its current parent and attach to root canvas.

Direction: From/To UI.

Remove

A request to delete widget with all its children widgets. All handles to a node and its children will be invalid after processing such message!

Direction: From/To UI.

LinkWith(Handle<UiNode>)

A request to link initiator with specified widget.

Direction: From/To UI.

LinkWithReverse(Handle<UiNode>)

A request to link initiator with specified widget and put it in front of children list.

Direction: From/To UI.

Background(Brush)

A request to change background brush of a widget. Background brushes are used to fill volume of widgets.

Direction: From/To UI

Foreground(Brush)

A request to change foreground brush of a widget. Foreground brushes are used for text, borders and so on.

Direction: From/To UI

Name(String)

A request to change name of a widget. Name is given to widget mostly for debugging purposes.

Direction: From/To UI

Width(f32)

A request to set width of a widget. In most cases there is no need to explicitly set width of a widget, because rg3d-ui uses automatic layout engine which will correctly calculate desired width of a widget.

Direction: From/To UI

Height(f32)

A request to set height of a widget. In most cases there is no need to explicitly set height of a widget, because rg3d-ui uses automatic layout engine which will correctly calculate desired height of a widget.

Direction: From/To UI

VerticalAlignment(VerticalAlignment)

A request to set vertical alignment of a widget. Vertical alignment tells where to put widget in the parent widget’s bounds in vertical direction.

Direction: From/To UI

HorizontalAlignment(HorizontalAlignment)

A request to set horizontal alignment of a widget. Horizontal alignment tells where to put widget in the parent widget’s bounds in horizontal direction.

Direction: From/To UI

MaxSize(Vector2<f32>)

A request to set maximum size of widget. Maximum size restricts size of a widget during layout pass. For example you can set maximum size to a button which was placed into a grid’s cell, if maximum size wouldn’t be set, button would be stretched to fill entire cell.

Direction: From/To UI

MinSize(Vector2<f32>)

A request to set minimum size of widget. Minimum size restricts size of a widget during layout pass. For example you can set minimum size to a button which was placed into a grid’s cell, if minimum size wouldn’t be set, button would be compressed to fill entire cell.

Direction: From/To UI

Row(usize)

A request to set row number of a grid to which widget should belong to.

Direction: From/To UI

Notes

This is bad API and it should be changed in future. Grid should have explicit list of pairs (row, child) instead of this indirect attachment.

Column(usize)

A request to set column number of a grid to which widget should belong to.

Direction: From/To UI

Notes

This is bad API and it should be changed in future. Grid should have explicit list of pairs (column, child) instead of this indirect attachment.

Margin(Thickness)

A request to set new margin of widget. Margin could be used to add some free space around widget to make UI look less dense.

Direction: From/To UI

HitTestVisibility(bool)

A request to set new state hit test visibility. If set to false, widget will become “non-clickable”. It is useful for decorations which should be transparent for mouse events.

Direction: From/To UI

Visibility(bool)

A request to set new visibility of a widget. Widget can be either visible or not. Invisible widgets does not take space in layout pass and collapsed to a point.

Direction: From/To UI

ZIndex(usize)

A request to set new z index of a widget. Z index is used to change drawing order of widgets. Please note that it works only in same hierarchy level, which means that it is impossible to set z index to 9999 (or similar huge value) to force widget to be drawn on top of everything.

Direction: From/To UI

DesiredPosition(Vector2<f32>)

A request to set new desired position of a widget. It is called “desired” because layout system may ignore it and set some other position. Desired position works with a combination of a layout panel that supports direct coordinated (Canvas for example).

Direction: From/To UI

Enabled(bool)

A request to enable or disable widget. Disabled widget won’t receive mouse events and may look differently (it is defined by internal styling).

Direction: From/To UI

Center

A request to set desired position at center in local coordinates.

Direction: From/To UI

Cursor(Option<CursorIcon>)

A request to set new cursor icon for widget.

Direction: From/To UI

Opacity(Option<f32>)

A request to set new opacity for widget.

Direction: From/To UI

Implementations

impl WidgetMessage

pub fn remove( destination: Handle<UiNode>, direction: MessageDirection, ) -> UiMessage

pub fn unlink( destination: Handle<UiNode>, direction: MessageDirection, ) -> UiMessage

pub fn link( destination: Handle<UiNode>, direction: MessageDirection, value: Handle<UiNode>, ) -> UiMessage

pub fn link_reverse( destination: Handle<UiNode>, direction: MessageDirection, value: Handle<UiNode>, ) -> UiMessage

pub fn background( destination: Handle<UiNode>, direction: MessageDirection, value: Brush, ) -> UiMessage

pub fn foreground( destination: Handle<UiNode>, direction: MessageDirection, value: Brush, ) -> UiMessage

pub fn visibility( destination: Handle<UiNode>, direction: MessageDirection, value: bool, ) -> UiMessage

pub fn width( destination: Handle<UiNode>, direction: MessageDirection, value: f32, ) -> UiMessage

pub fn height( destination: Handle<UiNode>, direction: MessageDirection, value: f32, ) -> UiMessage

pub fn desired_position( destination: Handle<UiNode>, direction: MessageDirection, value: Vector2<f32>, ) -> UiMessage

pub fn center( destination: Handle<UiNode>, direction: MessageDirection, ) -> UiMessage

pub fn topmost( destination: Handle<UiNode>, direction: MessageDirection, ) -> UiMessage

pub fn enabled( destination: Handle<UiNode>, direction: MessageDirection, value: bool, ) -> UiMessage

pub fn name( destination: Handle<UiNode>, direction: MessageDirection, value: String, ) -> UiMessage

pub fn row( destination: Handle<UiNode>, direction: MessageDirection, value: usize, ) -> UiMessage

pub fn column( destination: Handle<UiNode>, direction: MessageDirection, value: usize, ) -> UiMessage

pub fn cursor( destination: Handle<UiNode>, direction: MessageDirection, value: Option<CursorIcon>, ) -> UiMessage

pub fn z_index( destination: Handle<UiNode>, direction: MessageDirection, value: usize, ) -> UiMessage

pub fn hit_test_visibility( destination: Handle<UiNode>, direction: MessageDirection, value: bool, ) -> UiMessage

pub fn margin( destination: Handle<UiNode>, direction: MessageDirection, value: Thickness, ) -> UiMessage

pub fn min_size( destination: Handle<UiNode>, direction: MessageDirection, value: Vector2<f32>, ) -> UiMessage

pub fn max_size( destination: Handle<UiNode>, direction: MessageDirection, value: Vector2<f32>, ) -> UiMessage

pub fn horizontal_alignment( destination: Handle<UiNode>, direction: MessageDirection, value: HorizontalAlignment, ) -> UiMessage

pub fn vertical_alignment( destination: Handle<UiNode>, direction: MessageDirection, value: VerticalAlignment, ) -> UiMessage

pub fn opacity( destination: Handle<UiNode>, direction: MessageDirection, value: Option<f32>, ) -> UiMessage

pub fn got_focus( destination: Handle<UiNode>, direction: MessageDirection, ) -> UiMessage

pub fn lost_focus( destination: Handle<UiNode>, direction: MessageDirection, ) -> UiMessage

pub fn mouse_down( destination: Handle<UiNode>, direction: MessageDirection, pos: Vector2<f32>, button: MouseButton, ) -> UiMessage

pub fn mouse_up( destination: Handle<UiNode>, direction: MessageDirection, pos: Vector2<f32>, button: MouseButton, ) -> UiMessage

pub fn mouse_move( destination: Handle<UiNode>, direction: MessageDirection, pos: Vector2<f32>, state: MouseState, ) -> UiMessage

pub fn mouse_wheel( destination: Handle<UiNode>, direction: MessageDirection, pos: Vector2<f32>, amount: f32, ) -> UiMessage

pub fn mouse_leave( destination: Handle<UiNode>, direction: MessageDirection, ) -> UiMessage

pub fn mouse_enter( destination: Handle<UiNode>, direction: MessageDirection, ) -> UiMessage

pub fn text( destination: Handle<UiNode>, direction: MessageDirection, value: char, ) -> UiMessage

pub fn key_down( destination: Handle<UiNode>, direction: MessageDirection, value: KeyCode, ) -> UiMessage

pub fn key_up( destination: Handle<UiNode>, direction: MessageDirection, value: KeyCode, ) -> UiMessage

pub fn drag_started( destination: Handle<UiNode>, direction: MessageDirection, value: Handle<UiNode>, ) -> UiMessage

pub fn drag_over( destination: Handle<UiNode>, direction: MessageDirection, value: Handle<UiNode>, ) -> UiMessage

pub fn drop( destination: Handle<UiNode>, direction: MessageDirection, value: Handle<UiNode>, ) -> UiMessage

Trait Implementations

impl Clone for WidgetMessage

fn clone(&self) -> WidgetMessage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for WidgetMessage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for WidgetMessage

fn eq(&self, other: &WidgetMessage) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for WidgetMessage