Qt Notes

• PyQt5 Tutorial 2022, Create Python GUIs with Qt

  • 各种 PyQt, PySide, matplotlib 在 Qt 中实用等等

• 书籍

  • PySide6 book (5th Edition, 2022) Create GUI Applications with Python & Qt6 — …

• Model – View

  • Model/View Programming | Qt Widgets 5.15.5
  • 中文教程：Qt Model/View（模型/视图）结构（无师自通）

• 主要类

  • Model

    • 抽象基类 QAbstractItemModel

    • 实现类

      • QFileSystemModel

      • QStringListModel

        • string list 字符串列表

  • View

    • 抽象基类 QAbstractItemView

    • 实现类

      • QTableView

        • 即表格，类似 Excel
      • QListView

      • QHeaderView

        • table 和 tree 都有表头

  • Delegate

    • 抽象基类 QAbstractItemDelegate

    • 实现类

      • QStyledItemDelegate

        • 简单工具可以继承它，而不是 QAbstractItemDelegate

• 定位到帮助模式： Ctrl + 6
• 添加书签：Ctrl + M

• 索引搜索：Alt + L 进入搜索框

  • 进入索引模式：Alt + i (似乎不正确)

• 快捷键: Ctrl + K

• 查找方式：可以使用通配符*

  • 如：he*ui –> helloworld.ui

• 强制补全：Ctrl + <SPACE>

1. 创建空项目

   • Empty qmake project
   • .pro 文件添加：greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

2. 创建自定义 C++类

   • 添加文件

   • 选择 C++类，

     • 基类选择自定义<Custom>
     • 再选择或填写 QDialog
   • 类名：HelloDialog

3. 添加 main.cpp 源代码

   1 2 3 4 5 6 7 8 9

   #include <QApplication> #include "hellodialog.h" int main(int argc, char *argv[]) { QApplication a(argc, argv); HelloDialog w; w.show(); return a.exec(); }

4. 添加.ui 文件 helloworld.ui

5. 更改 C++类，HelloDialog

   • 不在使用 main.cpp 操纵.ui 文件
   • 在 HelloDialog 类中操纵.ui 文件

   • 如何操纵：

     • eg:

       1 2	Ui::Hellodialog *ui; ui->setupUi();

     • 在新 C++类中包含一个 Ui::HelloDialog 对象

   • C++类源码：

     • 头文件

       • eg: hellodialog.h

         1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

         #ifndef HELLODIALOG_H #define HELLODIALOG_H #include<QDialog> namespace Ui { class HelloDialog; } class HelloDialog: public QDialog { Q_Object public: explicit HelloDialog(QWidget* parent=0); ~HelloDialog(); private: Ui::HelloDialog *ui; } #endif

     • 新 C++类，实现文件 cpp

       • hellodialog.cpp

         1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

         #include "hellodialog.h" #include "ui_hellodialog.h" HelloDialog::HelloDialog(QWidget *parent) : QDialog(parent) { ui = new Ui::HelloDialog; ui->setupUi(this); } /* ,* 或者这样 HelloDialog::HelloDialog(QWidget *parent) : QDialog(parent), ui(new Ui::HelloDialog) { ui->setupUi(this); } ,*/

6. 编译运行

1. 创建空项目

   • Empty qmake project
   • .pro 文件添加：greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

2. 添加文件

   • 模板选择

     • Qt 设计师界面类，Qt designer form class
     • Dialog without buttons
   • 这样会同时添加一个 head file 头文件和一个 form 即.ui 文件
   • 相当于上面的自定义一个 C++类，再添加一个.ui 文件

3. 修改 main.cpp

   1 2 3 4 5 6 7 8 9

   #include <QApplication> #include "hellodialog.h" int main(int argc, char *argv[]) { QApplication a(argc, argv); HelloDialog w; w.show(); return a.exec(); }

1. hellodialog.ui

2. ui_hellodialog.h

   • class Ui_HelloDialog

     • 没有继承其他类

   • namespace Ui{ class HelloDialog: public Ui_HelloDialog; }

     1 2 3 4 5 6 7 8 9 10 11 12

     QT_BEGIN_NAMESPACE // begin class Ui_HelloDialog { }; //有分号 namespace Ui { class HelloDialog: public Ui_HelloDialog; //继承.ui文件中的自动生成类 } //没分号 QT_END_NAMESPACE //end **-->注意这一对宏

3. hellodialog.h

   • class HelloDialog: public QDialog{};
   • namespace Ui{class HelloDialog;}
   • 不包含#include"ui_hellodialog.h"

4. hellodialog.cpp

   • #include"ui_hellodialog.h"
   • #include"hellodialog.h"

• 使用 string = QObject::tr("your string text")

1. 模态对话框

   • 模态 Modal

   • 特点：

     • 不关闭该窗口，不能操作其他窗口

   • 实现方法

     • 调用对应的 app.exec()

       1 2	QDialog dialog(this); dialog.exec();

     • show()之前调用 setModal()

       1 2 3

       QDialog *dialog = new QDialog(this); dialog->setModal(true); dialog->show();

     • 使用 setWindowModality()

       • 方法来源：

         • 继承自 QWidget

       • 输入参数

         • Qt::NonModal（不阻塞任何窗口，就是非模态）
         • Qt::WindowModal（阻塞它的父窗口和所有祖先窗口以及它们的子窗口）
         • Qt::ApplicationModal（阻塞整个应用程序的所有窗口）
       • setModal()函数默认设置的是 Qt::ApplicationModal

   • 信号处理

     • 信号发出者

       • QDialog::accept(), QDialog::reject()

     • 信号传递者

       • QDialog::exec()

         • 返回类型

           • QDialog::QDialogCode 枚举型

             • 成员：

               • QDialog::Accepted
               • QDialog::Rejected

     • 运作方式

       • QDialog::accept() <—> 发出 QDialog::Accepted

         • Hides the modal dialog and sets the result code to Accepted

           • 隐藏模态 Qdialog，返回信号 QDialog::Accepted
         • 在模态的 dialog 中的槽中调用 accept(),
         • dialog->exec()返回 QDialog::Accepted

       • QDialog::reject() <—> 发出 QDialog::Rejected

         • 在模态的 dialog 中的槽中调用 reject()
         • dialog->exec()返回 QDialog::Rejected

2. 非模态对话框

   • 特点：

     • 开着它，也能操作别的窗口

   • 实现方法

     • 使用 show()函数来显示

       1 2	QDialog *dialog = new QDialog(this); dialog->show();

1. 颜色对话框 QColorDialog

   • 使用方式

     • 静态方法
     • 直接创建实例

   • 接口

     1 2 3 4 5 6 7 8 9 10

     getColor(default_color, parent, window_title, dialog_options) // QColor color = QColorDialog::getColor(Qt::red, this, tr("颜色对话框"), // QColorDialog::ShowAlphaChannel); QColorDialog dialog(Qt::red, this); // 创建对象 dialog.setOption(QColorDialog::ShowAlphaChannel); // 显示alpha选项 dialog.exec(); // 以模态方式运行对话框 QColor color = dialog.currentColor(); // 获取当前颜色 qDebug() << "color: " << color;

2. 文件对话框 QFileDialog

   • 接口

     1 2 3 4 5 6 7 8 9

     QString str= QFileDialog::getOpenFileName(parent,titleStr,str_directory,tr("Image (*.png *.jpg)")); // QString fileName = QFileDialog::getOpenFileName(this, tr("文件对话框"), // "D:", tr("图片文件(*png *jpg);;文本文件(*txt)")); // qDebug() << "fileName:" << fileName; QStringList fileNames = QFileDialog::getOpenFileNames(this, tr("文件对话框"), "D:", tr("图片文件(*png *jpg)")); qDebug()<< "fileNames:" << fileNames;

3. 字体对话框 QFontDialog

   1 2 3 4 5 6 7 8

   QFont font=QFontDialog::getFont(bool* ok, parent); // ok用于标记是否按下了“OK”按钮 bool ok; QFont font = QFontDialog::getFont(&ok, this); // 如果按下“OK”按钮，那么让“字体对话框”按钮使用新字体 // 如果按下“Cancel”按钮，那么输出信息 if (ok) ui->pushButton_3->setFont(font); else qDebug() << tr("没有选择字体！");

4. 输入对话框 QInputDialog

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

   bool ok; // 当用户在QInputDialog对话框中按下OK键时，把bool ok设成ok=true，否则是，false // 获取字符串 QString string = QInputDialog::getText(this, tr("输入字符串对话框"), tr("请输入用户名："), QLineEdit::Normal,tr("admin"), &ok); if(ok) qDebug() << "string:" << string; // 获取整数 int value1 = QInputDialog::getInt(this, tr("输入整数对话框"), tr("请输入-1000到1000之间的数值"), 100, -1000, 1000, 10, &ok); if(ok) qDebug() << "value1:" << value1; // 获取浮点数 double value2 = QInputDialog::getDouble(this, tr("输入浮点数对话框"), tr("请输入-1000到1000之间的数值"), 0.00, -1000, 1000, 2, &ok); if(ok) qDebug() << "value2:" << value2; QStringList items; items << tr("条目1") << tr("条目2"); // 获取条目 QString item = QInputDialog::getItem(this, tr("输入条目对话框"), tr("请选择或输入一个条目"), items, 0, true, &ok); if(ok) qDebug() << "item:" << item;

5. 消息对话框 QMessageBox

   • 接口,很多

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25

     int ret=QMessageBox::question(parent,title,label_str="你了解这个问题吗",buttons=MessageBox::Ok,default_button=MessageBox::Ok); information(parent,title,label_str,buttons,default_button); warning(parent,title,label_str,buttons=MessageBox::Abort,default_button); critical(parent,title,label_str,buttons=MessageBox::YesAll,default_button); about(parent,title,label_str); // 问题对话框 int ret1 = QMessageBox::question(this, tr("问题对话框"), tr("你了解Qt吗？"), QMessageBox::Yes, QMessageBox::No); if(ret1 == QMessageBox::Yes) qDebug() << tr("问题！"); // 提示对话框 int ret2 = QMessageBox::information(this, tr("提示对话框"), tr("这是Qt书籍！"), QMessageBox::Ok); if(ret2 == QMessageBox::Ok) qDebug() << tr("提示！"); // 警告对话框 int ret3 = QMessageBox::warning(this, tr("警告对话框"), tr("不能提前结束！"), QMessageBox::Abort); if(ret3 == QMessageBox::Abort) qDebug() << tr("警告！"); // 错误对话框 int ret4 = QMessageBox::critical(this, tr("严重错误对话框"), tr("发现一个严重错误！现在要关闭所有文件！"), QMessageBox::YesAll); if(ret4 == QMessageBox::YesAll) qDebug() << tr("错误"); // 关于对话框 QMessageBox::about(this, tr("关于对话框"), tr("yafeilinux致力于Qt及Qt Creator的普及工作！"));

   • 返回类型，枚举型，QMessageBox::StandardButton 类型

     • QMessageBox::Ok
     • QMessageBox::Cancel
     • QMessageBox::Close 等等

   • 关于 buttons 参数，default_buttons 参数

     • buttons：

       • 设置对话框会显示哪些按钮

     • default_buttons:

       • 设置默认会选择的按钮，必须是 buttons 中设定好的

6. 进度对话框 QProgressDialog

   • 构造

     1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

     QProgressDialog::QProgressDialog(const QString &labelText, const QString &cancelButtonText, int minimum, int maximum, QWidget *parent = nullptr, Qt::WindowFlags f = ...); QProgressDialog dialog(tr("文件复制进度"), tr("取消"), 0, 50000, this); dialog.setWindowTitle(tr("进度对话框")); // 设置窗口标题 dialog.setWindowModality(Qt::WindowModal); // 将对话框设置为模态 dialog.show(); for(int i=0; i<50000; i++) { // 演示复制进度 dialog.setValue(i); // 设置进度条的当前值 QCoreApplication::processEvents(); // 避免界面冻结 if(dialog.wasCanceled()) break; // 按下取消按钮则中断 } dialog.setValue(50000); // 这样才能显示100%，因为for循环中少加了一个数 qDebug() << tr("复制结束！");

   • 例子：

     1 2 3 4 5 6 7 8 9 10 11 12

     QProgressDialog progress("Copying files...", "Abort Copy", 0, numFiles, this); progress.setWindowModality(Qt::WindowModal); progress.show(); for (int i = 0; i < numFiles; i++) { progress.setValue(i); //进度当前值 if (progress.wasCanceled()) break; //... copy one file } progress.setValue(numFiles);//由for循环少加了1，这样才能显示100%

   • 重要函数与方法：

     • dialog->setValue(value)
     • dialog->wasCanceled()

     • QtCoreApplication::processEvents()

       • 防止冻结界面

7. 错误信息对话框 QErrerMessage

   1 2 3

   QErrorDialog errordlg= new QErrorDialog(); errordlg->setWindowTitle(tr("错误信息对话框")); errordlg->showMessage(tr("这里是出错信息！"));

8. 向导对话框 QWizard

   • 重要部分

     • 方法：wizard->addPage(QWizardPage* page)
     • 类型：QWizardPage

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

   QWizardPage * MyWidget::createPage1() // 向导页面1 { QWizardPage *page = new QWizardPage; page->setTitle(tr("介绍")); return page; } QWizardPage * MyWidget::createPage2() // 向导页面2 { QWizardPage *page = new QWizardPage; page->setTitle(tr("用户选择信息")); return page; } QWizardPage * MyWidget::createPage3() // 向导页面3 { QWizardPage *page = new QWizardPage; page->setTitle(tr("结束")); return page; } // 向导对话框 void MyWidget::on_pushButton_8_clicked() { QWizard wizard(this); wizard.setWindowTitle(tr("向导对话框")); wizard.addPage(createPage1()); // 添加向导页面 wizard.addPage(createPage2()); wizard.addPage(createPage3()); wizard.exec(); }

9. 注：以上这些对话框类，最好直接查询 Help Mode，static method，property

1. 共同方法：

   • setWindowTitle()

   • setOption(), setOptions()

     • 每种对话框，都定义了一些枚举型，以设置几个特定选项
     • 如：QColorDialog::QColorDialogOption 类型，QColorDialog::AlphaChanel
2. 模态

3. 对于需要显示文本信息的对话框

   • setText()

     • QMessageBox 输出文本
   • setLabel

   • setLabelText

     • QInputDialog
     • QProgressDialog

• 作用：

  • 存放.gif 文件

    1 2 3

    QMovie *movie = new QMovie("F:/donghua.gif"); ui->label->setMovie(movie); // 在标签中添加动画 movie->start();

• 作用：

  • 存放.png 文件

    1	ui->label->setPixmap(QPixmap("F:/logo.png"));

滚动条 QScrollBar 更多的是用在 QScrollArea 类中来实现滚动区域；

而 QSlider 是我们最常见的音量控制或多媒体播放进度等滑块；

是一个刻度表盘。

• 注意

  • 只需要声明即可

  • 定义

    • 由 moc 模块自动生成

• 定义

  1 2	public slots: void showChildDialog();

  • 要加上 slots

    • Qt5 中不加也可，但推荐加上
  • public 表示在类外部也可使用它

• QObject::sender()

  • 在 slot 函数中，获取当前 thread 内部的信号 signal 发送者
  • 注意： 不可是其它线程中的信号发送者

参考：

• QTimerEvent Class | Qt Core 6.3.0

特点：

• 每隔一个 interval 时间段就会发生

触发：

• QObject::startTimer(int interval) 启动

处理：

• QObject::timerEvent(QTimerEvent*) 接收处理

• 作用

  • 把 ui 文件转换城头文件

• 命令调用

  1	uic -o ui_hellodialog.h hellodialog.ui

• 方法：

  • 运算符

    • +，+=

  • 索引

    • at(index)

  • 查询

    • indexOf(str, from)

      • //返回找到 str 的 index, from 是开始寻找的位置, 返回-1 表示没找到

    • lastIndexOf(str, from)

      • //str 最后出现的位置

  • 各处插入

    • str.insert(index,str2)

      • str="zg";str.insert(1,"yl");//str==zylg

    • pend

      • str.append(str2)
      • str.prepend(str2)

    • push

      • str.push_back(str)
      • str.push_front(str)

  • 删除

    • remove(str, Qt::CaseInsensitive)//删除所有出现的 str
    • remove(index, len)//从 index 开始的 len 个

  • 清空

    • clear()

  • 格式化字符串

    • QString("%1 is %2").arg(value).arg(value)
    • str.sprintf("%s, %s", str2,str3)

  • 替换

    • str.replace(index,len,str2)
    • str.replace(QRexExp& rx, str2)
    • str.replace(QRegularExpression& re, str2)
  • 修剪

  • 作用于 str 本身

    • str.trimed()
    • str.simplified()//去掉空白，单个空白代替
    • str.truncate(len)//只留前面 len 个
    • str.chop(n)//去掉右边的 n 个

  • 返回新 QString，substring

    • str.left(n)//返回左边 n 个
    • str.right(n)
    • str.mid(index,len)//从 index 开始的 len 个
    • str.mid(index)//从 index 开始的剩余部分
    • str.chopped(len)//左边 len 个

  • 判断

    • str.startsWith("zy",Qt::CaseInsensitive);
    • str.endsWith("zy",Qt::CaseInsensitive);
    • str.contains("zy",Qt::CaseInsensitive);//return bool
    • str.isNull() –> QChar.isNull()
    • str.isEmpty()

  • 转换

    • str.toInt()

      • str="125"; long hex=str.toInt(&ok,16);//ok=true,hex=293

    • str.fill(char,n)//转换成 n 个 char

      • str.fill("A",2) //str="AA"

    • 数字变成 QString

      • str.setNum(int)//把 int 变成 QString,存入 str

      • QString::number(value) //返回字符串，静态方法

        • QString::number(int,int base=10)

          • QString s = QString::number(a, 16);// s == "3f"
        • QString::number(double)

  • 比较

    • str.compare(str_other, Qt::CaseInsensitive)

      • Qt::Sensitive
      • Qt::Sensitive

  • 切割 section

    • str.section(char_seperator, start_index, end_index)

      1 2 3 4 5 6 7

      QString csv = "forename,middlename,surname,phone"; QString path = "/usr/local/bin/myapp"; // First field is empty QString::SectionFlag flag = QString::SectionSkipEmpty; str = csv.section(',', 2, 2); // str == "surname" str = path.section('/', 3, 4); // str == "bin/myapp" str = path.section('/', 3, 3, flag); // str == "myapp"

  • 迭代器 QString::iterator 类型

    • begin()
    • end()//指向 index=size(),即最后一个元素的后面，越界一个元素
    • rbegin()//逆序第一个
    • rend()

    • cbegin()//对应常量指针类型，不可改变*cbegin(),

      • 返回类型 QString::const_iterator
    • cend()
    • constBegin()
    • constEnd()
    • crbegin()
    • crend()

  • 计数

    • count(char)
    • count(str)
    • count(QRegExp &rx)
    • count(QRegularExpression &re)

  • 标准 C 字符串

    • QChar* data()

  • 大小写

    • toUpper()
    • toLower()

• QDir 用来路径操纵
• QFile 用来 IO 读写

• 参考：QVariant Class | Qt Core 5.15.5

• 例子

  1 2	QStringList wordList; wordList << "Qt" << "Qt Creator" << tr("你好");

• 尺寸函数：

  • x()
  • y()
  • width()
  • height()

• 哪些是返回 QRect 类型的

  • geometry()
  • frameGeometry()

• 尺寸函数：只有宽和高

  • width()
  • height()

• 返回 QSize 类型的函数

  • size()

• 布局参考：QGroupBox使用总结_fanyun 的博客-CSDN博客_qgroupbox
• 带绘制出外边框和 Title 的分组容器

• 属性

  • name
  • title
  • font

  • checkable: bool

    • 提供一个 选择框

  • checked: bool

    • checked is True, 子部件才能被 enabled (accessible)
    • False, 子部件不能被访问

• 可以容纳多个 widget

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

  # pyqt5 groupBox = QGroupBox("Exclusive Radio Buttons") radio1 = QRadioButton("&Radio button 1") radio2 = QRadioButton("R&adio button 2") radio3 = QRadioButton("Ra&dio button 3") radio1.setChecked(True) vbox = QVBoxLayout() vbox.addWidget(radio1) vbox.addWidget(radio2) vbox.addWidget(radio3) vbox.addStretch(1)

• 作用

  • 给 子 Widget 添加滚动条

    • 当 容纳不下 内部子 Widget 时，显示滚动条

• 属性

  • name
  • font

• 函数

  • addWidget()
  • setBackgroundRole()

• 示例

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

  from xinet import QtWidgets, QtCore, QtGui from xinet.run_qt import run class ImageView(QtWidgets.QScrollArea): def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) # 载入图片 imageLabel = QtWidgets.QLabel(self) image = QtGui.QPixmap("test.jpg") imageLabel.setPixmap(image) # 设定滚动条组件 self.setBackgroundRole(QtGui.QPalette.Dark) self.setWidget(imageLabel) # 初始化设定 self.init_Ui() def init_Ui(self): # 修改窗口默认尺寸 self.resize(500, 500) if __name__ == '__main__': run(ImageView)

• 作用

  • 可隐藏式 多部件 分组

• 属性

  • name
  • font

  • currentIndex

    • 当前活动页

  • 活动标签

    • itemLabel
    • itemName
    • itemBackgroundModel

• 方法

  • addItem(QWidget, …)
  • count() const
  • currentIndex() const
  • currentItem() const
  • indexOf(QWidget)
  • insertItem(index, widget, …)
  • item(index)
  • setCurrentIndex
  • setCurrentItem
  • setItemLabel
• 效果示例：Qt学习10——工具盒类QToolBox_shawn06-CSDN博客_qtoolbox

• 解说：

  • 可包含多个子部件

  • 显示方式

    • 每一个子部件 –> 一个 按钮

      • 按钮展示

        • 按钮可以有：文字 + Icon

      • 主体内容暂时

        • 点击按钮实现
        • 隐藏 + 展示 两种状态

• 作用

  • 通过 tab 标签选择展示组合中的一个标签 Wiget

• 属性

  • name
  • currentPage
  • margin

  • tabShape

    • 标签 shape

  • 活动标签

    • pageName
    • pageTitle

• 函数

  • addTab(widget, …)
  • setMovable(bool)
  • setTabEnabled(index, bool)
  • QWidget* currentPage()
  • int currentPageIndex()

• 使用参考：Qt之QStackedWidget多界面切换_onehappycoder-CSDN博客_qstackedwidget

• 功能

  • 用于实现类似 ppt 幻灯片功能
  • 一次只显示一个子 widget

• 属性

  • name
  • font
  • currentPage
  • pageName

• 方法

  • addWidget
  • count() const
  • currentIndex() const
  • currentWidget() const
  • indexOf

• 槽函数

  • setCurrentIndex(int index)
  • setCurrentWidget(QWidget*)

• 功能

  • 基础分组部件

• 属性

  • name

  • framesShape

    • 边框形状

    • QFrame::Shape 枚举类型，形状

      • QFrame::NoFrame
      • QFrame::Box
      • Panel 平板 对阴影起衬托作用
      • WinPanel windows 风格 panel
      • HLine 水平线，用于分割，不框住任何东西
      • VLine 垂直线
      • StyledPanel 使用 QStyle::drawPannel

  • framesShadow

    • 边框阴影特性

    • QFrame::Shadow 阴影类型，枚举

      • QFrame::Plain 和周围一样高
      • QFrame::Raised 凸起
      • QFrame::Sunken 凹陷
      • QFrame::MShadow 内部的，对于阴影的掩码

• 功能

  • 基础类
  • 本身不可见
  • 可以包含子部件，删除 QWidget 时，子部件一起删除

• 属性

  • name
  • font
  • cursor 光标样式

• 方法

  • childAt(x, y, bool includeThis=False)

    • (x, y) 处的子部件

    • 重载

      • childAt(Point &p, bool includeThis=False)
  • drawText(x, y, const QString& str)

• 参考：QMdiArea Class | Qt Widgets 5.15.5
• 实现效果参考：Qt之容器控件（QMdiArea）_Shijia Yin-CSDN博客_qmdiarea

• MDI: multiple document interface 多文档界面，多文件参与的窗口

  • 对比 QMainWindow(SDI, single document interface) 单文件参与窗口

• 功能

  • 多文档处理
  • 内部多子窗口

• 属性

  • name
  • font

  • viewMode 视图模式

    • TabbedView 或 SubWindowView

  • documentMode

    • 保存的标签栏在选项卡视图模式是否设置为文件的模式，默认为 false

  • viewMode == TabbedView 时

    • tabShape
    • tabPosition

• 方法

  • addSubWindow(QWidget*, …)
  • removeSubWindow(QWidget*)
  • setBackground(QBrush(Q::green))
  • activeSubWindow() const
  • QMdiSubWindow* currentSubWindow()
  • setActiveSubWindow(QMdiSubWindow*)

• 槽

  • 切换窗口

    • activateNextSubWindow()
    • activatePreviousSubWindow()
    • setActiveWindow(QWidget*)

  • 排布窗口

    • cascadeSubWindows()
    • tileSubWoindows

  • 关闭

    • closeActiveSubWindow()
    • closeAllSubWindows()

• 信号

  • subWindowActivated(QMdiSubWindow *window)

• 使用参考：QDockWidget详解_chenlong12580 的专栏-CSDN博客_qdockwidget
• 效果：QDockWidget嵌套布局详解

• 功能

  • 停靠窗体

• 属性

  • name
  • font

  • floating

    • 是否可以 float

  • feature

    • 参考：QDockWidget 停靠特征解说 | Qt Widgets 5.15.5

    • QDockWidget::DockWidgetFeatures 枚举类型，停靠特征

      • QDockWidget::DockWidgetClosable
      • QDockWidget::DockWidgetMovable
      • QDockWidget::DockWidgetFloatable
      • QDockWidget::DockWidgetVerticalTitleBar
      • QDockWidget::AllDockWidgetFeatures
      • QDockWidget::NoDockWidgetFeatures

  • allowedArea

    • 可停靠区域

    • 枚举类型 Qt::DockWidgetArea

      • Qt::LeftDockWidgetArea 左
      • Qt::RightDockWidgetArea 右
      • Qt::TopDockWidgetArea 上
      • Qt::BottomDockWidgetAreas 下
      • Qt::AllDockWidgetArea (默认值)所有四个区域
      • Qt::NoDockWidgetArea 不可停靠

  • windowTitle

    • 停靠窗体 title

  • dockWidgetArea (Qt 官方没有)

    • 停靠的区域

  • docked (Qt 官方没有)

    • 停靠状态

• 函数

  • setWidget(QWidget*) 设置内部子部件
  • setFeatures(features)
  • setFloating(bool)

  • setTitleBarWidget(QWidget*)

    • 自定义标题栏 Widget
    • 设置 nullptr, 恢复默认样式

• 作用：

  • Button 类的抽象基类，提供按钮的通用功能

• 要点功能

  • 选择
  • 滚动
  • 拖拽

  • 显示和编辑

    • setItemDelegate()
  • model 操作

• 继承

  • 继承子类只要实现特定功能相关相关功能方法即可

• 属性

  • 滚动

    • autoScroll: bool
    • autoScrollMargin: int

  • 拖动

    • dragEnabled: bool
    • dragDropMode

  • 编辑

    • editTriggers: QAbstractItemView::editTriggers

      • 哪些类型按键会激发编辑功能

• 方法

  • index

    • rootIndex()
    • currentIndex()

• 功能

  • 展示 文字列表 或 Icon 列表

• 子类

  • QListWidget

    • QListView 需要自己创建设置 Model
    • QListWidget 内建 Model，用户 addItem()即可

• 连接：

  • QtCore.SINGAL
  • QtCore.SLOT
  • QtCore.QObject.connect

• 定义

  • 装饰器声明重载函数接口
  • QtCore.Signal
  • QtCore.Slot

• hotSpot()

  • 拖拽时，背景图片 pixel_map 左上角相对光标的偏离位置

注意：

• 需要额外安装

  • pip install pyqt6-tools

• 调用方式

  1 2 3 4 5

  # qt designer pyqt6-tools designer # qt uic pyuic6

参考： Create your first PySide app in Qt Designer

1. python 代码

   • 解决方法：使用 pythonw.exe
   • eg: 使用 pythonw.exe main.py

2. pyinstaller + qt 代码

   • 参考：

     • Using PyInstaller — PyInstaller 5.4.1 documentation

       • -w
       • –windowed
       • –noconsole

   • 解决方法：

     • 使用 -w 等命令行参数
     • 把 main.py 改成 main.pyw 在运行 pyinstaller