状态与信息

InfoBadge 信息徽章

用数字、图标或圆点显示简短状态。

示例

用法

显示模式

默认根据内容决定样式：无内容显示圆点，有图标显示图标，有数值显示数字；也可以用 setDisplayMode() 指定。

#include <FluentQt/StatusInfo.h>
using namespace fluent::status_info;

auto* dotBadge = new InfoBadge(this);

auto* iconBadge = new InfoBadge(this);
iconBadge->setIconGlyph(Typography::Icons::Mail);

auto* valueBadge = new InfoBadge(this);
valueBadge->setValue(7);

auto* explicitDot = new InfoBadge(this);
explicitDot->setDisplayMode(InfoBadge::InfoBadgeDisplayMode::Dot);

import fluentqt

dot_badge = fluentqt.InfoBadge(row)
icon_badge = fluentqt.InfoBadge(row)
icon_badge.setIconGlyph(fluentqt.Typography.Icons.Mail)
value_badge = fluentqt.InfoBadge(row)
value_badge.setValue(7)
explicit_dot = fluentqt.InfoBadge(row)
explicit_dot.setDisplayMode(fluentqt.InfoBadge.InfoBadgeDisplayMode.Dot)

API

查看声明

`fluent::status_info::InfoBadge`

继承自 QWidget · FluentElement · QMLPlus

用于数值、图标、状态或提醒信号的紧凑 Fluent 徽标。

构造函数

explicit InfoBadge(QWidget* parent = nullptr)

属性

int value: 显示模式解析为 Value 时展示的数字徽标值。
读取 value()设置 setValue()通知 valueChanged()
QString iconGlyph: 显示模式解析为 Icon 时展示的图标字符。
读取 iconGlyph()设置 setIconGlyph()通知 iconGlyphChanged()
InfoBadgeDisplayMode displayMode: 用于选择提示点、图标、数值或自动徽标绘制的内容模式。
读取 displayMode()设置 setDisplayMode()通知 displayModeChanged()
InfoBadgeStatus status: 用于选择视觉表现的语义状态。
读取 status()设置 setStatus()通知 statusChanged()
qreal badgeOpacity: 应用到徽标视觉的不透明度。
读取 badgeOpacity()设置 setBadgeOpacity()通知 badgeOpacityChanged()
QColor customBackgroundColor: 徽标背景色自定义覆盖值。
读取 customBackgroundColor()设置 setCustomBackgroundColor()通知 customBackgroundColorChanged()
QColor customTextColor: 徽标文本颜色自定义覆盖值。
读取 customTextColor()设置 setCustomTextColor()通知 customTextColorChanged()
Typography::FontRole valueFontRole: 徽标数值文本使用的排版角色。
读取 valueFontRole()设置 setValueFontRole()通知 valueFontRoleChanged()
int beaconDiameter: 提示点样式徽标的直径。
读取 beaconDiameter()设置 setBeaconDiameter()通知 beaconDiameterChanged()
int badgeHeight: 胶囊样式徽标的高度。
读取 badgeHeight()设置 setBadgeHeight()通知 badgeHeightChanged()
int valueHorizontalPadding: 徽标数值文本的水平内边距。
读取 valueHorizontalPadding()设置 setValueHorizontalPadding()通知 valueHorizontalPaddingChanged()
int iconGlyphSize: 图标字符尺寸，单位为像素。
读取 iconGlyphSize()设置 setIconGlyphSize()通知 iconGlyphSizeChanged()
QString iconFontFamily: 图标字符绘制使用的 iconfont 字体族。
读取 iconFontFamily()设置 setIconFontFamily()通知 iconFontFamilyChanged()
int badgeBackgroundInset: 徽标背景绘制时应用的内缩量。
读取 badgeBackgroundInset()设置 setBadgeBackgroundInset()通知 badgeBackgroundInsetChanged()
QPoint contentOffset: 徽标内容绘制时应用的像素偏移。
读取 contentOffset()设置 setContentOffset()通知 contentOffsetChanged()

方法

int value() const: 显示模式解析为 Value 时展示的数字徽标值。
void setValue(int value): 显示模式解析为 Value 时展示的数字徽标值。
QString iconGlyph() const: 显示模式解析为 Icon 时展示的图标字符。
void setIconGlyph(const QString& glyph): 显示模式解析为 Icon 时展示的图标字符。
InfoBadgeDisplayMode displayMode() const: 用于选择提示点、图标、数值或自动徽标绘制的内容模式。
void setDisplayMode(InfoBadgeDisplayMode mode): 用于选择提示点、图标、数值或自动徽标绘制的内容模式。
InfoBadgeStatus status() const: 用于选择视觉表现的语义状态。
void setStatus(InfoBadgeStatus status): 用于选择视觉表现的语义状态。
qreal badgeOpacity() const: 应用到徽标视觉的不透明度。
void setBadgeOpacity(qreal opacity): 应用到徽标视觉的不透明度。
QColor customBackgroundColor() const: 徽标背景色自定义覆盖值。
void setCustomBackgroundColor(const QColor& color): 徽标背景色自定义覆盖值。
QColor customTextColor() const: 徽标文本颜色自定义覆盖值。
void setCustomTextColor(const QColor& color): 徽标文本颜色自定义覆盖值。
Typography::FontRole valueFontRole() const: 徽标数值文本使用的排版角色。
void setValueFontRole(Typography::FontRole role): 徽标数值文本使用的排版角色。
int beaconDiameter() const: 提示点样式徽标的直径。
void setBeaconDiameter(int diameter): 提示点样式徽标的直径。
int badgeHeight() const: 胶囊样式徽标的高度。
void setBadgeHeight(int height): 胶囊样式徽标的高度。
int valueHorizontalPadding() const: 徽标数值文本的水平内边距。
void setValueHorizontalPadding(int padding): 徽标数值文本的水平内边距。
int iconGlyphSize() const: 图标字符尺寸，单位为像素。
void setIconGlyphSize(int size): 图标字符尺寸，单位为像素。
QString iconFontFamily() const: 图标字符绘制使用的 iconfont 字体族。
void setIconFontFamily(const QString& family): 图标字符绘制使用的 iconfont 字体族。
int badgeBackgroundInset() const: 徽标背景绘制时应用的内缩量。
void setBadgeBackgroundInset(int inset): 徽标背景绘制时应用的内缩量。
QPoint contentOffset() const: 徽标内容绘制时应用的像素偏移。
void setContentOffset(const QPoint& offset): 徽标内容绘制时应用的像素偏移。
InfoBadgeDisplayMode effectiveDisplayMode() const
QSize effectiveBadgeSize() const
QColor effectiveBackgroundColor() const
QColor effectiveForegroundColor() const
QSize sizeHint() const override
QSize minimumSizeHint() const override
void onThemeUpdated() override

信号

void valueChanged(int value): 显示模式解析为 Value 时展示的数字徽标值。
void iconGlyphChanged(const QString& glyph): 显示模式解析为 Icon 时展示的图标字符。
void displayModeChanged(InfoBadgeDisplayMode mode): 用于选择提示点、图标、数值或自动徽标绘制的内容模式。
void statusChanged(InfoBadgeStatus status): 用于选择视觉表现的语义状态。
void badgeOpacityChanged(qreal opacity): 应用到徽标视觉的不透明度。
void customBackgroundColorChanged(const QColor& color): 徽标背景色自定义覆盖值。
void customTextColorChanged(const QColor& color): 徽标文本颜色自定义覆盖值。
void valueFontRoleChanged(Typography::FontRole role): 徽标数值文本使用的排版角色。
void beaconDiameterChanged(int diameter): 提示点样式徽标的直径。
void badgeHeightChanged(int height): 胶囊样式徽标的高度。
void valueHorizontalPaddingChanged(int padding): 徽标数值文本的水平内边距。
void iconGlyphSizeChanged(int size): 图标字符尺寸，单位为像素。
void iconFontFamilyChanged(const QString& family): 图标字符绘制使用的 iconfont 字体族。
void badgeBackgroundInsetChanged(int inset): 徽标背景绘制时应用的内缩量。
void contentOffsetChanged(const QPoint& offset): 徽标内容绘制时应用的像素偏移。

枚举

enum class InfoBadgeDisplayMode: Auto
Dot
Icon
Value
enum class InfoBadgeStatus: Informational
Attention
Caution
Success
Critical

子类扩展接口

方法

void paintEvent(QPaintEvent* event) override
void changeEvent(QEvent* event) override
void showEvent(QShowEvent* event) override
void hideEvent(QHideEvent* event) override

继承自 fluent::FluentElement

方法

static void setTheme(Theme theme): 更新全局主题，并通知所有活跃的 FluentElement 实例。
static void setThemeDeferred(Theme theme): 以可见元素优先的批次调度主题刷新，避免阻塞当前交互。
static Theme currentTheme(): 返回当前生效的全局主题。
static bool themeUsesDarkAppearance(Theme theme): 返回指定主题是否使用暗色底的 chrome 与材质 token。
static void refreshTheme(): 在设计 token 变化后重新广播当前主题以触发重绘。
static int themeGeneration(): 每次主题变化自增的单调计数器，用于过期判断。
Theme effectiveTheme() const: 解析此元素实际使用的主题，会优先读取 QWidget 父链上的局部主题覆盖。
bool effectiveThemeUsesDarkAppearance() const: 返回此元素的实际主题是否使用暗色底 chrome。
bool setThemeOverrides(const QJsonObject& overrides): 供组件侧访问的设计 token 接口。
QJsonObject themeOverrides() const: 返回当前元素的覆盖配置。
void clearThemeOverrides(): 恢复全部 token 跟随全局主题。
Colors themeColors() const
const Colors& themeColorsRef() const: 对当前色板的零拷贝访问（用于绘制热路径）。
FontStyle themeFont(Typography::FontRole role = Typography::FontRole::Body) const
Radius themeRadius() const
Spacing themeSpacing() const
Animation themeAnimation() const
Material::AcrylicToken themeAcrylic() const: 材质、阴影和自适应布局 token。
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: 给定激活状态下的窗口 chrome 背景色。
virtual void onThemeUpdated(): 全局主题变化后调用。

枚举

enum Theme: 解析设计 token 时使用的全局视觉主题。
Light = 0
Dark = 1
HighContrast = 2

类型与别名

struct Colors: 返回给组件使用的设计 token 快照。
struct FontStyle
struct Radius
struct Spacing
struct Animation

继承自 fluent::QMLPlus

方法

AnchorLayout::Anchors* anchors(): 返回 QWidget 宿主的可变锚点配置。
void setState(const QString& name): 应用具名 state；名称为空时恢复默认状态。
QString state() const
void addState(const QMLState& state): 注册或替换一个具名 state 定义。
void evaluateStates(): 重新计算条件；按注册顺序选择首个成立的条件。
QMLPlusRuntime* runtime(): 返回按需创建、由宿主持有的状态观察对象。
void setAnchors(const AnchorLayout::Anchors& anchors): 替换宿主的全部锚点，并使父布局失效。
void resetAnchors(): 清除宿主全部锚点，并使父布局失效。
void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay): 将 source 属性绑定到 QWidget 宿主上的 target 属性。
BindingHandle bindManaged(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction direction = PropertyBinder::OneWay, BindingOptions options = {}): 在当前 QWidget 宿主上安装可管理的直接绑定。
BindingHandle bindComputed(const char* targetProp, const QVector<BindingDependency>& dependencies, std::function<QVariant()> evaluate, BindingOptions options = {}): 在当前 QWidget 宿主上安装使用显式依赖的 C++ 表达式绑定。
void addTransition(const StateTransition& transition): 按优先顺序注册状态过渡。
void setBehavior(const char* propertyName, const PropertyAnimation& animation): 设置宿主受管理属性写入时使用的默认动画。
void clearBehavior(const char* propertyName): 移除后续受管理写入使用的默认动画。
bool writeProperty(const char* propertyName, const QVariant& value): 通过 Behavior 写入宿主属性，且不移除该属性的绑定。

Qt 基类完整成员：QWidget