Struct Select 

pub struct Select {

    pub rect: Rect,
    pub label: String,
    pub placeholder: String,
    pub label_size: f32,
    pub label_color: ColorLinPremul,
    pub placeholder_color: ColorLinPremul,
    pub is_placeholder: bool,
    pub open: bool,
    pub focused: bool,
    pub options: Vec<String>,
    pub selected_index: Option<usize>,
    pub padding: [f32; 4],
    pub bg_color: ColorLinPremul,
    pub border_color: ColorLinPremul,
    pub border_width: f32,
    pub radius: f32,
    pub validation_error: Option<String>,
    pub focus_id: FocusId,
}

A dropdown select element with an options list.

Fields

rect: Rect

Bounding rect of the closed select field.

label: String

Currently displayed label text.

placeholder: String

Placeholder text shown when no option is selected.

label_size: f32

Label font size.

label_color: ColorLinPremul

Label text color.

placeholder_color: ColorLinPremul

Placeholder text color.

is_placeholder: bool

Whether the placeholder is currently shown.

open: bool

Whether the dropdown is open.

focused: bool

Whether this select is focused.

options: Vec<String>

List of option strings.

selected_index: Option<usize>

Index of the currently selected option.

padding: [f32; 4]

Padding values.

bg_color: ColorLinPremul

Background color.

border_color: ColorLinPremul

Border color.

border_width: f32

Border width.

radius: f32

Corner radius.

validation_error: Option<String>

Validation error message.

focus_id: FocusId

Focus identifier.

Implementations

impl Select

pub fn new(placeholder: impl Into<String>) -> Self

Create a select with sensible defaults.

pub fn toggle_open(&mut self)

Toggle the dropdown open/closed.

pub fn close(&mut self)

Close the dropdown.

pub fn get_overlay_bounds(&self) -> Option<Rect>

Get the overlay bounds (if open).

pub fn selected_option(&self) -> Option<&String>

Get the selected option text.

pub fn set_selected_index(&mut self, index: Option<usize>)

Set the selected index and update the label.

Trait Implementations

impl Clone for Select

fn clone(&self) -> Select

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Select

fn default() -> Self

Returns the “default value” for a type.

impl Element for Select

fn rect(&self) -> Rect

The bounding rectangle of this element in logical coordinates.

fn set_rect(&mut self, rect: Rect)

Update the bounding rectangle (typically called by the layout engine).

fn render(&self, canvas: &mut Canvas, z: i32)

Paint this element onto canvas at the given z-index.

fn focus_id(&self) -> Option<FocusId>

The focus identifier for this element, if it is focusable.

impl EventHandler for Select

fn handle_mouse_click(&mut self, event: &MouseClickEvent) -> EventResult

Handle a mouse click event. Returns Handled if the event was consumed.

fn handle_keyboard(&mut self, event: &KeyboardEvent) -> EventResult

Handle a keyboard event. Returns Handled if the event was consumed.

fn handle_mouse_move(&mut self, _event: &MouseMoveEvent) -> EventResult

Handle a mouse-move event.

fn handle_scroll(&mut self, _event: &ScrollEvent) -> EventResult

Handle a scroll event.

fn is_focused(&self) -> bool

Whether this element currently has focus.

fn set_focused(&mut self, focused: bool)

Set focus state for this element.

fn contains_point(&self, x: f32, y: f32) -> bool

Hit-test: does this element contain the given logical point?