XQT_UI 组件｜02｜ 按钮 XPushButton

XPushButton 使用文档

简介

XPushButton 是一个自定义的按钮类，基于 Qt 框架构建，提供了丰富的样式和功能选项。它允许开发者轻松创建具有不同外观和行为的按钮，以满足用户界面的需求。

特性

• 颜色设置：支持多种颜色选择。
• 样式设置：可以设置为圆角、镂空或块状按钮。
• 链式调用：支持链式调用，方便设置多个属性。
• 转换功能：可以将普通的 QPushButton 转换为 XPushButton，并应用新样式。

使用说明

1. 创建按钮

要创建一个 XPushButton，只需调用构造函数并传入按钮文字：

XPushButton* button = new XPushButton("按钮文字");

2. 设置按钮颜色

可以使用 color 方法设置按钮的颜色，支持的颜色包括：blue、yellow、green、grey 等。

button->color("blue"); // 设置按钮颜色为蓝色

3. 设置按钮样式

XPushButton 提供了多种样式设置方法：

• 圆角按钮：使用 round(true) 方法设置为圆角按钮。
• 镂空按钮：使用 line(true) 方法设置为镂空按钮。
• 块状按钮：使用 chunk(true) 方法设置为块状按钮。

示例：

button->round(true); // 设置为圆角按钮
button->line(true);  // 设置为镂空按钮
button->chunk(true); // 设置为块状按钮

4. 组合使用

可以组合使用不同的样式设置，形成复杂的按钮样式。例如：

button->color("blue")->round(true)->line(true); // 设置为蓝色圆角镂空按钮

5. 转换普通 QPushButton

如果你有一个普通的 QPushButton，可以通过 XPushButton 的构造函数将其转换为 XPushButton，并应用新样式：

QPushButton* qBtn = new QPushButton("普通按钮");
XPushButton* xBtn = new XPushButton(qBtn);
xBtn->color("blue"); // 设置样式为蓝色

注意事项

• 可以链式调用设置多个属性，方便快捷。
• 颜色、圆角、镂空、块状按钮可以自由组合，满足不同的设计需求。
• 对于已有的 QPushButton，可以通过 XPushButton 构造函数转换并应用新样式。

示例代码

以下是一个完整的示例，展示了如何使用 XPushButton：

#include "xqtbutton.h"

// 创建按钮
XPushButton* button = new XPushButton("按钮文字");
button->color("blue")->round(true)->line(true); // 设置样式