AtlasSegmentedControl

A row of joined segments with one selected, for a choice between a few views or modes.

Since 1.4.0

A row of joined segments, one selected: a choice between a few views or modes ("List | Grid", "Day | Week | Month"). Segments are all the same width, the widest one's, and text that does not fit is elided. The accent highlight slides to the chosen segment (not under reduced motion). For many options or a form choice, use AtlasRadioButton.

AtlasSegmentedControl is a Qt Quick Controls Control; its inherited properties work as usual.

Example

AtlasSegmentedControl {
    model: [qsTr("List"), { text: qsTr("Grid"), symbol: Symbols.GridView }]
    currentIndex: app.viewMode
    onActivated: index => app.viewMode = index
    Accessible.name: qsTr("View mode")
}

Properties

Name	Type	Default	Description
`count`	`int` (read-only)	—	The number of segments.
`currentIndex`	`int`	`0`	The selected segment.
`model`	`var`	`[]`	A list of strings, or of objects `{ text, symbol, toolTip }`. `symbol` is a Symbols value. A segment with only a symbol takes its tooltip and accessible name from `toolTip`, else `text`.

Signals

Name	Description
`activated(int index)`	The user chose segment `index`. Not emitted when `currentIndex` changes from code.

Keyboard

The control is one Tab stop. Left and Right move the selection (mirrored in right-to-left layouts), and Home and End jump to the ends.

Accessibility

Screen readers get a tab list (Accessible.PageTabList) of page tabs, the selected one marked.

Note

Give the control an Accessible.name ("View mode") for the screen reader's tab list.