Qt6 for C++ 常用界面组件的使用详解-CSDN博客

本文链接：https://blog.csdn.net/weixin_43484713/article/details/147965263

界面组件基础

常用界面组件概述

在 Qt6 for C++ 中，界面组件是构建用户界面的基本元素。这些组件提供了丰富的功能，可以满足各种界面需求。以下是一些常用的界面组件：

QWidget
- 所有用户界面对象的基类。
- 提供了基本的窗口功能，如大小、位置、标题等。
- 可以包含其他子组件。
QLabel
- 用于显示文本或图像。
- 支持简单的格式化文本（如 HTML）。
- 常用于显示静态信息。
QPushButton
- 标准的按钮组件。
- 可以显示文本或图标。
- 支持点击事件（clicked 信号）。
QLineEdit
- 单行文本输入框。
- 支持文本验证、输入掩码等功能。
- 常用于表单输入。
QTextEdit
- 多行文本编辑组件。
- 支持富文本格式（如 HTML）。
- 适用于需要多行输入的场景。
QComboBox
- 下拉选择框。
- 可以包含多个选项，用户可以选择其中之一。
- 支持可编辑模式。
QSpinBox
- 数字输入框（带上下箭头）。
- 支持整数输入，可以设置范围和步长。
- 适用于数值调整的场景。
QSlider
- 滑块组件。
- 支持水平和垂直方向。
- 常用于调整数值（如音量控制）。
QCheckBox
- 复选框组件。
- 支持选中和未选中状态。
- 适用于多选场景。
QRadioButton
- 单选按钮组件。
- 通常与 QButtonGroup 配合使用，实现单选功能。
- 适用于互斥选择的场景。
QProgressBar
- 进度条组件。
- 显示任务的完成进度。
- 支持水平和垂直方向。
QTabWidget
- 选项卡组件。
- 可以包含多个页面，用户通过标签切换。
- 适用于多页面布局。
QListWidget
- 列表组件。
- 显示一组项目，支持选择和操作。
- 适用于项目列表展示。
QTreeWidget
- 树形组件。
- 支持层级结构的数据展示。
- 适用于文件系统等场景。
QTableWidget
- 表格组件。
- 支持多行多列的数据展示。
- 适用于数据表格显示。

这些组件是 Qt6 中常用的界面元素，通过组合和定制，可以构建出功能丰富的用户界面。

QWidget类的属性

geometry
- 类型：QRect
- 描述：表示窗口部件的位置和大小，包括x、y坐标以及宽度和高度。
- 访问方法：
  - geometry()：获取当前几何属性。
  - setGeometry(const QRect &rect)：设置几何属性。
windowTitle
- 类型：QString
- 描述：窗口的标题，显示在标题栏或任务栏中。
- 访问方法：
  - windowTitle()：获取当前标题。
  - setWindowTitle(const QString &title)：设置标题。
enabled
- 类型：bool
- 描述：控制窗口部件是否可用（禁用时用户无法交互）。
- 访问方法：
  - isEnabled()：检查是否启用。
  - setEnabled(bool enable)：启用或禁用部件。
visible
- 类型：bool
- 描述：控制窗口部件是否可见。
- 访问方法：
  - isVisible()：检查是否可见。
  - setVisible(bool visible)：显示或隐藏部件。
sizePolicy
- 类型：QSizePolicy
- 描述：控制部件在布局中的大小调整行为（如固定大小、可扩展等）。
- 访问方法：
  - sizePolicy()：获取当前策略。
  - setSizePolicy(QSizePolicy policy)：设置策略。

QWidget类的常用接口函数

显示与隐藏
- show()：显示部件（等价于setVisible(true)）。
- hide()：隐藏部件（等价于setVisible(false)）。
- close()：关闭部件（可能触发closeEvent）。
事件处理
- mousePressEvent(QMouseEvent *event)：重写以处理鼠标按下事件。
- paintEvent(QPaintEvent *event)：重写以自定义绘制内容。
- resizeEvent(QResizeEvent *event)：重写以响应大小改变事件。
布局管理
- setLayout(QLayout *layout)：为部件设置布局管理器。
- layout()：获取当前布局。
坐标转换
- mapToGlobal(const QPoint &pos)：将部件局部坐标转换为屏幕全局坐标。
- mapFromGlobal(const QPoint &pos)：将屏幕全局坐标转换为部件局部坐标。
焦点控制
- setFocus()：使部件获取键盘焦点。
- hasFocus()：检查部件是否拥有焦点。
样式与外观
- setStyleSheet(const QString &styleSheet)：用CSS样式设置部件外观。
- update()：强制重绘部件（触发paintEvent）。

注意：以上仅为部分核心属性和接口，完整列表可参考Qt官方文档。

布局管理

QBoxLayout

Qt中的基础布局类，用于水平或垂直排列控件。

派生自QLayout
两个主要子类：
- QHBoxLayout：水平布局
- QVBoxLayout：垂直布局
特点：
- 自动调整子控件大小
- 支持拉伸因子(stretch factor)
- 可以嵌套使用

QFormLayout

专门用于表单样式布局的类。

典型的两列布局：
- 左列：标签(label)
- 右列：输入控件
特点：
- 自动对齐标签
- 支持添加行(addRow)操作
- 适用于设置对话框

QGridLayout

网格布局管理器。

将控件排列在二维网格中
特点：
- 可以指定行和列的位置
- 支持跨行跨列布局
- 灵活控制单元格大小
- 自动处理控件大小变化

QStackedLayout

堆叠布局管理器。

特点：
- 同一时间只显示一个控件
- 通过索引切换显示的控件
- 常用于标签页或向导界面
- 通常与QTabWidget配合使用

QLayout

所有布局管理器的基类。

提供基础布局功能
特点：
- 自动计算控件位置和大小
- 处理窗口大小变化
- 管理子控件的生命周期
- 提供间距(spacing)和边距(margin)控制

QSpacerItem

布局中的空白区域。

作用：
- 在布局中添加弹性空间
- 控制控件间的间距
- 实现对齐效果
类型：
- 水平间隔
- 垂直间隔
- 固定大小或可伸缩

QWidgetItem

布局中包装QWidget的项。

作用：
- 将QWidget作为布局项管理
- 处理控件的显示和隐藏
- 控制控件的大小策略
特点：
- 自动由布局管理器创建
- 通常不需要直接使用

布局可视化设计

布局可视化设计是指在Qt Creator等集成开发环境中，通过拖拽控件和布局管理器来直观地设计用户界面。主要特点包括：

所见即所得(WYSIWYG)：设计时看到的界面与运行时一致
控件面板：提供标准控件库，可直接拖拽到窗体上
布局管理器可视化：可以直观地添加水平、垂直、网格等布局
属性编辑器：实时调整控件和布局的属性
对象查看器：显示界面元素的层次结构

代码原理

Qt布局系统的代码实现原理：

布局管理器基类QLayout：
- 继承自QObject和QLayoutItem
- 提供addWidget()、addLayout()等基础接口
- 负责管理子控件和子布局的几何位置
布局过程：
- 当父窗口大小改变时触发布局更新
- 调用QLayout::activate()开始布局计算
- 各布局管理器实现自己的setGeometry()方法
大小策略(QSizePolicy)：
- 控制控件在布局中的伸缩行为
- 包含水平/垂直的Policy、Stretch因子等属性
- 影响布局时的最小/最大/理想尺寸计算
布局层次结构：
- 支持嵌套布局(布局中包含子布局)
- 布局管理器本身也可以作为子项添加到父布局中
- 最终形成树状的布局结构
自动更新机制：
- 当添加/移除控件时会自动触发布局更新
- 父窗口大小改变时自动重新计算布局
- 可通过update()强制刷新布局

字符串操作

QString简介

QString是Qt框架中用于处理Unicode字符串的类，它提供了丰富的字符串操作功能。与标准C++的std::string相比，QString更加强大且易于使用，特别是在处理国际化文本时表现优异。

主要特点

Unicode支持
QString内部使用UTF-16编码，可以无缝处理多语言文本（如中文、阿拉伯语等）。
隐式共享
采用写时复制（Copy-on-Write）技术，多个QString对象可以共享同一份数据，直到需要修改时才进行复制，提高了内存效率。
丰富的API
提供大量便捷方法，如字符串拼接、分割、查找、替换、大小写转换等。
与Qt框架深度集成
与QVariant、QIODevice等Qt类无缝协作，也是Qt信号槽机制中常用的参数类型。

基本用法示例

// 创建字符串
QString str1 = "Hello";
QString str2("Qt");

// 字符串拼接
QString result = str1 + " " + str2;  // "Hello Qt"

// 常用操作
int len = result.length();          // 获取长度
QString upper = result.toUpper();   // 转为大写
bool contains = result.contains("Qt"); // 检查包含

注意事项

避免频繁进行QString与std::string的转换，会有性能开销
对于字面量字符串，建议使用QStringLiteral宏提高效率
在多线程环境中，QString是线程安全的（只读操作）

QString字符串常用操作

构造字符串

QString str1 = "Hello"; // 直接赋值
QString str2("World");   // 构造函数
QString str3 = QString::fromUtf8("UTF-8字符串"); // 从UTF-8编码构造

字符串拼接

QString result = str1 + " " + str2; // 使用+运算符
str1.append(" Qt"); // 追加内容
QString::arg()格式化拼接：
QString name = "Alice";
int age = 25;
QString info = QString("Name: %1, Age: %2").arg(name).arg(age);

字符串比较

bool equal = (str1 == "Hello"); // 区分大小写比较
bool caseInsensitive = str1.compare("hello", Qt::CaseInsensitive) == 0;

字符串查找

int index = str1.indexOf("ell"); // 返回首次出现位置(3)
bool contains = str1.contains("lo"); // 是否包含子串

字符串截取

QString sub = str1.mid(1, 3); // 从位置1开始取3个字符("ell")
QString left = str1.left(2);   // 前2个字符("He")
QString right = str1.right(3); // 后3个字符("llo")

字符串转换

std::string stdStr = str1.toStdString();
const char* cStr = str1.toUtf8().constData();
int num = str1.toInt();    // 转整数
double d = str1.toDouble();// 转浮点数

字符串修改

str1.replace("ll", "LL"); // 替换子串
str1.remove(1, 2);       // 从位置1删除2个字符
str1.insert(5, "!");     // 在位置5插入字符

字符串格式化

QString hex = QString::number(255, 16); // 转16进制字符串("ff")
QString padded = QString("%1").arg(5, 3, 10, QChar('0')); // 补零("005")

其他常用操作

bool isEmpty = str1.isEmpty();  // 是否为空
int length = str1.length();     // 字符数
str1 = str1.toUpper();          // 转大写
str1 = str1.toLower();          // 转小写
str1 = str1.trimmed();          // 去除首尾空白

数值输入组件

QSpinBox

QSpinBox是Qt中的一个微调框控件，用于整数值的输入和调整。

主要特性：

用于处理整数值
提供上下箭头按钮来增加/减少值
可以直接在框中输入数值
可以设置最小值、最大值和步长

常用方法：

setMinimum(int) - 设置最小值
setMaximum(int) - 设置最大值
setValue(int) - 设置当前值
setSingleStep(int) - 设置步长
value() - 获取当前值

信号：

valueChanged(int) - 当值改变时发出

QDoubleSpinBox

QDoubleSpinBox是QSpinBox的浮点数版本，用于处理双精度浮点数值。

主要特性：

用于处理浮点数值
同样提供上下箭头按钮
可以设置小数位数
可以设置最小值、最大值和步长

常用方法：

setDecimals(int) - 设置小数位数
setMinimum(double) - 设置最小值
setMaximum(double) - 设置最大值
setValue(double) - 设置当前值
setSingleStep(double) - 设置步长
value() - 获取当前值

信号：

valueChanged(double) - 当值改变时发出

区别：

QSpinBox处理整数，QDoubleSpinBox处理浮点数
QDoubleSpinBox可以设置小数位数
两者在功能上非常相似，只是处理的数据类型不同

示例程序

在Qt6中，示例程序（Example Programs）是官方提供的用于展示Qt框架功能和用法的完整代码项目。这些示例通常涵盖Qt核心模块、GUI组件、网络、数据库等不同领域的应用场景。

主要特点：

分类明确
- 按模块分类（如Widgets、Quick、Network等）
- 按难度分级（Basic/Intermediate/Advanced）
可直接运行
每个示例都是完整的可执行项目，包含：
- .pro项目文件
- 源代码（.cpp/.h）
- 资源文件（如.qrc）
学习价值
- 展示最佳实践（如内存管理、信号槽用法）
- 演示特定API的使用方法（如QChart绘图）

获取方式：

Qt安装包自带
安装时勾选"Examples"组件（默认路径：Qt/Examples）
在线文档
官方文档每个类的"Related Examples"部分会链接到相关示例
GitHub仓库
qt/qtbase等仓库的examples目录

典型示例结构：

widgets/analogclock/
├── analogclock.pro
├── main.cpp
└── analogclock.cpp

使用建议：

通过Qt Creator直接打开.pro文件编译运行
调试时关注核心类的初始化流程
修改参数观察界面/行为变化

按钮组件

QPushButton

QPushButton是Qt中最常用的按钮控件，继承自QAbstractButton。主要特性包括：

文本显示：通过setText()设置按钮文字
图标支持：setIcon()可添加图标
快捷键：使用&符号定义快捷键（如"&Save"）
信号：
- clicked()：点击时发射
- pressed()/released()：按下/释放时发射

QToolButton

QToolButton是用于工具栏的小型按钮，继承自QAbstractButton。特殊功能：

自动提升：setAutoRaise(true)启用无边框悬停效果
菜单集成：setMenu()可附加下拉菜单
工具提示：通过setToolTip()设置
样式控制：setToolButtonStyle()调整图标和文本布局

QRadioButton

QRadioButton提供单选功能，继承自QAbstractButton。关键特性：

排他选择：同父控件中的单选按钮自动互斥
选中状态：isChecked()获取状态，setChecked()设置状态
分组控制：可通过QButtonGroup管理逻辑分组

QCheckBox

QCheckBox实现复选框功能，继承自QAbstractButton。重要接口：

三态支持：setTristate(true)启用不确定状态
状态获取：checkState()返回Qt::CheckState枚举值
部分选中：setCheckState(Qt::PartiallyChecked)设置中间状态

QCommandLinkButton

QCommandLinkButton是Vista风格命令链接按钮，继承自QPushButton。特色功能：

描述文本：setDescription()设置辅助说明文字
扁平样式：默认采用平面设计风格
大尺寸：比普通按钮更大的点击区域

QDialogButtonBox

QDialogButtonBox管理对话框标准按钮，继承自QWidget。核心功能：

标准按钮：通过addButton()添加QDialogButtonBox::StandardButton
布局控制：setOrientation()调整水平/垂直排列
信号转发：自动连接accepted()/rejected()等信号

示例程序功能实现

在Qt6中，示例程序通常用于展示特定组件或功能的用法。以下是一个典型的Qt6示例程序的基本结构和实现步骤：

1. 基本程序结构

#include <QApplication>
#include <QWidget>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv); // 创建应用程序对象

    QWidget window; // 创建主窗口
    window.setWindowTitle("示例程序"); // 设置窗口标题
    window.resize(400, 300); // 设置窗口大小
    window.show(); // 显示窗口

    return app.exec(); // 进入主事件循环
}

2. 添加组件

#include <QPushButton>

// 在main函数中添加按钮
QPushButton button("点击我", &window);
button.setGeometry(150, 100, 100, 30); // 设置按钮位置和大小

3. 信号与槽连接

// 连接按钮的clicked信号到槽函数
QObject::connect(&button, &QPushButton::clicked, []() {
    qDebug() << "按钮被点击了!";
});

4. 布局管理

#include <QVBoxLayout>

// 使用布局管理器
QVBoxLayout *layout = new QVBoxLayout(&window);
layout->addWidget(new QLabel("这是一个标签"));
layout->addWidget(&button);
window.setLayout(layout);

5. 自定义窗口类

class MyWindow : public QWidget {
    Q_OBJECT
public:
    MyWindow(QWidget *parent = nullptr) : QWidget(parent) {
        // 初始化UI
    }
};

6. 资源文件使用

<RCC>
    <qresource prefix="/">
        <file>images/icon.png</file>
    </qresource>
</RCC>

7. 国际化支持

QTranslator translator;
translator.load(":/translations/myapp_zh.qm");
app.installTranslator(&translator);

8. 样式表应用

window.setStyleSheet("QPushButton { background-color: red; }");

9. 多文档界面(MDI)

#include <QMdiArea>
QMdiArea *mdiArea = new QMdiArea;
mdiArea->addSubWindow(new QTextEdit);

10. 线程使用

#include <QThread>

class Worker : public QObject {
    Q_OBJECT
public slots:
    void doWork() {
        // 耗时操作
    }
};

QThread thread;
Worker worker;
worker.moveToThread(&thread);

这些代码片段展示了Qt6中常见功能的实现方式，可以根据需要组合使用这些技术来构建完整的应用程序。

滑块与进度条组件

QSlider 属性及函数

属性

minimum: 滑块的最小值
maximum: 滑块的最大值
value: 滑块的当前值
singleStep: 单步增量（键盘方向键调整时的步长）
pageStep: 页步增量（PageUp/PageDown键调整时的步长）
orientation: 滑块方向（Qt::Horizontal或Qt::Vertical）
tickPosition: 刻度位置（QSlider::NoTicks、QSlider::TicksAbove等）
tickInterval: 刻度间隔

常用函数

setRange(int min, int max): 设置取值范围
setValue(int val): 设置当前值
value(): 获取当前值
setTickPosition(QSlider::TickPosition position): 设置刻度位置
setOrientation(Qt::Orientation orientation): 设置方向

信号

valueChanged(int value): 值改变时触发
sliderPressed(): 滑块被按下时触发
sliderReleased(): 滑块释放时触发

QProgressBar 属性及函数

属性

minimum: 进度条最小值
maximum: 进度条最大值
value: 当前进度值
textVisible: 是否显示进度文本
orientation: 方向（Qt::Horizontal或Qt::Vertical）
format: 文本显示格式（如"%p%"显示百分比）
alignment: 文本对齐方式

常用函数

setRange(int min, int max): 设置取值范围
setValue(int val): 设置当前进度值
value(): 获取当前进度值
reset(): 重置进度条
setFormat(const QString &format): 设置文本格式

信号

valueChanged(int value): 进度值改变时触发

示例程序功能实现

在Qt6中，示例程序通常用于展示特定组件或功能的用法。以下是一个典型的Qt6示例程序的基本结构和实现步骤：

1. 基本程序结构

#include <QApplication>
#include <QWidget>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv); // 创建应用程序对象

    QWidget window; // 创建主窗口
    window.setWindowTitle("示例程序"); // 设置窗口标题
    window.resize(400, 300); // 设置窗口大小
    window.show(); // 显示窗口

    return app.exec(); // 进入主事件循环
}

2. 添加组件

#include <QPushButton>

// 在main函数中添加按钮
QPushButton button("点击我", &window);
button.setGeometry(150, 100, 100, 30); // 设置按钮位置和大小

3. 信号与槽连接

// 连接按钮的clicked信号到槽函数
QObject::connect(&button, &QPushButton::clicked, []() {
    qDebug() << "按钮被点击了!";
});

4. 布局管理

#include <QVBoxLayout>

// 使用布局管理器
QVBoxLayout *layout = new QVBoxLayout(&window);
layout->addWidget(new QLabel("这是一个标签"));
layout->addWidget(&button);
window.setLayout(layout);

5. 自定义窗口类

class MyWindow : public QWidget {
    Q_OBJECT
public:
    MyWindow(QWidget *parent = nullptr) : QWidget(parent) {
        // 初始化UI
    }
};

6. 资源文件使用

<RCC>
    <qresource prefix="/">
        <file>images/icon.png</file>
    </qresource>
</RCC>

7. 国际化支持

QTranslator translator;
translator.load(":/translations/myapp_zh.qm");
app.installTranslator(&translator);

8. 样式表应用

window.setStyleSheet("QPushButton { background-color: red; }");

9. 多文档界面(MDI)

#include <QMdiArea>
QMdiArea *mdiArea = new QMdiArea;
mdiArea->addSubWindow(new QTextEdit);

10. 线程使用

#include <QThread>

class Worker : public QObject {
    Q_OBJECT
public slots:
    void doWork() {
        // 耗时操作
    }
};

QThread thread;
Worker worker;
worker.moveToThread(&thread);

这些代码片段展示了Qt6中常见功能的实现方式，可以根据需要组合使用这些技术来构建完整的应用程序。

日期时间组件

QDate

QDate 是 Qt 中用于处理日期的类，它提供以下功能：

存储年、月、日信息
支持日期计算（如加减天数）
日期比较和有效性检查
与字符串相互转换

常用方法：

QDate currentDate = QDate::currentDate();  // 获取当前日期
bool isValid = QDate::isValid(2023, 13, 1);  // 检查日期有效性
int daysTo = date1.daysTo(date2);  // 计算两个日期之间的天数差

QTime

QTime 类用于处理时间值，包含以下功能：

存储时、分、秒和毫秒
时间计算和比较
时间格式化输出
计时功能

常用方法：

QTime currentTime = QTime::currentTime();  // 获取当前时间
int msecs = time1.msecsTo(time2);  // 计算两个时间之间的毫秒差
QString formatted = time.toString("hh:mm:ss");  // 格式化输出

QDateTime

QDateTime 组合了 QDate 和 QTime，提供完整的日期时间处理：

同时存储日期和时间
时区支持
时间戳转换
丰富的日期时间计算

常用方法：

QDateTime now = QDateTime::currentDateTime();  // 获取当前日期时间
qint64 timestamp = now.toSecsSinceEpoch();  // 转换为时间戳
QDateTime fromStamp = QDateTime::fromSecsSinceEpoch(timestamp);  // 从时间戳创建

这些类都支持与字符串的相互转换，并提供了丰富的比较和计算运算符重载，是 Qt 中处理日期时间数据的基础组件。

QDateEdit

QDateEdit 是一个用于编辑日期的 Qt 组件。它允许用户通过下拉日历或键盘输入来选择日期。

主要特性：

显示格式可自定义（如 yyyy-MM-dd）
支持最小/最大日期范围限制
提供日历弹出窗口
支持键盘导航

常用方法：

setDate() 设置日期
date() 获取当前日期
setDisplayFormat() 设置显示格式
setMinimumDate()/setMaximumDate() 设置日期范围

QTimeEdit

QTimeEdit 是用于编辑时间的组件，支持小时、分钟和秒的输入。

主要特性：

24小时或12小时制显示
可设置时间范围
支持键盘和鼠标滚轮调整

常用方法：

setTime() 设置时间
time() 获取当前时间
setDisplayFormat() 设置时间格式
setTimeRange() 设置时间范围

QDateTimeEdit

QDateTimeEdit 组合了日期和时间编辑功能，可以同时处理日期和时间。

主要特性：

日期和时间组合显示
可分别控制日期和时间部分
支持自定义显示格式

常用方法：

setDateTime() 设置日期时间
dateTime() 获取当前日期时间
setCalendarPopup() 启用日历弹出

QCalendarWidget

QCalendarWidget 提供一个完整的月份日历视图，允许用户直观地选择日期。

主要特性：

月视图显示
支持导航到不同月份/年份
可标记特定日期
支持日期范围选择

常用方法：

setSelectedDate() 设置选中日期
selectedDate() 获取选中日期
setMinimumDate()/setMaximumDate() 设置可选范围
setGridVisible() 显示/隐藏网格线

定时器组件

QTimer类

QTimer是Qt框架中提供的一个定时器类，用于在指定的时间间隔触发信号。它通常用于需要周期性执行某些操作的场景，如动画、定时刷新界面等。

主要功能

单次定时器：只触发一次超时信号。
周期性定时器：以固定的时间间隔重复触发超时信号。

常用成员函数

start(int msec)：启动定时器，参数msec表示时间间隔（毫秒）。
stop()：停止定时器。
setSingleShot(bool single)：设置是否为单次定时器（true表示单次）。
isActive()：判断定时器是否正在运行。

信号

timeout()：定时器超时时触发的信号。

示例代码

#include <QTimer>
#include <QDebug>

// 创建定时器对象
QTimer *timer = new QTimer(this);

// 连接超时信号到槽函数
connect(timer, &QTimer::timeout, []() {
    qDebug() << "Timer triggered!";
});

// 启动定时器，每隔1秒触发一次
timer->start(1000);

注意事项

定时器的精度依赖于操作系统和硬件，可能不会完全精确。
如果需要在主线程中执行耗时操作，建议使用QTimer结合QEventLoop或QThread以避免界面卡顿。

QElapsedTimer类

QElapsedTimer 是 Qt 提供的一个用于测量时间间隔的类。它主要用于计算代码执行时间、性能分析等场景。

主要特点

高精度计时：使用系统提供的最精确的计时方法（如 Windows 的 QueryPerformanceCounter）
单调递增：不受系统时间调整的影响
轻量级：适合频繁调用的场景

常用方法

void start(): 开始计时
qint64 elapsed(): 返回自 start() 调用后经过的毫秒数
qint64 nsecsElapsed(): 返回纳秒数（Qt 5+）
bool hasExpired(qint64 timeout): 检查是否已超过指定毫秒数
qint64 restart(): 重新开始计时并返回上次计时时长

使用示例

QElapsedTimer timer;
timer.start();

// 执行一些操作
doSomething();

qDebug() << "操作耗时:" << timer.elapsed() << "毫秒";

注意事项

最大可测量时间取决于平台（通常足够长）
结果值可能溢出，但需要极长时间
不同平台的计时精度可能不同

典型应用场景

性能分析
超时检测
帧率计算
算法耗时统计

下拉列表框组件

QComboBox类

QComboBox 是 Qt 中的一个常用界面组件，用于提供一个下拉列表供用户选择。它是一个组合框，可以显示当前选中的项，并允许用户从下拉列表中选择其他选项。

主要特性

下拉列表：点击时会展开一个下拉列表，显示所有可选项。
可编辑性：可以通过 setEditable(true) 设置为可编辑，允许用户输入自定义内容。
信号与槽机制：提供 currentIndexChanged 和 currentTextChanged 等信号，用于响应用户的选择变化。

常用方法

addItem(const QString &text)：添加一个选项到下拉列表。
currentText()：获取当前选中的文本。
currentIndex()：获取当前选中项的索引。
setCurrentIndex(int index)：设置当前选中的索引。
clear()：清空所有选项。

示例代码

#include <QComboBox>
#include <QApplication>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    QComboBox comboBox;
    
    comboBox.addItem("Option 1");
    comboBox.addItem("Option 2");
    comboBox.addItem("Option 3");
    
    comboBox.show();
    return app.exec();
}

信号与槽连接示例

QObject::connect(&comboBox, &QComboBox::currentIndexChanged, [](int index) {
    qDebug() << "Selected index:" << index;
});

适用场景

需要用户从预定义选项中选择时。
需要节省界面空间时（因为下拉列表可以折叠）。

示例程序功能实现

在Qt6中，示例程序通常用于展示特定组件或功能的用法。以下是一个典型的Qt6示例程序的基本结构和实现步骤：

1. 基本程序结构

#include <QApplication>
#include <QWidget>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv); // 创建应用程序对象

    QWidget window; // 创建主窗口
    window.setWindowTitle("示例程序"); // 设置窗口标题
    window.resize(400, 300); // 设置窗口大小
    window.show(); // 显示窗口

    return app.exec(); // 进入主事件循环
}

2. 添加组件

#include <QPushButton>

// 在main函数中添加按钮
QPushButton button("点击我", &window);
button.setGeometry(150, 100, 100, 30); // 设置按钮位置和大小

3. 信号与槽连接

// 连接按钮的clicked信号到槽函数
QObject::connect(&button, &QPushButton::clicked, []() {
    qDebug() << "按钮被点击了!";
});

4. 布局管理

#include <QVBoxLayout>

// 使用布局管理器
QVBoxLayout *layout = new QVBoxLayout(&window);
layout->addWidget(new QLabel("这是一个标签"));
layout->addWidget(&button);
window.setLayout(layout);

5. 自定义窗口类

class MyWindow : public QWidget {
    Q_OBJECT
public:
    MyWindow(QWidget *parent = nullptr) : QWidget(parent) {
        // 初始化UI
    }
};

6. 资源文件使用

<RCC>
    <qresource prefix="/">
        <file>images/icon.png</file>
    </qresource>
</RCC>

7. 国际化支持

QTranslator translator;
translator.load(":/translations/myapp_zh.qm");
app.installTranslator(&translator);

8. 样式表应用

window.setStyleSheet("QPushButton { background-color: red; }");

9. 多文档界面(MDI)

#include <QMdiArea>
QMdiArea *mdiArea = new QMdiArea;
mdiArea->addSubWindow(new QTextEdit);

10. 线程使用

#include <QThread>

class Worker : public QObject {
    Q_OBJECT
public slots:
    void doWork() {
        // 耗时操作
    }
};

QThread thread;
Worker worker;
worker.moveToThread(&thread);

这些代码片段展示了Qt6中常见功能的实现方式，可以根据需要组合使用这些技术来构建完整的应用程序。

主窗口与相关组件

QMainWindow

QMainWindow 是 Qt 中用于创建主窗口的类，它提供了一个标准的应用程序框架，包含菜单栏、工具栏、状态栏和中央部件区域。它是大多数桌面应用程序的主窗口基础。

主要特点：

提供预定义的布局结构
支持菜单栏(QMenuBar)
支持多个工具栏(QToolBar)
支持状态栏(QStatusBar)
中央区域可以放置任何QWidget作为主要内容
支持停靠窗口(QDockWidget)

基本用法：

QMainWindow *mainWindow = new QMainWindow();
mainWindow->setWindowTitle("My Application");
mainWindow->resize(800, 600);
mainWindow->show();

QAction

QAction 是一个可以添加到菜单和工具栏中的抽象用户界面动作。它封装了用户操作的属性，如文本、图标、快捷键和触发后的行为。

主要特点：

可以同时添加到菜单和工具栏
支持快捷键
支持启用/禁用状态
可以设置图标和文本
可以连接信号和槽

基本用法：

QAction *openAction = new QAction(QIcon(":/images/open.png"), "&Open", this);
openAction->setShortcut(QKeySequence::Open);
openAction->setStatusTip("Open an existing file");
connect(openAction, &QAction::triggered, this, &MyClass::openFile);

QToolBar

QToolBar 是一个可以包含一组动作(QAction)的可移动面板，通常位于主窗口的顶部或侧面。用户可以通过拖动来重新定位工具栏。

主要特点：

可以包含按钮、小部件和其他动作
支持浮动和停靠
可以设置为可移动或固定
支持图标和文本显示
可以添加分隔符来分组相关动作

基本用法：

QToolBar *fileToolBar = mainWindow->addToolBar("File");
fileToolBar->addAction(openAction);
fileToolBar->addAction(saveAction);
fileToolBar->setMovable(false); // 固定工具栏位置

QStatusBar

QStatusBar 是显示在窗口底部的状态信息栏，用于向用户展示应用程序的当前状态或提示信息。

主要特点：

位于主窗口底部
可以显示临时或永久消息
支持添加自定义小部件
有消息超时功能
可以显示进度条等状态指示器

基本用法：

QStatusBar *statusBar = mainWindow->statusBar();
statusBar->showMessage("Ready", 2000); // 显示2秒的临时消息

// 添加永久部件
QLabel *permanent = new QLabel("Version 1.0");
statusBar->addPermanentWidget(permanent);

混合式UI设计

混合式UI设计是指在Qt应用程序开发中，将QML和**C++**两种技术结合使用的界面设计方法。这种设计方式充分利用了两种技术的优势：

QML部分：
- 用于创建动态、美观的用户界面
- 声明式语法使得UI布局和动画效果更容易实现
- 适合处理视觉元素和用户交互
C++部分：
- 用于实现核心业务逻辑
- 处理性能敏感的操作
- 访问系统级功能

实现方式

在Qt中主要通过以下机制实现混合：

QML调用C++：通过注册C++类或使用上下文属性
C++调用QML：通过QQmlApplicationEngine或QQuickView访问QML对象

优势

开发效率：QML快速原型设计+C++高性能实现
维护性：界面与逻辑分离
灵活性：可根据需求调整QML和C++的比例

典型应用场景

需要复杂动画效果的界面
跨平台应用程序
性能要求较高的专业软件

注意事项

需要注意QML和C++之间的数据传递效率
要处理好两种语言之间的类型转换
调试时需要同时考虑QML和C++的调试环境

文本编辑与显示组件

QPlainTextEdit的使用

QPlainTextEdit是Qt中用于显示和编辑纯文本的组件，相比QTextEdit更适合处理大段纯文本内容。

基本特性

专门设计用于处理纯文本
比QTextEdit更高效，特别是处理大量文本时
支持基本的文本编辑功能
提供滚动条和文本换行功能

常用方法

设置/获取文本

// 设置文本
plainTextEdit->setPlainText("Hello World");

// 获取文本
QString text = plainTextEdit->toPlainText();

追加文本

plainTextEdit->appendPlainText("New line of text");

文本操作

// 清除文本
plainTextEdit->clear();

// 插入文本
plainTextEdit->insertPlainText("Inserted text");

// 选择文本
plainTextEdit->selectAll();

查找功能

bool found = plainTextEdit->find("search text");

常用信号

textChanged() - 文本内容发生变化时触发
selectionChanged() - 选中文本发生变化时触发
cursorPositionChanged() - 光标位置变化时触发

样式设置

// 设置字体
plainTextEdit->setFont(QFont("Courier", 12));

// 设置只读
plainTextEdit->setReadOnly(true);

// 设置文本颜色
plainTextEdit->setStyleSheet("color: blue;");

性能优化

对于大量文本，建议使用setMaximumBlockCount()限制显示的行数
可以使用setWordWrapMode()控制文本换行方式

QPlainTextEdit是处理日志、代码编辑器等需要显示大量纯文本场景的理想选择。

QLabel 显示图片

QLabel 是 Qt 中用于显示文本或图像的组件。要显示图片，可以使用以下步骤：

创建 QLabel 对象：
```
QLabel *label = new QLabel(this);
```
设置图片：
- 使用 QPixmap 加载图片文件。
- 通过 setPixmap() 方法将图片设置到 QLabel 中。
```
QPixmap pixmap("path/to/image.png");
label->setPixmap(pixmap);
```
调整显示（可选）：
- 使用 setScaledContents(true) 可以让图片自适应 QLabel 的大小。
```
label->setScaledContents(true);
```
显示 QLabel：
```
label->show();
```

QPixmap

QPixmap 是 Qt 中用于处理图像的类，主要用于显示图像。以下是 QPixmap 的常用功能：

加载图片：
```
QPixmap pixmap("path/to/image.png");
```

检查图片是否加载成功：

if (pixmap.isNull()) {
    qDebug() << "Failed to load image";
}

调整图片大小：

使用 scaled() 方法可以缩放图片。

QPixmap scaledPixmap = pixmap.scaled(100, 100, Qt::KeepAspectRatio);

保存图片：
```
pixmap.save("path/to/save/image.png");
```
转换为其他格式（如 QImage）：
```
QImage image = pixmap.toImage();
```

结合使用 QLabel 和 QPixmap

通常会将 QPixmap 和 QLabel 结合使用来显示图片：

QPixmap pixmap("path/to/image.png");
QLabel *label = new QLabel(this);
label->setPixmap(pixmap);
label->setScaledContents(true); // 可选：自适应大小
label->show();

注意事项

文件路径：确保图片路径正确，否则 QPixmap 会加载失败。
资源文件：在 Qt 项目中，可以将图片添加到资源文件中（.qrc），然后通过 :/ 前缀访问。
```
QPixmap pixmap(":/images/image.png");
```
性能：QPixmap 适合用于界面显示，而 QImage 更适合图像处理。

列表、树形与表格组件

QListWidget

QListWidget 是 Qt 中的一个列表控件，用于显示和管理一列项目。它是 QListView 的子类，提供了更简单的接口来添加、删除和操作列表项。

主要功能：
- 显示一列文本或图标项目
- 支持单选或多选模式
- 支持拖放操作
- 支持自定义项目（通过 QListWidgetItem）
常用方法：
- addItem()：添加一个项目
- takeItem()：移除并返回一个项目
- currentItem()：获取当前选中的项目
- setSelectionMode()：设置选择模式（单选、多选等）
信号：
- itemClicked(QListWidgetItem*)：当项目被点击时触发
- itemDoubleClicked(QListWidgetItem*)：当项目被双击时触发

QTreeWidget

QTreeWidget 是 Qt 中的一个树形控件，用于显示层次结构的数据。它是 QTreeView 的子类，提供了更简单的接口来操作树形数据。

主要功能：
- 显示层次结构的项目（父节点和子节点）
- 支持多列显示
- 支持自定义项目（通过 QTreeWidgetItem）
- 支持展开和折叠节点
常用方法：
- addTopLevelItem()：添加一个顶级节点
- insertTopLevelItem()：在指定位置插入顶级节点
- currentItem()：获取当前选中的节点
- expandAll()：展开所有节点
信号：
- itemClicked(QTreeWidgetItem*, int)：当节点被点击时触发
- itemDoubleClicked(QTreeWidgetItem*, int)：当节点被双击时触发

QTableWidget

QTableWidget 是 Qt 中的一个表格控件，用于显示二维表格数据。它是 QTableView 的子类，提供了更简单的接口来操作表格数据。

主要功能：
- 显示行和列的表格数据
- 支持单元格编辑
- 支持自定义单元格（通过 QTableWidgetItem）
- 支持表头（水平和垂直）
常用方法：
- setRowCount()：设置行数
- setColumnCount()：设置列数
- setItem()：设置指定单元格的项目
- item()：获取指定单元格的项目
信号：
- cellClicked(int, int)：当单元格被点击时触发
- cellDoubleClicked(int, int)：当单元格被双击时触发