Basic input

RadioButton

Lets people select one option from a mutually exclusive group.

Example

Usage

RadioButton group

Sibling radio buttons are mutually exclusive and update the selected option.

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

#include <FluentQt/TextFields.h>

auto* low = new RadioButton("Low", this);
auto* medium = new RadioButton("Medium", this);
auto* high = new RadioButton("High", this);
medium->setChecked(true);
auto* status = new fluent::textfields::Label("Selected: Medium", this);
status->setFluentTypography(Typography::FontRole::Body);
status->setTextColorRole(fluent::textfields::Label::TextColorRole::Primary);
status->setMinimumWidth(status->sizeHint().width());
for (auto* radio : {low, medium, high}) {
    connect(radio, &RadioButton::toggled, status, [radio, status](bool checked) {
        if (checked)
            status->setText(QString("Selected: %1").arg(radio->text()));
    });
}

import fluentqt

status = fluentqt.Label('Selected: Medium')
status.setFluentTypography(fluentqt.FontRole.Body)
status.setTextColorRole(fluentqt.Label.TextColorRole.Primary)
status.setMinimumWidth(status.sizeHint().width())
low = fluentqt.RadioButton('Low')
medium = fluentqt.RadioButton('Medium')
high = fluentqt.RadioButton('High')
medium.setChecked(True)
for radio in (low, medium, high):
    radio.toggled.connect(
        lambda checked, value=radio: status.setText(
        f"Selected: {value.text()}"
        ) if checked else None
    )

API

Declaration

`fluent::basicinput::RadioButton`

Inherits QRadioButton · FluentElement · QMLPlus

Fluent radio button with animated selection feedback.

Constructors

explicit RadioButton(const QString& text = "", QWidget* parent = nullptr)
explicit RadioButton(QWidget* parent = nullptr)

Properties

qreal checkProgress: Normalized check-state animation progress.
Read checkProgress()Write setCheckProgress()
qreal dotScale: Animated scale of the selected radio dot.
Read dotScale()Write setDotScale()
int circleSize: Outer radio circle diameter in pixels.
Read circleSize()Write setCircleSize()Notify circleSizeChanged()
int textGap: Spacing between control glyph and text content.
Read textGap()Write setTextGap()Notify textGapChanged()
QFont textFont: Font used for radio button text.
Read textFont()Write setTextFont()Notify textFontChanged()

Methods

void onThemeUpdated() override
qreal checkProgress() const: Normalized check-state animation progress.
void setCheckProgress(qreal progress): Normalized check-state animation progress.
qreal dotScale() const: Animated scale of the selected radio dot.
void setDotScale(qreal scale): Animated scale of the selected radio dot.
int circleSize() const: Outer radio circle diameter in pixels.
void setCircleSize(int size): Outer radio circle diameter in pixels.
int textGap() const: Spacing between control glyph and text content.
void setTextGap(int gap): Spacing between control glyph and text content.
QFont textFont() const: Font used for radio button text.
void setTextFont(const QFont& font): Font used for radio button text.
QSize sizeHint() const override
QSize minimumSizeHint() const override

Signals

void circleSizeChanged(): Outer radio circle diameter in pixels.
void textGapChanged(): Spacing between control glyph and text content.
void textFontChanged(): Font used for radio button text.

Subclass interfaces

Methods

void paintEvent(QPaintEvent* event) override
void nextCheckState() override
void enterEvent(FluentEnterEvent* event) override
void leaveEvent(QEvent* event) override
void focusInEvent(QFocusEvent* event) override
void focusOutEvent(QFocusEvent* event) override
void keyPressEvent(QKeyEvent* event) override
void mousePressEvent(QMouseEvent* event) override

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.
bool setThemeOverrides(const QJsonObject& overrides): Component-facing token accessors.
QJsonObject themeOverrides() const: Returns this element's authored overrides.
void clearThemeOverrides(): Restores all token fields to global theme defaults.
Colors themeColors() const
const Colors& themeColorsRef() const: Non-copying access to the active color set (for hot paint paths).
FontStyle themeFont(Typography::FontRole role = Typography::FontRole::Body) const
Radius themeRadius() const
Spacing themeSpacing() const
Animation themeAnimation() const
Material::AcrylicToken themeAcrylic() const: Material, elevation, and adaptive layout tokens.
Material::MicaToken themeMica() const
Material::SmokeToken themeSmoke() const
Elevation::ShadowParams themeShadow(Elevation::Level level) const
int themeBreakpoint(Breakpoints::Breakpoint breakpoint = Breakpoints::Breakpoint::Medium) const
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.
struct FontStyle
struct Radius
struct Spacing
struct Animation

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.
QString state() const
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 bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay): Binds a source property to a property on the QWidget host.
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 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：QRadioButton