Fluent-Qt

Basic input

CheckBox

Select or clear options. A mixed state shows that only some items are selected.

Example

Real unchecked FluentQt checkbox labelled Accept terms

Usage

Respond to changes

Connect toggled or stateChanged to respond when the box is checked or cleared.

#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;

auto* checkBox = new CheckBox("Accept terms", this);
auto* status = new Label("State: Unchecked", this);
connect(checkBox, &CheckBox::stateChanged, status, [status](int state) {
    status->setText(state == Qt::Checked ? "State: Checked" : "State: Unchecked");
});

auto* disabledOff = new CheckBox("Disabled off", this);
disabledOff->setEnabled(false);
auto* disabledOn = new CheckBox("Disabled on", this);
disabledOn->setChecked(true);
disabledOn->setEnabled(false);

Mixed state

Call setTristate(true), then use Qt::PartiallyChecked when only some items are selected.

#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;

auto* checkBox = new CheckBox("Enable selected items", this);
checkBox->setTristate(true);
checkBox->setCheckState(Qt::PartiallyChecked);
auto* status = new Label("State: Mixed", this);
connect(checkBox, &CheckBox::stateChanged, status, [status](int state) {
    status->setText(state == Qt::Checked ? "State: Checked"
            : state == Qt::PartiallyChecked
            ? "State: Mixed"
            : "State: Unchecked");
});

Select all

The parent checkbox shows Checked, Unchecked, or PartiallyChecked to match its children.

#include <FluentQt/BasicInput.h>
using namespace fluent::basicinput;

auto* selectAll = new CheckBox("Select all", this);
selectAll->setTristate(true);
auto* mail = new CheckBox("Mail", this);
auto* calendar = new CheckBox("Calendar", this);
auto* people = new CheckBox("People", this);

auto updateSelectAll = [=]() {
    const int checked = int(mail->isChecked()) + int(calendar->isChecked()) + int(people->isChecked());
    selectAll->setCheckState(checked == 0 ? Qt::Unchecked : checked == 3 ? Qt::Checked : Qt::PartiallyChecked);
};
connect(selectAll, &CheckBox::clicked, this, [=]() {
    const bool checked = selectAll->checkState() == Qt::Checked;
    mail->setChecked(checked);
    calendar->setChecked(checked);
    people->setChecked(checked);
});
connect(mail, &CheckBox::clicked, this, updateSelectAll);
connect(calendar, &CheckBox::clicked, this, updateSelectAll);
connect(people, &CheckBox::clicked, this, updateSelectAll);

fluent::basicinput::CheckBox

Inherits QCheckBox · FluentElement · QMLPlus

Fluent checkbox with animated check-state painting.

Constructors

Properties

qreal checkProgress

Normalized check-state animation progress.

Read checkProgress()Write setCheckProgress()
int boxSize

Checkbox box size in pixels.

Read boxSize()Write setBoxSize()Notify boxSizeChanged()
int boxMargin

Leading margin before the checkbox box.

Read boxMargin()Write setBoxMargin()Notify boxMarginChanged()
int textGap

Spacing between control glyph and text content.

Read textGap()Write setTextGap()Notify textGapChanged()
bool hoverBackgroundEnabled

Whether hover paints a subtle row background.

Read hoverBackgroundEnabled()Write setHoverBackgroundEnabled()Notify hoverBackgroundEnabledChanged()

Methods

qreal checkProgress() const

Normalized check-state animation progress.

void setCheckProgress(qreal progress)

Normalized check-state animation progress.

int boxSize() const

Checkbox box size in pixels.

void setBoxSize(int size)

Checkbox box size in pixels.

int boxMargin() const

Leading margin before the checkbox box.

void setBoxMargin(int margin)

Leading margin before the checkbox box.

int textGap() const

Spacing between control glyph and text content.

void setTextGap(int gap)

Spacing between control glyph and text content.

bool hoverBackgroundEnabled() const

Whether hover paints a subtle row background.

void setHoverBackgroundEnabled(bool enabled)

Whether hover paints a subtle row background.

QSize sizeHint() const override

Size hints for the layout system.

Signals

void boxSizeChanged()

Checkbox box size in pixels.

void boxMarginChanged()

Leading margin before the checkbox box.

void textGapChanged()

Spacing between control glyph and text content.

void hoverBackgroundEnabledChanged()

Whether hover paints a subtle row background.

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:QCheckBox