QT——QComboBox组合框控件
QComboBox概述
QComboBox是Qt框架中提供的组合框控件，它结合了按钮和下拉列表的功能，允许用户从预定义的选项列表中选择一个或多个项目。
基本特性
| 特性 | 描述 |
|---|---|
| 显示方式 | 显示当前选中项，点击后展开下拉列表 |
| 编辑能力 | 可设置为可编辑或不可编辑 |
| 项目类型 | 支持文本、图标或自定义数据 |
| 信号机制 | 提供当前项改变时的信号通知 |
核心功能实现
1. 创建和初始化QComboBox
在UI设计器中添加：
从工具箱拖拽QComboBox到窗体
设置objectName(如comboBox)
在属性编辑器中设置初始属性
代码初始化：
// 创建QComboBox对象
QComboBox *comboBox = new QComboBox(this);// 添加项目
comboBox->addItem(tr("选项1"));
comboBox->addItem(tr("选项2"));
comboBox->addItem(tr("选项3"));// 或者批量添加
QStringList items;
items << tr("红色") << tr("绿色") << tr("蓝色");
comboBox->addItems(items);2. 获取当前选中的值
// 获取当前选中的文本
QString currentText = comboBox->currentText();
qDebug() << "当前选中的文本：" << currentText;// 获取当前选中的索引（从 0 开始）
int currentIndex = comboBox->currentIndex();
qDebug() << "当前选中的索引：" << currentIndex;3. 设置默认选中项
// 通过索引设置默认选中项
comboBox->setCurrentIndex(1); // 选中第 2 个选项（"选项2"）// 通过文本设置默认选中项
comboBox->setCurrentText("选项3"); // 选中 "选项3"信号与槽机制
QComboBox提供多种信号来响应用户操作：
| 信号 | 描述 |
|---|---|
currentIndexChanged(int) | 当前选中项改变时触发 |
currentTextChanged(const QString &) | 当前文本改变时触发 |
activated(int) | 用户选择某项时触发 |
highlighted(int) | 鼠标悬停某项时触发 |
QComboBox 的常用 API
| 方法 | 说明 |
|---|---|
addItem(const QString &text) | 添加一个选项 |
addItems(const QStringList &texts) | 批量添加选项 |
insertItem(int index, const QString &text) | 在指定位置插入选项 |
removeItem(int index) | 删除指定位置的选项 |
currentText() | 获取当前选中的文本 |
currentIndex() | 获取当前选中的索引 |
setCurrentIndex(int index) | 设置当前选中的索引 |
setCurrentText(const QString &text) | 设置当前选中的文本 |
count() | 获取选项总数 |
itemText(int index) | 获取指定索引的文本 |
itemData(int index) | 获取指定索引的数据 |
setItemData(int index, const QVariant &value) | 设置指定索引的数据 |
setEditable(bool editable) | 设置是否可编辑 |
clear() | 清空所有选项 |
最佳实践
- 初始化时设置默认值：避免用户未选择时出现空值。
- 合理使用信号槽：监听
currentIndexChanged或editTextChanged以响应用户操作。 - 关联数据：使用
setItemData()存储额外信息（如 ID），便于后续处理。 - 优化性能：如果选项较多，考虑使用
QAbstractItemModel自定义模型。