Struct SegmentedControl 

pub struct SegmentedControl<T: SelectionItem = SegmentOption> { /* private fields */ }

Segmented control widget for single-selection from horizontal options

Generic over T: SelectionItem. For simple string-based selections, use the default SegmentedControl<SegmentOption> via the options() builder.

Implementations

impl SegmentedControl<SegmentOption>

pub fn new(cx: &mut Context<'_, Self>) -> Self

Create a new segmented control for SegmentOption selections

Use options() to set the available options.

pub fn options(self, options: Vec<(&str, &str)>) -> Self

Set options from a slice of (value, label) tuples (builder pattern)

pub fn with_options(self, options: Vec<SegmentOption>) -> Self

Set options from SegmentOption structs (builder pattern)

pub fn with_selected_value(self, value: &str) -> Self

Set selected value by string (builder pattern)

For use with options() API. Matches by value field.

pub fn set_selected_value(&mut self, value: &str, cx: &mut Context<'_, Self>)

Set selected by string value programmatically

For use with options() API. Emits Change event if value changes.

pub fn selected_value(&self) -> &str

Get the selected value as a string

Convenience method for SegmentOption-based controls.

impl<T: SelectionItem> SegmentedControl<T>

pub fn new_with_items( items: Vec<T>, selected: T, cx: &mut Context<'_, Self>, ) -> Self

Create a new segmented control with items and initial selection

pub fn with_items(self, items: Vec<T>) -> Self

Set items (builder pattern)

pub fn with_selected(self, item: T) -> Self

Set selected item (builder pattern)

pub fn with_selected_index(self, index: usize) -> Self

Set selected by index (builder pattern)

pub fn theme(self, theme: Theme) -> Self

Set custom theme (builder pattern)

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

Set enabled state (builder pattern)

pub fn with_button_gap(self, gap: impl Into<Pixels>) -> Self

Set gap between segment buttons (builder pattern)

Default is 8px.

pub fn selected(&self) -> &T

Get the currently selected item

pub fn selected_index(&self) -> usize

Get the currently selected index

pub fn set_selected(&mut self, item: T, cx: &mut Context<'_, Self>)

Set selected item programmatically

Emits Change event if selection changes.

pub fn set_selected_index(&mut self, index: usize, cx: &mut Context<'_, Self>)

Set selected by index programmatically

Emits Change event if selection changes.

pub fn focus_handle(&self) -> &FocusHandle

Get the focus handle

pub fn is_enabled(&self) -> bool

Check if enabled

pub fn set_enabled(&mut self, enabled: bool, cx: &mut Context<'_, Self>)

Set enabled state programmatically

Trait Implementations

impl<T: SelectionItem> Focusable for SegmentedControl<T>

fn focus_handle(&self, _cx: &App) -> FocusHandle

Returns the focus handle associated with this view.

impl<T: SelectionItem> Render for SegmentedControl<T>

fn render( &mut self, window: &mut Window, cx: &mut Context<'_, Self>, ) -> impl IntoElement

Render this view into an element tree.

impl<T: SelectionItem> EventEmitter<SegmentedControlEvent<T>> for SegmentedControl<T>