Basic input
CheckBox
Select or clear options. A mixed state shows that only some items are selected.
Example
Property preview could not load. Select Property preview to retry.






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);import fluentqt
from PySide6.QtCore import Qt
check_box = fluentqt.CheckBox("Accept terms")
status = fluentqt.Label("State: Unchecked")
check_box.stateChanged.connect(
lambda state: status.setText(
"State: Checked"
if Qt.CheckState(state) == Qt.CheckState.Checked
else "State: Unchecked"
)
)
disabled_off = fluentqt.CheckBox("Disabled off")
disabled_off.setEnabled(False)
disabled_on = fluentqt.CheckBox("Disabled on")
disabled_on.setChecked(True)
disabled_on.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");
});import fluentqt
from PySide6.QtCore import Qt
check_box = fluentqt.CheckBox("Enable selected items")
check_box.setTristate(True)
check_box.setCheckState(Qt.CheckState.PartiallyChecked)
status = fluentqt.Label("State: Mixed")
check_box.stateChanged.connect(
lambda state: status.setText(
"State: Checked"
if Qt.CheckState(state) == Qt.CheckState.Checked
else "State: Mixed"
if Qt.CheckState(state) == Qt.CheckState.PartiallyChecked
else "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);import fluentqt
from PySide6.QtCore import Qt
select_all = fluentqt.CheckBox("Select all")
select_all.setTristate(True)
mail = fluentqt.CheckBox("Mail")
calendar = fluentqt.CheckBox("Calendar")
people = fluentqt.CheckBox("People")
def update_select_all():
checked = sum(item.isChecked() for item in (mail, calendar, people))
state = (
Qt.CheckState.Unchecked if checked == 0
else Qt.CheckState.Checked if checked == 3
else Qt.CheckState.PartiallyChecked
)
select_all.setCheckState(state)
def apply_select_all():
checked = select_all.checkState() == Qt.CheckState.Checked
mail.setChecked(checked)
calendar.setChecked(checked)
people.setChecked(checked)
select_all.clicked.connect(apply_select_all)
mail.clicked.connect(update_select_all)
calendar.clicked.connect(update_select_all)
people.clicked.connect(update_select_all)API
DeclarationNo matching API members.
fluent::basicinput::CheckBox
Inherits QCheckBox · FluentElement · QMLPlus
Fluent check box with animated check and mixed states.
Constructors
Properties
qreal checkProgressNormalized check-state animation progress.
ReadcheckProgress()WritesetCheckProgress()int boxSizeCheckbox box size in pixels.
ReadboxSize()WritesetBoxSize()NotifyboxSizeChanged()int boxMarginLeading margin before the checkbox box.
ReadboxMargin()WritesetBoxMargin()NotifyboxMarginChanged()int textGapSpacing between control glyph and text content.
ReadtextGap()WritesetTextGap()NotifytextGapChanged()bool hoverBackgroundEnabledWhether hover paints a subtle row background.
ReadhoverBackgroundEnabled()WritesetHoverBackgroundEnabled()NotifyhoverBackgroundEnabledChanged()
Methods
qreal checkProgress() constNormalized check-state animation progress.
void setCheckProgress(qreal progress)Normalized check-state animation progress.
int boxSize() constCheckbox box size in pixels.
void setBoxSize(int size)Checkbox box size in pixels.
int boxMargin() constLeading margin before the checkbox box.
void setBoxMargin(int margin)Leading margin before the checkbox box.
int textGap() constSpacing between control glyph and text content.
void setTextGap(int gap)Spacing between control glyph and text content.
bool hoverBackgroundEnabled() constWhether hover paints a subtle row background.
void setHoverBackgroundEnabled(bool enabled)Whether hover paints a subtle row background.
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.
Protected members
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() constResolves the theme used by this element, honoring an inherited QWidget override.
bool effectiveThemeUsesDarkAppearance() constReturns whether this element's effective theme uses dark-backed chrome.
bool setThemeOverrides(const QJsonObject& overrides)Replaces this element's sparse color, radius, and font token overrides.
QJsonObject themeOverrides() constReturns this element's authored overrides.
void clearThemeOverrides()Restores all token fields to global theme defaults.
const Colors& themeColorsRef() constNon-copying access to the active color set for hot paint paths.
Material::AcrylicToken themeAcrylic() constMaterial, elevation, and adaptive layout tokens.
QColor themeBackdrop(bool active) constWindow-chrome backdrop color for the given activation state.
virtual void onThemeUpdated()Called after the global theme changes.
Enumerations
enum ThemeGlobal visual theme used when resolving design tokens.
Light = 0Dark = 1HighContrast = 2
Types and aliases
struct ColorsDesign 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 registered state by name, or restores the default state when @p name is empty. Unknown names are ignored, and existing bindings resume when leaving the state.
void addState(const QMLState& state)Registers or replaces a named state definition; replacing the active state applies it immediately.
void evaluateStates()Reevaluates state conditions in registration order and activates the first match, or the default state if none match. Also runs automatically when dependency properties notify; derived states using extend inherit ancestor changes unless cyclic or missing.
QMLPlusRuntime* runtime()Returns the lazily created state observer owned by this host.
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 bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)Binds @p sourceProp on @p source to @p targetProp on this QWidget host via PropertyBinder::bind().
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {})Installs a managed direct binding on this QWidget host.
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {})Installs an explicit-dependency C++ expression on this QWidget host.
void addTransition(const StateTransition& transition)Registers a state transition in precedence order.
void setBehavior(const char* propertyName, const PropertyAnimation& animation)Sets the default animation used when @p propertyName is written via writeProperty() or a binding. Explicit StateTransition rules take precedence; direct C++ setter calls are not animated.
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.
Qt base class docs: QCheckBox