Windows图形界面(GUI)-QT-C/C++ - Qt Combo Box

• 公开视频 -> 链接点击跳转公开课程
• 博客首页 -> ​​​链接点击跳转博客主页

目录

一、概述

1.1 基本概念

1.2 应用场景对比

二、核心属性详解

2.1 行为控制

2.2 显示配置

三、数据操作与访问

3.1 基础数据管理

3.2 高级数据访问

四、用户交互处理

4.1 信号处理机制

五、高级应用技巧

5.1 性能优化

六、综合应用案例

6.1 动态搜索建议

6.2 数据绑定示例

一、概述

1.1 基本概念

QComboBox 是 Qt 中重要的交互控件，具有以下特点：

• 提供下拉选择功能
• 支持单选模式（默认）和可编辑模式
• 可容纳文本、图标等数据类型
• 适用于设置项选择、表单输入等场景

1.2 应用场景对比

二、核心属性详解

2.1 行为控制

// 可编辑模式开关  
comboBox->setEditable(true);  

// 设置插入策略（示例：按字母排序）  
comboBox->setInsertPolicy(QComboBox::InsertAlphabetically);  

// 项目数量限制  
comboBox->setMaxCount(100);  // 最大100项  
comboBox->setMaxVisibleItems(10); // 下拉显示10项

2.2 显示配置

// 设置占位符文本  
comboBox->setPlaceholderText("请选择...");  

// 禁用边框显示  
comboBox->setFrame(false);  

// 自定义样式  
comboBox->setStyleSheet(  
    "QComboBox { background-color: #f0f0f0; }"  
    "QComboBox::drop-down { width: 30px; }"  
);

三、数据操作与访问

3.1 基础数据管理

// 批量添加项  
QStringList cities;  
cities << "北京" << "上海" << "广州" << "深圳";  
comboBox->addItems(cities);  

// 带数据项的添加（支持用户数据存储）  
comboBox->addItem("管理员", QVariant(1));  
comboBox->addItem("普通用户", QVariant(2));  

// 条件清除（保留前5项）  
while(comboBox->count() > 5) {  
    comboBox->removeItem(comboBox->count()-1);  
}

3.2 高级数据访问

// 遍历所有项目  
for(int i=0; i<comboBox->count(); ++i){  
    qDebug() << "Index:" << i   
             << "Text:" << comboBox->itemText(i)  
             << "Data:" << comboBox->itemData(i);  
}  

// 数据查找示例  
int findRole(QComboBox *cb, const QString &text){  
    return cb->findText(text, Qt::MatchExactly);  
}

四、用户交互处理

4.1 信号处理机制

// 索引变化处理  
connect(comboBox, QOverload<int>::of(&QComboBox::currentIndexChanged),  
        [](int index){  
            qDebug() << "当前选定项索引：" << index;  
        });  

// 文本内容变化处理（可编辑模式下）  
connect(comboBox, &QComboBox::editTextChanged,  
        [](const QString &text){  
            qDebug() << "输入内容：" << text;  
        });  

// 自定义验证（禁止空输入）  
connect(comboBox->lineEdit(), &QLineEdit::editingFinished,   
        [comboBox](){  
            if(comboBox->currentText().isEmpty()){  
                QToolTip::showText(comboBox->mapToGlobal(QPoint(0,0)),   
                                 "输入不能为空！");  
            }  
        });

五、高级应用技巧

5.1 性能优化

// 批量操作时关闭刷新  
comboBox->setUpdatesEnabled(false);  
for(int i=0; i<1000; i++){  
    comboBox->addItem(QString::number(i));  
}  
comboBox->setUpdatesEnabled(true);

六、综合应用案例

6.1 动态搜索建议

// 连接输入变化信号  
connect(comboBox->lineEdit(), &QLineEdit::textEdited,   
        [=](constQString&input){  
    comboBox->clear();  
    foreach(const QString &item, allItems){  
        if(item.contains(input, Qt::CaseInsensitive)){  
            comboBox->addItem(item);  
        }  
    }  
    comboBox->showPopup();  
});

6.2 数据绑定示例

struct UserData {  
    int userId;  
    QString department;  
};  

// 添加复杂数据项  
UserData data{1001, "技术部"};  
comboBox->addItem("张三", QVariant::fromValue(data));  

// 数据访问  
UserData selected = comboBox->currentData().value<UserData>();