Qt应用开发(基础篇)——下拉框 QComboBox、QFontComboBox

一、前言      

         QComboBox下拉框继承于QWidget，作为Qt Wdiget常用的控件，在实际开发中，经常用来作为某些特定参数属性的选择，比如语言、国家、字体、主题、模式、串口号、波特率等选择性已知需要下拉的场景。而QFontComboBox字体下拉框继承于QComboBox，是一个封装专门用来显示字体的控件。

        QComboBox是一种显示列表选项的控件，占用屏幕最小。列表内容可以是图像或者字符串，列表内容可以是固定也可以是可编辑的。在应用中可随时做插入删除的动态操作，通过信号获取状态的改变。

         QFontComboBox通常用于工具栏，与QComboBox一起用于控制字体大小，两个QToolButton或者QCheckBox用于控制粗体和斜体。

二、QComboBox类

1、count

        该属性保存当前下拉列表的总条数，没有则是0。

 int count() const //当前下拉列表总条数

2、currentIndex

        该属性保存当前列表的显示下标，从0开始。如果下拉框是空的，那么此值为-1。

int currentIndex() const            //当前下拉框显示的列表值的下标
void setCurrentIndex(int index)     //设置下拉框显示的列表值的下标

3、currentText

        该属性保存当前显示的文本。

QString currentText() const                //返回当前显示的文本
void setCurrentText(const QString &text)   //设置当前显示的文本

4、duplicatesEnabled

        该属性保存是否列表插入重复的数据，默认为false。

bool duplicatesEnabled() const           //获取是否可以插入重复项
void setDuplicatesEnabled(bool enable)   //设置是否可以插入重复项

5、editable

        该属性保存是否可编辑，默认值为false。

 bool isEditable() const            //获取是否可编辑
 void setEditable(bool editable)    //设置是否可编辑

6、frame

        该属性保存下拉框是否使用边框绘制。

bool hasFrame() const    //获取是否有边框
void setFrame(bool)      //设置是否有边框

7、iconSize

        该属性保存组合框显示的图标大小，添加列表项的时候可以同时设置icon路径。

QSize iconSize() const        //获取图标尺寸
void setIconSize(const QSize &size)    //设置图标尺寸
void addItem(const QIcon &icon, const QString &text, const QVariant &userData = QVariant())    //添加列表项，显示文本和自定义数据
QIcon itemIcon(int index) const    //获取图标

8、insertPolicy

        该属性保存组合框插入策略，默认新插入的为最后一项。

QComboBox::InsertPolicy insertPolicy() const           //获取插入策略
void setInsertPolicy(QComboBox::InsertPolicy policy)    //设置插入策略

1) QComboBox::NoInsert                //不会被插入
2) QComboBox::InsertAtTop             //当做第一项插入
3) QComboBox::InsertAtCurrent         //当前项被替换
4) QComboBox::InsertAtBottom          //当做最后一项插入
5) QComboBox::InsertAfterCurrent      //插入到当前项之后
6) QComboBox::InsertBeforeCurrent     //插入到当前项之前
7) QComboBox::InsertAlphabetically    //字符串按照字母顺序插入到组合框中

9、maxCount

        该属性保存组合框下拉列表最大支持条数。

 int maxCount() const            //获取最大条数
 void setMaxCount(int max)       //设置最大条数

10、maxVisibleItems

        该属性保存屏幕下拉显示的最大条数，默认10条。

int maxVisibleItems() const          //获取显示最大条数
void setMaxVisibleItems(int maxItems)//设置显示最大条数

11、minimumContentsLength

        该属性保存组合框中应容纳的最小字符数，默认为0。

int minimumContentsLength() const                //获取最小字符数
void setMinimumContentsLength(int characters)    //设置最小字符数

12、sizeAdjustPolicy

        该属性保存尺寸调整策略，出于性能考虑，大模型才考虑使用此方法。

QComboBox::SizeAdjustPolicy sizeAdjustPolicy() const    //获取策略
void setSizeAdjustPolicy(QComboBox::SizeAdjustPolicy policy) //设置策略
1） QComboBox::AdjustToContents             //组合框将始终根据内容进行调整
2） QComboBox::AdjustToContentsOnFirstShow  //组合框将在第一次显示时调整到它的内容。
3） QComboBox::AdjustToMinimumContentsLengthWithIcon //组合框将调整到最小宽度加图标距离

13、userData

        自定义数据，下拉表项绑定自定义数据。

void addItem(const QString &text, const QVariant &userData = QVariant()) //插入一列，可选是否附带自定义数据
int findData(const QVariant &data, int role = Qt::UserRole, Qt::MatchFlags flags = static_cast<Qt::MatchFlags>(Qt::MatchExactly|Qt::MatchCaseSensitive)) const  //根据自定义数据查找
int findText(const QString &text, Qt::MatchFlags flags = Qt::MatchExactly|Qt::MatchCaseSensitive) const //根据列表文本查找

        在实际应用中，给每一项添加自定义数据是很常用的，比如需要显示各个国家的下拉框，分别有中国、美国、英国。他们代表的值分别为5、6、7，就需要addItem的时候绑定每个文本代表的自定义数据值，当我们从通讯得到了6，通过findData去找到绑定的数据得到下标，从而让下拉框显示美国。

QComboBox *box = new QComboBox(this);
box->addItem("中国"，5)；
box->addItem("美国"，6)；
box->addItem("英国"，7)；
int idx = box->findData(6);
box->setCurrentIndex(idx);

14、信号

        实际应用中，我们会需要根据下拉项的变化做一些联动或者数据上的改变，信号获取由文本变化currentTextChanged或者currentIndexChanged来相应处理，当你需要区分是否是用户主动选择改变则使用activated和textActivated。

信号： 
void activated(int index)                    //用户主动改变当前项触发
void textActivated(const QString &text)      //用户主动改变当前项触发
void currentTextChanged(const QString &text) //当前文本改变同步触发此信号
void currentIndexChanged(int index)          //当下标改变的时候此信号同步触发
void editTextChanged(const QString &text)    //编辑模式下内容改变触发
void highlighted(int index)                  //用户改变高亮项触发

四：QFontComboBox类

1、currentFont

        该属性控制当前显示的字体，返回QFont。当用户选择新的字体时，除了currentIndexChanged()之外，还会发出currentFontChanged()信号

QFont currentFont() const              //获取当前字体
void setCurrentFont(const QFont &f)    //设置当前字体

2、fontFilters

        该属性保存要过滤的字体，调用setFontFilters()来过滤掉某些不想要的字体。

QFontComboBox::FontFilters fontFilters() const
void setFontFilters(QFontComboBox::FontFilters filters)

• QFontComboBox::AllFonts                          显示所有字体
• QFontComboBox::ScalableFonts                显示可缩放字体
• QFontComboBox::NonScalableFonts         显示不可伸缩字体
• QFontComboBox::MonospacedFonts         显示等宽字体
• QFontComboBox::ProportionalFonts          显示比例字体

3、writingSystem

        该属性保存显示支持给定书写系统的字体。默认QFontDatabase:Any

QFontDatabase::WritingSystem writingSystem() const
void setWritingSystem(QFontDatabase::WritingSystem)

• QFontDatabase::Any
• QFontDatabase::Latin
• QFontDatabase::Greek
• QFontDatabase::Cyrillic
• QFontDatabase::Armenian
• QFontDatabase::Hebrew
• QFontDatabase::Arabic
• QFontDatabase::Syriac
• QFontDatabase::Thaana
• QFontDatabase::Devanagari
• QFontDatabase::Bengali
• QFontDatabase::Gurmukhi
• QFontDatabase::Gujarati
• QFontDatabase::Oriya
• QFontDatabase::Tamil
• QFontDatabase::Telugu
• QFontDatabase::Kannada
• QFontDatabase::Malayalam
• QFontDatabase::Sinhala
• QFontDatabase::Thai
• QFontDatabase::Lao
• QFontDatabase::Tibetan
• QFontDatabase::Myanmar
• QFontDatabase::Georgian
• QFontDatabase::Khmer
• QFontDatabase::SimplifiedChinese
• QFontDatabase::TraditionalChinese
• QFontDatabase::Japanese
• QFontDatabase::Korean
• QFontDatabase::Vietnamese
• QFontDatabase::Symbol
• QFontDatabase::OtherSymbol
• QFontDatabase::Ogham
• QFontDatabase::Runic
• QFontDatabase::Nko