基础输入

DropDownButton 下拉按钮

点击后展开一组相关命令。

示例

用法

展开菜单

把命令加入 FluentMenu，再用 setMenu() 交给按钮。按钮本身不执行操作。

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

auto* button = new DropDownButton("Options", this);
auto* menu = new FluentMenu("Options", button);
menu->addAction("Edit profile");
menu->addAction("Account settings");
menu->addAction("Sign out");
button->setMenu(menu);

import fluentqt

button = fluentqt.DropDownButton('Options')
button.setMinimumWidth(140)
menu = fluentqt.FluentMenu('Options', button)
menu.addAction('Edit profile')
menu.addAction('Account settings')
menu.addAction('Sign out')
button.setMenu(menu)

API

查看声明

`fluent::basicinput::DropDownButton`

继承自 Button

用于打开下拉菜单或浮层的 Fluent 按钮。

构造函数

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

属性

QMenu* menu: 按钮打开的调用方所有菜单。
读取 menu()设置 setMenu()通知 menuChanged()
bool isOpen: 弹层、抽屉或通知表面是否处于打开状态。
读取 isOpen()设置 setIsOpen()通知 openChanged()
QString chevronGlyph: 下拉箭头使用的 iconfont 字符。
读取 chevronGlyph()设置 setChevronGlyph()通知 chevronChanged()
QString iconFontFamily: 图标字符绘制使用的 iconfont 字体族。
读取 iconFontFamily()设置 setIconFontFamily()通知 chevronChanged()
int chevronSize: 下拉箭头图标像素尺寸。
读取 chevronSize()设置 setChevronSize()通知 chevronChanged()
QPoint chevronOffset: 下拉箭头绘制时应用的像素偏移。
读取 chevronOffset()设置 setChevronOffset()通知 chevronChanged()
qreal pressProgress: 自绘表面使用的按压动画进度。
读取 pressProgress()设置 setPressProgress()

方法

void setMenu(QMenu* menu): 按钮打开的调用方所有菜单。
QMenu* menu() const: 按钮打开的调用方所有菜单。
bool isOpen() const: 弹层、抽屉或通知表面是否处于打开状态。
void setOpen(bool open)
void setIsOpen(bool open): 弹层、抽屉或通知表面是否处于打开状态。
QString chevronGlyph() const: 下拉箭头使用的 iconfont 字符。
void setChevronGlyph(const QString& glyph): 下拉箭头使用的 iconfont 字符。
QString iconFontFamily() const: 图标字符绘制使用的 iconfont 字体族。
void setIconFontFamily(const QString& family): 图标字符绘制使用的 iconfont 字体族。
int chevronSize() const: 下拉箭头图标像素尺寸。
void setChevronSize(int size): 下拉箭头图标像素尺寸。
QPoint chevronOffset() const: 下拉箭头绘制时应用的像素偏移。
void setChevronOffset(const QPoint& offset): 下拉箭头绘制时应用的像素偏移。
qreal pressProgress() const: 自绘表面使用的按压动画进度。
void setPressProgress(qreal value): 自绘表面使用的按压动画进度。
QSize sizeHint() const override
QSize minimumSizeHint() const override

信号

void menuChanged(): 按钮打开的调用方所有菜单。
void openChanged(): 弹层、抽屉或通知表面是否处于打开状态。
void chevronChanged(): 下拉箭头使用的 iconfont 字符。

析构函数

~DropDownButton() override

子类扩展接口

方法

void paintEvent(QPaintEvent* event) override
void mousePressEvent(QMouseEvent* event) override
void keyPressEvent(QKeyEvent* event) override
QRectF contentPaintRect(const QRectF& surfaceRect) const override

继承自 fluent::basicinput::Button

属性

ButtonStyle fluentStyle: 按钮视觉风格：Standard(标准)、Accent(强调色)、Subtle(透明)。
读取 fluentStyle()设置 setFluentStyle()通知 fluentStyleChanged()
ButtonSize fluentSize: 按钮密度 token，仅控制高度与内边距；字体由 fontRole 或 setFont() 管理。
读取 fluentSize()设置 setFluentSize()通知 fluentSizeChanged()
Typography::FontRole fontRole: 按钮跟随主题字体时使用的 Fluent 排版角色。
读取 fontRole()设置 setFontRole()通知 fontRoleChanged()
TextColorRole textColorRole: 非填充、未选中按钮的语义前景色；填充和禁用状态仍使用对应对比色。
读取 textColorRole()设置 setTextColorRole()通知 textColorRoleChanged()
ButtonLayout fluentLayout: 文本与图标的内容排列方式。
读取 fluentLayout()设置 setFluentLayout()通知 fluentLayoutChanged()
bool focusVisual: 控制是否绘制焦点视觉框。
读取 hasFocusVisual()设置 setFocusVisual()通知 focusVisualChanged()
InteractionState interactionState: 强制交互状态，主要用于引导、演示或 VisualCheck。
读取 interactionState()设置 setInteractionState()通知 interactionStateChanged()
bool criticalOnHover: Hover/Pressed 状态使用 Critical 语义色，适合关闭、删除等危险操作。
读取 criticalOnHover()设置 setCriticalOnHover()通知 criticalOnHoverChanged()
QMargins cornerRadii: 四角圆角；left/top/right/bottom 分别对应左上、右上、右下、左下。
读取 cornerRadii()设置 setCornerRadii()重置 resetCornerRadii()通知 cornerRadiiChanged()
QPoint iconOffset: iconfont 绘制偏移量，正值表示向右/向下移动，用于精细视觉对齐。
读取 iconOffset()设置 setIconOffset()
qreal iconRotation: 应用于自绘图标的顺时针旋转角度（度）。
读取 iconRotation()设置 setIconRotation()
qreal iconScale: 作用于自绘 iconfont 字形的等比缩放（1.0 为不缩放），用于实现 WinUI 风格的按下反馈（短暂缩小），且不改变几何布局。
读取 iconScale()设置 setIconScale()
qreal contentOpacity: 作用于整个按钮表面的画笔级不透明度（1.0 为完全不透明）。轻量淡入淡出，避免 QGraphicsOpacityEffect 的离屏合成。
读取 contentOpacity()设置 setContentOpacity()

方法

ButtonStyle fluentStyle() const: Fluent 属性访问接口。
void setFluentStyle(ButtonStyle style): 按钮视觉风格：Standard(标准)、Accent(强调色)、Subtle(透明)。
ButtonSize fluentSize() const: 按钮密度 token，仅控制高度与内边距；字体由 fontRole 或 setFont() 管理。
void setFluentSize(ButtonSize size): 按钮密度 token，仅控制高度与内边距；字体由 fontRole 或 setFont() 管理。
Typography::FontRole fontRole() const: 按钮跟随主题字体时使用的 Fluent 排版角色。
void setFontRole(Typography::FontRole role): 按钮跟随主题字体时使用的 Fluent 排版角色。
TextColorRole textColorRole() const: 非填充、未选中按钮的语义前景色；填充和禁用状态仍使用对应对比色。
void setTextColorRole(TextColorRole role): 非填充、未选中按钮的语义前景色；填充和禁用状态仍使用对应对比色。
void setFont(const QFont& font): 设置显式字体；后续主题刷新不会覆盖该字体。
ButtonLayout fluentLayout() const: 文本与图标的内容排列方式。
void setFluentLayout(ButtonLayout layout): 文本与图标的内容排列方式。
bool hasFocusVisual() const: 控制是否绘制焦点视觉框。
void setFocusVisual(bool focus): 控制是否绘制焦点视觉框。
InteractionState interactionState() const: 强制交互状态，主要用于引导、演示或 VisualCheck。
void setInteractionState(InteractionState state): 强制交互状态，主要用于引导、演示或 VisualCheck。
bool criticalOnHover() const: Hover/Pressed 状态使用 Critical 语义色，适合关闭、删除等危险操作。
void setCriticalOnHover(bool enabled): Hover/Pressed 状态使用 Critical 语义色，适合关闭、删除等危险操作。
QMargins cornerRadii() const: 四角圆角；left/top/right/bottom 分别对应左上、右上、右下、左下。
void setCornerRadii(const QMargins& radii): 四角圆角；left/top/right/bottom 分别对应左上、右上、右下、左下。
void resetCornerRadii(): 四角圆角；left/top/right/bottom 分别对应左上、右上、右下、左下。
QPoint iconOffset() const: iconfont 绘制偏移量，正值表示向右/向下移动，用于精细视觉对齐。
void setIconOffset(const QPoint& offset): iconfont 绘制偏移量，正值表示向右/向下移动，用于精细视觉对齐。
qreal iconRotation() const: 应用于自绘图标的顺时针旋转角度（度）。
void setIconRotation(qreal rotation): 应用于自绘图标的顺时针旋转角度（度）。
qreal iconScale() const: 作用于自绘 iconfont 字形的等比缩放（1.0 为不缩放），用于实现 WinUI 风格的按下反馈（短暂缩小），且不改变几何布局。
void setIconScale(qreal scale): 作用于自绘 iconfont 字形的等比缩放（1.0 为不缩放），用于实现 WinUI 风格的按下反馈（短暂缩小），且不改变几何布局。
qreal contentOpacity() const: 作用于整个按钮表面的画笔级不透明度（1.0 为完全不透明）。轻量淡入淡出，避免 QGraphicsOpacityEffect 的离屏合成。
void setContentOpacity(qreal opacity): 作用于整个按钮表面的画笔级不透明度（1.0 为完全不透明）。轻量淡入淡出，避免 QGraphicsOpacityEffect 的离屏合成。
void onThemeUpdated() override
QSize sizeHint() const override: 尺寸提示会综合 Fluent 内边距、文本和 iconfont 内容。
QSize minimumSizeHint() const override
void setIconGlyph(const QString& glyph, int pixelSize = Typography::IconSize::Standard, const QString& family = Typography::FontFamily::FluentIcons): 设置在 paintEvent() 中直接绘制的 iconfont 图标字符。
void setIconGlyph(QChar glyph, int pixelSize = Typography::IconSize::Standard, const QString& family = Typography::FontFamily::FluentIcons)

信号

void fluentStyleChanged(): 按钮视觉风格：Standard(标准)、Accent(强调色)、Subtle(透明)。
void fluentSizeChanged(): 按钮密度 token，仅控制高度与内边距；字体由 fontRole 或 setFont() 管理。
void fontRoleChanged(): 按钮跟随主题字体时使用的 Fluent 排版角色。
void textColorRoleChanged(): 非填充、未选中按钮的语义前景色；填充和禁用状态仍使用对应对比色。
void fluentLayoutChanged(): 文本与图标的内容排列方式。
void focusVisualChanged(): 控制是否绘制焦点视觉框。
void interactionStateChanged(): 强制交互状态，主要用于引导、演示或 VisualCheck。
void criticalOnHoverChanged(): Hover/Pressed 状态使用 Critical 语义色，适合关闭、删除等危险操作。
void cornerRadiiChanged(): 四角圆角；left/top/right/bottom 分别对应左上、右上、右下、左下。

枚举

enum ButtonStyle: 根据 Fluent 设计 token 解析的按钮视觉风格。
Standard
Accent
Subtle
enum ButtonSize: 控制内边距和推荐高度的按钮密度预设。
Small
StandardSize
Large
enum ButtonLayout: 文本与图标的组合模式。
TextOnly
IconBefore
IconOnly
IconAfter
enum class TextColorRole: 文字与图标的语义强调层级。
Primary
Secondary
Accent
enum InteractionState: 绘制状态覆盖值；为 Rest 时再回退到真实 hover/press 状态。
Rest
Hover
Pressed
Disabled

继承自 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 基类完整成员：QPushButton