PinkDopeyBug

外观

9 Widget窗体

约 6455 字大约 22 分钟

2025-06-22

Qt中常用的窗口类, 主要内容包括: 窗口类的基类QWidget, 对话框基类QDialog, 带菜单栏工具栏状态栏的QMainWindow, 消息对话框QMessageBox, 文件对话框QFileDialog, 字体对话框QFontDialog, 颜色对话框QColorDialog, 输入型对话框QInputDialog, 进度条对话框QProgressDialog, 资源文件。

setAttribute(Qt::WA_DeleteOnClose) 虽然qt有对象树机制可以帮助我们进行内存回收,但假设用户在操作页面时在一个父窗口中一直创建子窗口并关闭,但由于父窗口没有关闭,所以子窗口的内存也没有释放,可以调用setAttribute 对窗口进行设置在窗口关闭时就释放, 其参数对应的枚举值还有很多

QWidget

QWidget类是所有窗口类的父类(控件类是也属于窗口类), 并且QWidget类的父类的QObject, 也就意味着所有的窗口类对象只要指定了父对象, 都可以实现内存资源的自动回收。 下面来介绍这个类常用的一些API函数。

QWidget是所有界面组件类的直接或间接父类。 widget组件：所有界面组件的统称，它从操作系统接收鼠标、键盘和其他事件，并在屏幕上显示自己。每个组件都是矩形的，并且按z轴顺序排列（类似图层）。

window:没有嵌入到父组件中的组件。通常，它有一个frame和一个标题栏，可以使用window flags 创建没有这两个装饰的窗口。在Qt中，QMainWindow和QDialog的各种子类是最常见的window类型。

设置父对象

// 构造函数
QWidget::QWidget(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags());

// 公共成员函数
// 给当前窗口设置父对象
void QWidget::setParent(QWidget *parent);
//设置父对象时改变窗口属性
void QWidget::setParent(QWidget *parent, Qt::WindowFlags f);
// 获取当前窗口的父对象, 没有父对象返回 nullptr
QWidget *QWidget::parentWidget() const;

窗口位置

//------------- 窗口位置 -------------
// 得到相对于当前窗口父窗口的几何信息, 边框也被计算在内
QRect QWidget::frameGeometry() const;
// 得到相对于当前窗口父窗口的几何信息, 不包括边框
const QRect &geometry() const;
// 设置当前窗口的几何信息(位置和尺寸信息), 不包括边框
//x和y就是两个坐标组合就是QPoint，w和h就是宽度和高度两者组合就是QSize。QPoint和QSize组合就是QRect
void setGeometry(int x, int y, int w, int h);
void setGeometry(const QRect &);
    
// 移动窗口, 重新设置窗口的位置
void move(int x, int y);
void move(const QPoint &);

示例：

窗口尺寸

窗口标题和图标

//------------- 窗口图标 -------------
// 得到当前窗口的图标
QIcon windowIcon() const;
// 构造图标对象, 参数为图片的路径
QIcon::QIcon(const QString &fileName);
// 设置当前窗口的图标
void setWindowIcon(const QIcon &icon);

//------------- 窗口标题 -------------
// 得到当前窗口的标题
QString windowTitle() const;
// 设置当前窗口的标题
void setWindowTitle(const QString &);

信号

// QWidget::setContextMenuPolicy(Qt::ContextMenuPolicy policy);
// 窗口的右键菜单策略 contextMenuPolicy() 参数设置为 Qt::CustomContextMenu, 按下鼠标右键发射该信号
[signal] void QWidget::customContextMenuRequested(const QPoint &pos);
// 窗口图标发生变化, 发射此信号
[signal] void QWidget::windowIconChanged(const QIcon &icon);
// 窗口标题发生变化, 发射此信号
[signal] void QWidget::windowTitleChanged(const QString &title);

槽函数

窗口显示

QMenu

可配合QWidget的[signal] void QWidget::customContextMenuRequested(const QPoint &pos);方法生成右键菜单项，也可以创建菜单

//往菜单栏内添加选项，名称为QString类型的name
QAction* addAction(const QString &text);
//对于右键菜单选项常用带参的exec跟踪光标的位置在光标的位置生成菜单
QAction* exec(const QPoint &p,QAction *action=nullptr);

QDialog

对话框分为模态和非模态 在模态对话框中对话框存在时无法与其他窗口操作,非模态对话框可以与其他窗口操作 常用exec使QDialog作为模态对话框展示出来（即焦点在QDialog对话框上面），当模态对话框执行中时焦点不可转移到其他对话框，除非关闭模态对话框 常用show函数使窗口以非模态形式展示出来 accept()和reject()会隐藏模态窗口，并分别发射accepted()和rejected()的信号， 对话框类是QWidget类的子类, 处理继承自父类的属性之外, 还有一些自己所特有的属性, 常用的一些API函数如下：

常用使用方法

[!example] 场景介绍

  1. 有两个窗口, 主窗口和一个对话框子窗口
  2. 对话框窗口先显示, 根据用户操作选择是否显示主窗口

关于对话框窗口类的操作

// 对话框窗口中三个普通按钮按下之后对应的槽函数
void MyDialog::on_acceptBtn_clicked(){
    this->accept();  // exec()函数返回值为QDialog::Accepted
}

void MyDialog::on_rejectBtn_clicked(){
    this->reject();  // exec()函数返回值为QDialog::Rejected
}

void MyDialog::on_donBtn_clicked(){
    // exec()函数返回值为 done() 的参数, 并根据参数发射出对应的信号
    this->done(666);   
}

根据用户针对对话框窗口的按钮操作, 进行相应的逻辑处理。

QDialog的子类

QMessageBox

QMessageBox 对话框类是 QDialog 类的子类, 通过这个类可以显示一些简单的提示框, 用于展示警告、错误、问题等信息。关于这个类我们只需要掌握一些静态方法的使用就可以了。 API - 静态函数

其中还有enum QMessageBox::StandardButtons枚举值，有很多对话框中显示的选项

QFileDialog

QFileDialog 对话框类是 QDialog 类的子类, 通过这个类可以选择要打开/保存的文件或者目录。关于这个类我们只需要掌握一些静态方法的使用就可以了。

QFontDialog

QFontDialog类是QDialog的子类, 通过这个类我们可以得到一个进行字体属性设置的对话框窗口, 和前边介绍的对话框类一样, 我们只需要调用这个类的静态成员函数就可以得到想要的窗口了。

QFont 字体类

关于字体的属性信息, 在QT框架中被封装到了一个叫QFont的类中, 下边为大家介绍一下这个类的API, 了解一下关于这个类的使用。

QFontDialog类的静态API

/*
参数:
  - ok: 传出参数, 用于判断是否获得了有效字体信息, 指定一个布尔类型变量地址
  - initial: 字体对话框中默认选中并显示该字体信息, 用于对话框的初始化
  - parent: 字体对话框窗口的父对象
  - title: 字体对话框的窗口标题
  - options: 字体对话框选项, 使用默认属性即可, 一般不设置
*/
  [static] QFont QFontDialog::getFont(
		bool *ok, const QFont &initial, 
		QWidget *parent = nullptr, const QString &title = QString(), 
		QFontDialog::FontDialogOptions options = FontDialogOptions());
  
  [static] QFont QFontDialog::getFont(bool *ok, QWidget *parent = nullptr);

示例：

QWidget窗口字体设置

//得到当前窗口使用的字体
const QWidget::QFont& font()const;
//给当前窗口设置字体（只对当前窗口生效）
void QWidget::setFont(const QFont&);

QApplication类字体设置

//得到当前应用程序对象使用的字体
[static] QFont QApplication::font();
//给当前应用程序对象设置字体，作用于当前应用程序的所有窗口
[static] void QApplication::setFont(const& font,const char* className=nullptr);

QColorDialog

QColorDialog类是QDialog的子类, 通过这个类我们可以得到一个选择颜色的对话框窗口, 和前边介绍的对话框类一样, 我们只需要调用这个类的静态成员函数就可以得到想要的窗口了。

QColor颜色类

关于颜色的属性信息, 在QT框架中被封装到了一个叫QColor的类中, 下边为大家介绍一下这个类的API, 了解一下关于这个类的使用。 各种颜色都是基于红, 绿, 蓝这三种颜色调配而成的, 并且颜色还可以进行透明度设置, 默认是不透明的。

QColorDialog静态API函数

  // 弹出颜色选择对话框, 并返回选中的颜色信息
/*
参数:
    - initial: 对话框中默认选中的颜色, 用于窗口初始化
    - parent: 给对话框窗口指定父对象
    - title: 对话框窗口的标题
    - options: 颜色对话框窗口选项, 使用默认属性即可, 一般不需要设置
*/
  [static] QColor QColorDialog::getColor(
		const QColor &initial = Qt::white, 
		QWidget *parent = nullptr, const QString &title = QString(), 
		QColorDialog::ColorDialogOptions options = ColorDialogOptions());

QInputDialog

QInputDialog类是QDialog的子类, 通过这个类我们可以得到一个输入对话框窗口, 根据实际需求我们可以在这个输入窗口中输入整形, 浮点型, 字符串类型的数据, 并且还可以显示下拉菜单供使用者选择。

API - 静态函数

QProgressDialog进度条对话框

QProgressDialog类是QDialog的子类, 通过这个类我们可以得到一个带进度条的对话框窗口, 这种类型的对话框窗口一般常用于文件拷贝、数据传输等实时交互的场景中。

常用API

QMainWindow

QMainWindow是标准基础窗口中结构最复杂的窗口, 其组成如下:

  • 提供了菜单栏, 工具栏, 状态栏, 停靠窗口
  • 菜单栏：只能有一个, 位于窗口的最上方
  • 工具栏：可以有多个, 默认提供了一个, 窗口的上下左右都可以停靠
  • 状态栏：只能有一个, 位于窗口最下方
  • 停靠窗口（浮动窗口）： 可以有多个, 默认没有提供, 窗口的上下左右都可以停靠

菜单栏

关于顶级菜单可以直接在UI窗口中双击, 直接输入文本信息即可, 对应子菜单项也可以通过先双击在输入的方式完成添加, 但是这种方式不支持中文的输入。

一般情况下, 我们都是先在外面创建出QAction对象, 然后再将其拖拽到某个菜单下边, 这样子菜单项的添加就完成了。

// 给菜单栏添加菜单
QAction *QMenuBar::addMenu(QMenu *menu);
QMenu *QMenuBar::addMenu(const QString &title);
QMenu *QMenuBar::addMenu(const QIcon &icon, const QString &title);

// 给菜单对象添加菜单项(QAction)
QAction *QMenu::addAction(const QString &text);
QAction *QMenu::addAction(const QIcon &icon, const QString &text);

// 添加分割线
QAction *QMenu::addSeparator();

// 点击QAction对象发出该信号
[signal] void QAction::triggered(bool checked = false);

工具栏

添加工具按钮 方式1：先创建QAction对象, 然后拖拽到工具栏中, 和添加菜单项的方式相同 方式2：如果不通过UI界面直接操作，那么就需要调用相关的API函数了

状态栏

一般情况下, 需要在状态栏中添加某些控件, 显示某些属性, 使用最多的就是添加标签 QLabel

// 类型: QStatusBar
void QStatusBar::addWidget(QWidget *widget, int stretch = 0);

[slot] void QStatusBar::clearMessage();
[slot] void QStatusBar::showMessage(const QString &message, int timeout = 0);

停靠窗口

停靠窗口可以通过鼠标拖动停靠到窗口的上、下、左、右，或者浮动在窗口上方。如果需要这种类型的窗口必须手动添加，如果在非QMainWindow类型的窗口中添加了停靠窗口, 那么这个窗口是不能移动和浮动的。 浮动窗口在工具栏中， 直接将其拖拽到UI界面上即可。 停靠窗口也有一个属性面板, 我们可以在其对应属性面板中直接进行设置和修改相关属性。

贡献者

pinkdopeybug

版权归属：PinkDopeyBug

许可证：署名 4.0 国际 (CC-BY-4.0)

公告

本博客内容原本使用obsidian编写，由于没有仔细配置，以至图片引用使用obsidian风格。

且图片存储路径频繁变更导致部分文章图片无法正常显示。

为您带来不便请谅解。

ps：贡献者一直都只有PinkDopeyBug一人，显示Pink的贡献者是因为我没好好配置git。后面因为懒就没一个个修改。如果被提及的人不希望被显示可以联系我我会立即删除。