Struct MacSegmentedControl 

pub struct MacSegmentedControl<'a> { /* private fields */ }

Authentic macOS segmented pill selector (NSSegmentedControl equivalent).

Supports CASpring sliding pill physics, per-segment widths, template-tinted vector icons, per-segment enablement, isHighlighted pressed feedback, Sonoma active-pill divider suppression, AccessKit (egui::Role::RadioGroup / egui::Role::Toolbar) semantics, stack-inline storage, and AppKit menu triggers (PressAndHold, PullDown, SecondaryClick, Keyboard).

Example

use egui_macview::{MacSegmentedControl, MacTheme};
let theme = MacTheme::default();
let mut selected = 1;
MacSegmentedControl::new(&["Day", "Week", "Month", "Year"], selected)
    .accessibility_label("Calendar Scale")
    .theme(&theme)
    .show(ui, |i| selected = i);

Implementations

impl<'a> MacSegmentedControl<'a>

pub const INLINE_SEGMENT_CAPACITY: usize = INLINE_CAP

Maximum number of segments stored inline on the stack (8) before spilling to heap storage.

pub fn new(options: &'a [&'a str], selected_idx: usize) -> Self

Creates a segmented control from borrowed text option labels and currently selected index.

pub fn with_custom_segments( segments: impl IntoIterator<Item = SegmentItem<'a>>, selected_idx: usize, ) -> Self

Creates a segmented control from any array or iterator of SegmentItem descriptors.

pub fn momentary(segments: impl IntoIterator<Item = SegmentItem<'a>>) -> Self

Creates a momentary segmented action strip (NSSegmentedSwitchTrackingMomentary) with no persistent active pill.

pub fn with_icons(symbols: &'a [MacSymbol], selected_idx: usize) -> Self

Creates a segmented control from a slice of MacSymbol icons.

pub const fn is_inline_allocated(&self) -> bool

Returns true when the segment descriptors reside inline on the stack without heap allocation.

pub fn id_salt(self, salt: impl Hash + Debug) -> Self

Explicitly binds an ID salt so spring physics and gesture state stay invariant across conditional peer layouts.

pub fn accessibility_label(self, label: impl Into<Cow<'a, str>>) -> Self

Sets the NSAccessibility / AccessKit group label announced by assistive technologies.

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

Enables or disables the entire segmented control.

pub const fn theme(self, theme: &'a MacTheme) -> Self

Injects an explicit MacTheme reference.

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

Overrides control height in points (defaults to size-tier segmented height token).

pub const fn control_size(self, size: MacControlSize) -> Self

Sets the AppKit control size (Regular 22pt, Small 18pt, or Mini 15pt).

pub const fn small_square(self) -> Self

Configures AppKit NSSegmentedStyleSmallSquare (2.0pt corner radius and full-height dividers).

pub const fn fixed_rect(self, rect: Rect) -> Self

Pins the segmented control to an exact NIB rectangle.

pub fn show_multi(self, ui: &mut Ui, active: &mut [bool]) -> Option<usize>

Renders a multi-select segmented strip (NSSegmentedSwitchTrackingSelectAny).

pub fn show(self, ui: &mut Ui, on_select: impl FnMut(usize)) -> Response

Renders the segmented control and invokes on_select when a primary selection occurs.

pub fn show_with_events( self, ui: &mut Ui, on_event: impl FnMut(SegmentEvent), ) -> Response

Renders the segmented control and dispatches SegmentEvent values for both selection and menu triggers.

pub fn show_momentary( self, ui: &mut Ui, on_action: impl FnMut(usize), ) -> Response

Renders a momentary segmented strip (NSSegmentedSwitchTrackingMomentary) and invokes on_action on click/activation.

pub fn show_momentary_with_events( self, ui: &mut Ui, on_event: impl FnMut(SegmentEvent), ) -> Response

Renders a momentary segmented strip (NSSegmentedSwitchTrackingMomentary) and dispatches both click and menu SegmentEvents.