Qt控件使用方法技巧合集

Love The Way You Lie 2022-12-07 15:04 669阅读 0赞

# Qt控件使用方法技巧合集 #

--------------------

~~~~~~~~         本篇博客代码示例包含C++版本和Python版本，不管是哪个版本，Qt的API都是一样的，使用方式大同小异。

--------------------

### 文章目录 ###

*  Qt控件使用方法技巧合集
 *   *   *   *  1、QTextEdit设置背景色和文本颜色
             *  2、QMessageBox的使用
             *  3、QComboBox点击事件更新列表
             *  4、QTabelView的使用
             *  5、Qt关于QDialog右上角显示？按钮不显示最大化、最小化按钮问题
             *  6、配置文件QSettings的使用
             *  7、获取各种路径
             *  8、QLineEdit
             *  9、Qt字符串QStrings类使用详解
             *  10、调试打印输出QDebug使用详解
             *  11、调起窗口的QFileDialog类使用详解
             *  12、文件读写QFile使用详解
             *  13、打开指定路径并选中指定文件

--------------------

#### 1、QTextEdit设置背景色和文本颜色 ####

// 设置QTextEdit背景和字体颜色
        QPalette pl = ui->textEdit->palette();     // 获取textEdit的调色板
        pl.setColor(QPalette::Base, Qt::black);    // 设置背景色为黑色
        pl.setColor(QPalette::Text, Qt::green);    // 设置文本颜色为绿色
        ui->textEdit->setPalette(pl);              // 设置回调色板

#### 2、QMessageBox的使用 ####

QMessageBox自定义了几个常用的消息框，常用的如下两个：

**1、警告消息窗**

*python:*

QMessageBox.warning(self.__MainWindow, '标题', '我是文本', QMessageBox.Close)

*C++：*

QMessageBox::warning(this, '标题', '我是文本', QMessageBox.Close)

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70]  
**2、信息提示消息窗**

*python:*

QMessageBox.information(self.__MainWindow, '标题', '我是文本', QMessageBox.Close)

*C++：*

QMessageBox::information(this, '标题', '我是文本', QMessageBox.Close)

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 1]  
**3、错误提示消息窗**

QMessageBox::critical(this, "错误提示", "串口打开失败！\r\n请检查该端口是否存在或被占用！", "关闭");

![在这里插入图片描述][202009161651593.png_pic_center]

**4、自定义一个消息窗**

*python:*

# 创建一个消息窗
            mb = QMessageBox(self.__MainWindow)
    
            # 设置标题
            mb.setWindowTitle('标题')
    
            # 设置显示内容
            mb.setText('测试QMessageBox')
    
            # 添加关闭按钮
            mb.addButton(QPushButton('关闭', mb), QMessageBox.RejectRole)
    
            # 显示消息窗
            mb.show()

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 2]

#### 3、QComboBox点击事件更新列表 ####

实现方法：继承QComboBox，重载showPopup函数。

Python代码：

from PyQt5.Qt import *
    
    
    class QSerialComboBox(QComboBox):
    
        def __init__(self, parent=None):
            super().__init__(parent)
    
        def showPopup(self):
            name = self.currentText()
            self.clear()
            serials = QSerialPortInfo.availablePorts()
            for com in serials:
                self.addItem(com.portName() + ' ' + com.description())
            super().showPopup()
            index = self.findText(name)
            if index >= 0:
                self.setCurrentIndex(index)

C++代码：

#include "qserialcombobox.h"
    #include <QSerialPortInfo>
    
    QSerialComboBox::QSerialComboBox(QWidget *parent) : QComboBox(parent)
    { 
    
    }
    
    void QSerialComboBox::showPopup()
    { 
        int index = 0;
        QString currText = currentText();
    
        // 清除显示
        clear();
    
        // 扫描显示可用串口列表
        QList<QSerialPortInfo> serials = QSerialPortInfo::availablePorts();
        foreach (QSerialPortInfo info, serials) { 
            addItem(info.portName() + " " + info.description());
        }
    
        // 定位显示项
        index = findText(currText);
        if(index < 0)
        { 
            index = 0;
        }
        setCurrentIndex(index);
    
        // 调用父类显示列表
        QComboBox::showPopup();
    }

![如果是PyQt，将.ui文件转为py文件后，在该python文件中找到QComboBox进行替换：][PyQt_.ui_py_python_QComboBox]

#### 4、QTabelView的使用 ####

**1、设置模型显示**

# 创建3X3模型,如果不指定表格大小，那么他会根据标签的数量自行定义表格大小
            model = QStandardItemModel(3, 3, self.__MainWindow)
            # 设置行标签
            model.setHorizontalHeaderLabels(['编号', '姓名', '年龄'])
            # 设置列标签
            model.setVerticalHeaderLabels(['一班', '二班', '三班'])
            # 设置到TabelView上
            self.tableView.setModel(model)

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 3]

**2、设置内容显示**

data = ['1', '2', '3']
            for i in range(len(data)):
                item = QStandardItem(data[i])
                # 设置内容对齐方式为：水平中心对齐+垂直中心对齐
                item.setTextAlignment(Qt.AlignHCenter | Qt.AlignVCenter)
                model.setItem(i, i, item)

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 4]

**3、设置表格之间根据间距调整宽度方式**  
一共5种显示模式：

*  Custom
 *  Fixed
 *  Interactive
 *  ResizeToContents
 *  Stretch

常用的是根据内容自动调整大小和拉伸

**设置方法：**

# 设置水平标签重载大小模式为拉伸，也就是铺满整个框，每一列间距是一样的，这样比较好看
    self.tableView.horizontalHeader().setSectionResizeMode(QHeaderView.Stretch)

#### 5、Qt关于QDialog右上角显示？按钮不显示最大化、最小化按钮问题 ####

QDialog默认设置是右上角只显示一个问号按钮和一个关闭窗口按钮，最大化、最小化按钮需要自己设置，下面以Python代码为例，C++代码步骤也是一样的：

# 创建窗体
            self.__MainWindow = QDialog()
            # 添加标记
            winflags = Qt.Dialog
            # 添加最小化按钮
            winflags |= Qt.WindowMinimizeButtonHint
            # 添加最大化按钮
            winflags |= Qt.WindowMaximizeButtonHint
            # 添加关闭按钮
            winflags |= Qt.WindowCloseButtonHint
            # 设置到窗体上
            self.__MainWindow.setWindowFlags(winflags)

#### 6、配置文件QSettings的使用 ####

在主窗口的构造函数中创建配置文件：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70_pic_center]

加载配置文件并设置到UI界面上显示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70_pic_center 1]  
退出主窗体的时候保存配置文件：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70_pic_center 2]

如果使用PyQt，析构函数是`__del__`，当窗口退出时，由于界面已经被销毁，如果在析构函数中进行保存设置，那么是不成功的，所以采取重新实现`closeEvent`方法即可，如下：

主窗体的构造函数进行初始化：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 5]  
覆写`closeEvent`函数用于保存设置：

def closeEvent(self, event):
            settings = QSettings('config.ini', QSettings.IniFormat)
            settings.setValue('id', self.__ui.leId.text())
            settings.setValue('name', self.__ui.leName.text())
            settings.setValue('comname', self.__ui.cmbSerialList.currentText())

#### 7、获取各种路径 ####

获取exe应用程序路径：

QString dir = QCoreApplication::applicationDirPath();

获取当前工作目录：

QString dir = QDir::currentPath();

#### 8、QLineEdit ####

1、限制只能输入数字和字母

QRegExp regx("[a-zA-Z0-9]+$");
    QValidator *validator = new QRegExpValidator(regx, lined);
    lined->setValidator(validator);

2、显示最大输入长度为10：

lined->setMaxLength(10);

注意：这个输入长度只是限制的字符个数，例如10就是限制输出10个汉字或者10个ASCII字符，或者混合。

3、设置占位符文本

ui->lineEdit->setPlaceholderText(tr("请在此处输入文本"));

#### 9、Qt字符串QStrings类使用详解 ####

QString的使用是比较简单的，这里只讲格式化操作的API。

格式化函数`arg`示例：

QString str(tr("%1 %2 %3 %4").arg(1).arg("hello").arg(3).arg("world"));
        qDebug() << str;  // 这里输出："1 hello 3 world"

使用`%N`的方式确定是哪一个参数，arg最大只能支持10个。

还有一个是静态函数：`QString::asprintf()`，这个函数跟C语言的sprintf函数是一样的。

#### 10、调试打印输出QDebug使用详解 ####

使用qDebug可以将调试信息输出到控制台上，该函数使用方式有两种：

1.  将字符串参数给qDebug，例如`qDebug("test");`，这种使用方法可以不用添加头文件`#include<QDebug>`，并且这种使用方式是支持格式化打印的，例如：`qDebug("count = %d", count);`，这种使用方式类似C语言的printf。
2.  使用流式输出多字符串，例如`qDebug() << "test" << "time";`，这种使用方式需要添加头文件`#include<QDebug>`

补充：当使用release进行最终打包发布时，如果想要显示控制台输出，可以在.pro文件中添加一行`CONFIG += console`，然后在这里勾选`Run in terminal`：  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 6][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 7][]

#### 11、调起窗口的QFileDialog类使用详解 ####

该类的静态函数如下：  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 8][]  
比较常用的三个：

*  getOpenFileName：获得打开的文件名
 *  getOpenFileNames：获得多选打开的文件名
 *  getSaveFileName：获得保存文件名

#### 12、文件读写QFile使用详解 ####

1、文本读写

int main(int argc, char *argv[])
    { 
        QCoreApplication a(argc, argv);
    
        QFile file("D:/test.txt");
        if(!file.isOpen())
        { 
            if(!file.open(QFile::ReadWrite))
            { 
                return a.exec();
            }
        }
    
        file.write("hellworld");
    
        file.seek(0);
    
        QByteArray data = file.readAll();
    
        qDebug() << data;
    
        return a.exec();
    }

2、二进制文件读写

读写二进制文件需要用到QDataStream，示例代码如下：

int main(int argc, char *argv[])
    { 
        QCoreApplication a(argc, argv);
    
        QFile file("D:/test.bin");
        if(!file.isOpen())
        { 
            if(!file.open(QFile::ReadWrite))
            { 
                qDebug() << "文件打开失败！";
                return a.exec();
            }
        }
    
        char buf[] = { 0X61,0X62,0X63,0X64};
        char readbuf[10];
    
        QDataStream ds(&file);
    
        ds.writeRawData(buf, sizeof(buf));
    
        file.flush();  // 执行此句才会真正的写入
    
        file.seek(0);
    
        memset(readbuf, 0X00, sizeof(readbuf));
    
        int nread = ds.readRawData(readbuf, sizeof(readbuf));
    
        if(nread > 0)    // 读取成功
        { 
            qDebug() << "实际读取到"
                     << nread
                     << "个字节"
                     << readbuf;
        }else if(nread == 0)
        { 
            qDebug() << "未读取到有效内容！";
        }else
        { 
            qDebug() << "读取失败！";
        }
    
        file.close();  // 关闭文件中包含了file.flush()
    
        return a.exec();
    }

#### 13、打开指定路径并选中指定文件 ####

示例代码：

QString filename = QCoreApplication::applicationFilePath();
    QProcess process(this);
    QString cmd(tr("explorer /select, \"%1\"").arg(filename.replace("/", "\\")));
    process.startDetached(cmd);

代码解释：`explorer /select [文件名]`这一句是windows的命令行，意思是启动资源管理器并选中文件，这里我们利用QPocess类去执行这一条命令就是实现打开该文件目录并选中。

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70]: /images/20221123/76a03509ccfe4e8a94e6ada7d0a5cdfe.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 1]: /images/20221123/0f84005789e046b8a0e46ad0b6499878.png
[202009161651593.png_pic_center]: /images/20221123/6624de1bea814b199ecea3cf953ecf5a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 2]: /images/20221123/b3ae9f1713e24f12be9481994a5b69f1.png
[PyQt_.ui_py_python_QComboBox]: /images/20221123/07305d1e7dc54ea69d60b9d754910f47.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 3]: /images/20221123/4facb6e4b0f64d5d8d5440414a3b292a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 4]: /images/20221123/a7a26aacf9cc4a68a7d31f145a483ba6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70_pic_center]: /images/20221123/101d1ffe477848998b1b00681c4f2f7d.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221123/e50860228f1b42e5a05370a261e71a24.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221123/1e4ee0b4f1944b8ca6ddafb954e11a58.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 5]: /images/20221123/dd22f6de30e1424eb3dc5a4f908b3d47.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 6]: /images/20221123/c754c1c4684b45aca05b8fefbab96bce.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 7]: /images/20221123/f5fa116c36114b1fad8c15aeee0277a5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxMTUzNDcxNTAz_size_16_color_FFFFFF_t_70 8]: /images/20221123/ccacf89a420f4063beca9d2b73e35468.png