按钮控件

按钮控件

UIGQPushButton 是 WidgetKit 的按钮控件，用于普通操作按钮、主按钮、图标按钮、工具栏按钮和导航按钮。

按钮支持按状态配置背景和文字样式，支持 PNG/SVG 图标，SVG 图标可以保留原始颜色，也可以由控件统一指定颜色。

常见状态

• 默认状态（Normal）
• 鼠标悬停状态（Hot）
• 鼠标按下状态（Pressed）
• 禁用状态（Disable）

C++ 使用

UIGQPushButton* button = new UIGQPushButton(parent);
button->setObjectName("saveButton");
button->setText("保存");
button->setThemeName("PrimaryButton");
button->setIcon(":/UIGearsWidgetKit/images/save.svg");
button->setFadeEnabled(true);
button->setFadeDuration(160);

按钮 fade 效果默认关闭。可以通过全局配置统一开启，也可以单独设置某个按钮：

UIGQtLib::UIGGlobalConfig config;
config.globalFontFamily = "Microsoft YaHei";
config.buttonFadeEnabled = true;
config.buttonFadeDuration = 160;
UIGQtLib::uigSetGlobalConfig(config);

button->setFadeEnabled(false);

类继承关系

QWidget
  └─ QAbstractButton
      └─ QPushButton
          └─ UIGQPushButton

IUIGQWidgetBase
  └─ UIGQPushButton

UIGQPushButton 同时继承 Qt 的 QPushButton 和 WidgetKit 的 IUIGQWidgetBase。因此它既可以使用 Qt 标准按钮能力，例如 setText(...)、clicked 信号、setEnabled(...)，也可以使用 WidgetKit 的主题、布局和 JSON 序列化能力。

内部实现上，每个 UIGQPushButton 持有一个 UIGQWidgetBase 基础控制对象和一个 UIGQPushButtonImpl 绘制实现对象：

控件接口说明

构造

主题和序列化

背景和状态样式

Fade 动画

图标

文本

WidgetKit 通用布局接口

信号

主题样式建议

按钮背景、文字、图标颜色建议放到主题中维护。业务代码只负责设置文本、图标路径、状态和动作，避免把颜色、圆角、边框写散在页面逻辑里。

使用建议

• 普通业务按钮优先通过 setThemeName(...) 绑定主题，不建议在页面代码里硬编码颜色。
• 图标按钮如果不需要背景，使用 drawBackground: false 或 setDrawBackground(false)。
• SVG 图标需要统一适配主题色时，设置 iconUseColor: true 和 iconColor。
• 页面中主按钮数量应保持克制，避免多个强强调按钮同时出现。