SegmentedButton

SegmentedButton presents a fixed set of mutually exclusive choices.

Declare segments

SegmentedButton(
    {
        SegmentedButtonItem("Day"),
        SegmentedButtonItem(app::images::calendar, "Week"),
        SegmentedButtonItem::IconOnly(app::images::grid, "Month"),
    },
    period
).OnChanged([period](std::size_t index) {
  period = index;
})

Simple overloads accept an initializer list or vector of StringVariant labels. Rich overloads accept SegmentedButtonItem values with ImageResource, ImageAsset, or VectorAsset icons. IconOnly requires a semantic label even though that label is not drawn.

Control selection

The selected index is controlled. Passing State<std::size_t> reads its current value; the caller handles OnChanged and supplies the next value. The index must identify an item.

Theme and semantics

SegmentedButtonStyle owns fills, labels, borders, padding, icon geometry, minimum segment size, radius, and normal and selected indications. The component exposes a grouped selection model and selected item semantics.

API

• Constructors: label lists or std::vector<SegmentedButtonItem>, followed by an index or State<std::size_t>.
• Item factories: label, icon plus label, or SegmentedButtonItem::IconOnly.
• Event: .OnChanged(function) with the requested index.
• Theme style: SegmentedButtonStyle.

Use Tabs when selection changes visible page content and participates in tab semantics.