Fluent-Qt

Navigation

SelectorBar

A row of selectable items for switching between views.

Example

SelectorBar: SelectorBar with hosted pages

Usage

SelectorBar with hosted pages

currentChanged swaps the external page; selectionChanged exposes the selected item's data payload.

#include <FluentQt/Navigation.h>
using namespace fluent::navigation;

auto* selector = new SelectorBar(this);
selector->addItem(SelectorBarItem("Inbox", Typography::Icons::Mail,
                                 true, true, "inbox"));
selector->addItem(SelectorBarItem("Calendar", Typography::Icons::Calendar,
                                 true, true, "calendar"));
selector->addItem(SelectorBarItem("Settings", Typography::Icons::Settings,
                                 true, true, "settings"));

auto* host = new StackContentHost(this);
for (int i = 0; i < selector->itemCount(); ++i)
    host->insertPage(i, createPage(selector->itemAt(i).text));

connect(selector, &SelectorBar::currentChanged,
        host, [host](int index) { host->setCurrentIndex(index, 0, true); });
connect(selector, &SelectorBar::selectionChanged,
        this, [](int, const SelectorBarItem& item) {
            const auto key = item.data.toString();
        });

fluent::navigation::SelectorBar

Inherits QWidget · FluentElement · QMLPlus

Horizontal selector bar for mutually exclusive navigation items.

Constructors

Properties

int itemCount

Number of items exposed by the navigation control.

Read itemCount()Notify itemCountChanged()
int selectedIndex

Currently selected item index.

Read selectedIndex()Write setSelectedIndex()Notify selectedIndexChanged()
OverflowBehavior overflowBehavior

How the control handles items that exceed available width.

Read overflowBehavior()Write setOverflowBehavior()Notify overflowBehaviorChanged()
Typography::FontRole itemFontRole

Typography role used by selector items.

Read itemFontRole()Write setItemFontRole()Notify itemFontRoleChanged()
QString iconFontFamily

Iconfont family used for glyph rendering.

Read iconFontFamily()Write setIconFontFamily()Notify iconFontFamilyChanged()
bool backgroundVisible

Whether the bar paints its layer background.

Read isBackgroundVisible()Write setBackgroundVisible()Notify backgroundVisibleChanged()

Methods

int itemCount() const

Number of items exposed by the navigation control.

int selectedIndex() const

Currently selected item index.

void setSelectedIndex(int index)

Currently selected item index.

OverflowBehavior overflowBehavior() const

How the control handles items that exceed available width.

void setOverflowBehavior(OverflowBehavior behavior)

How the control handles items that exceed available width.

Typography::FontRole itemFontRole() const

Typography role used by selector items.

void setItemFontRole(Typography::FontRole role)

Typography role used by selector items.

QString iconFontFamily() const

Iconfont family used for glyph rendering.

void setIconFontFamily(const QString& family)

Iconfont family used for glyph rendering.

bool isBackgroundVisible() const

Whether the bar paints its layer background.

void setBackgroundVisible(bool visible)

Whether the bar paints its layer background.

Signals

void itemCountChanged(int count)

Number of items exposed by the navigation control.

void itemInvoked(int index, const SelectorBarItem& item)

Emitted for every pointer, keyboard, or accessibility invocation, including the selected item.

void selectedIndexChanged(int index)

Currently selected item index.

void overflowBehaviorChanged(OverflowBehavior behavior)

How the control handles items that exceed available width.

void itemFontRoleChanged(Typography::FontRole role)

Typography role used by selector items.

void iconFontFamilyChanged(const QString& family)

Iconfont family used for glyph rendering.

void backgroundVisibleChanged(bool visible)

Whether the bar paints its layer background.

Enumerations

enum class OverflowBehavior

Presentation used when items exceed the available width.

  • ScrollButtons
  • MoreButton

Destructors

Subclass interfaces

Methods

Inherited from fluent::FluentElement

Methods

static void setTheme(Theme theme)

Updates the global theme and notifies active FluentElement instances.

static void setThemeDeferred(Theme theme)

Schedules a visible-first batched theme refresh without blocking the current interaction.

static Theme currentTheme()

Returns the currently active global theme.

static bool themeUsesDarkAppearance(Theme theme)

Returns whether a theme uses dark-backed chrome and material tokens.

static void refreshTheme()

Re-broadcasts the current theme to repaint after a design-token change.

static int themeGeneration()

Monotonic counter bumped on every theme change, for staleness checks.

Theme effectiveTheme() const

Resolves the theme used by this element, honoring an inherited QWidget override.

bool effectiveThemeUsesDarkAppearance() const

Returns whether this element's effective theme uses dark-backed chrome.

QJsonObject themeOverrides() const

Returns this element's authored overrides.

void clearThemeOverrides()

Restores all token fields to global theme defaults.

const Colors& themeColorsRef() const

Non-copying access to the active color set (for hot paint paths).

Material::AcrylicToken themeAcrylic() const

Material, elevation, and adaptive layout tokens.

QColor themeBackdrop(bool active) const

Window-chrome backdrop color for the given activation state.

virtual void onThemeUpdated()

Called after the global theme changes.

Enumerations

enum Theme

Global visual theme used when resolving design tokens.

  • Light = 0
  • Dark = 1
  • HighContrast = 2

Types and aliases

struct Colors

Design token snapshots returned to components.

Inherited from fluent::QMLPlus

Methods

AnchorLayout::Anchors* anchors()

Returns mutable anchors for the QWidget host.

void setState(const QString& name)

Applies a named state, or clears state when name is empty.

void addState(const QMLState& state)

Registers or replaces a named state definition.

void evaluateStates()

Reevaluates conditions; the first registered true condition wins.

QMLPlusRuntime* runtime()

Returns the lazy host-owned state observation object.

void setAnchors(const AnchorLayout::Anchors& anchors)

Replaces all host anchors and invalidates the parent layout.

void resetAnchors()

Clears all host anchors and invalidates the parent layout.

void addTransition(const StateTransition& transition)

Registers a state transition in precedence order.

void setBehavior(const char* propertyName, const PropertyAnimation& animation)

Sets the default animation for this host's managed property writes.

void clearBehavior(const char* propertyName)

Removes the default animation for future managed writes.

bool writeProperty(const char* propertyName, const QVariant& value)

Writes a host property through Behavior without removing its binding.

All inherited Qt members:QWidget

fluent::navigation::SelectorBarItem

Constructors

Fields