第四章 QT窗口

Irissgwe2026-07-04 19:50

文章目录

  • [第四章 Qt窗口](#第四章 Qt窗口)
    • [1. 菜单栏](#1. 菜单栏)
    • [2. 工具栏](#2. 工具栏)
      • [2.1 创建工具栏](#2.1 创建工具栏)
      • [2.2 设置停靠位置](#2.2 设置停靠位置)
      • [2.3 设置浮动属性](#2.3 设置浮动属性)
      • [2.4 设置移动属性](#2.4 设置移动属性)
      • [2.5 综合示例](#2.5 综合示例)
    • [3. 状态栏](#3. 状态栏)
      • [3.1 状态栏的创建](#3.1 状态栏的创建)
      • [3.2 在状态栏中显示实时消息](#3.2 在状态栏中显示实时消息)
      • [3.3 在状态栏中显示永久消息](#3.3 在状态栏中显示永久消息)
    • [4. 浮动窗口](#4. 浮动窗口)
      • [4.1 浮动窗口的创建](#4.1 浮动窗口的创建)
      • [4.2 设置停靠的位置](#4.2 设置停靠的位置)
    • [5. 对话框](#5. 对话框)
      • [5.1 对话框介绍](#5.1 对话框介绍)
      • [5.2 对话框的分类](#5.2 对话框的分类)
      • [5.2.1 模态对话框](#5.2.1 模态对话框)
      • [1、新建Qt项目,在ui文件中的菜单栏中设置两个菜单: "文件" 和 "编辑" ,在菜单 "文件" 下新建](#1、新建Qt项目,在ui文件中的菜单栏中设置两个菜单: "文件" 和 "编辑" ,在菜单 "文件" 下新建)
      • [5.2.2 非模态对话框](#5.2.2 非模态对话框)
      • [5.2.3 混合属性对话框](#5.2.3 混合属性对话框)
      • [5.3 Qt内置对话框](#5.3 Qt内置对话框)
      • [5.3.1 消息对话框QMessageBox](#5.3.1 消息对话框QMessageBox)
      • [5.3.2 颜色对话框QColorDialog](#5.3.2 颜色对话框QColorDialog)
      • [5.3.3 文件对话框QFileDialog](#5.3.3 文件对话框QFileDialog)
      • 1、打开文件(一次只能打开一个文件)
      • 2、打开多个文件(一次可以打开多个文件)
      • 3、保存文件
      • [5.3.4 字体对话框QFontDialog](#5.3.4 字体对话框QFontDialog)
      • [5.3.5 输入对话框QInputDialog](#5.3.5 输入对话框QInputDialog)
      • 1、双精度浮点型输入数据对话框
      • 2、整型输入数据对话框
      • 3、选择条目型输入数据框

第四章 Qt窗口

Qt窗口是通过 QMainWindow类来实现的。

QMainWindow 是一个为用戶提供主窗口程序的类,继承自 QWidget 类,并且提供了一个预定义的布局。 QMainWindow 包含 一个菜单栏(menubar) 、 多个工具栏(toolbars) 、 多个浮动窗口(铆接部件)(dockwidgets) 、 一个状态栏(statusbar) 和一个 中心部件(centralwidget) ,它是许多应用程序的基础,如文本编辑器,图片编辑器等。如下图为 QMainwindow 中各组件所处的位置:

1. 菜单栏

Qt中的 菜单栏 是通过 QMenuBar 这个类来实现的。 一个主窗口最多只有一个菜单栏 。位于主窗口顶部、主窗口标题栏下面。

菜单栏中包含菜单.菜单中包含菜单项.

1.1 创建菜单栏

方式一: 菜单栏的创建可以借助于 QMainWindow类 提供的 menuBar()函数 来实现。menubar()函数原型如下:

QMenuBar*menuBar()const

方式二: 在堆上动态创建;

使用 setMenuBar 把菜单栏放到窗口中.

1.2 在菜单栏中添加菜单

创建菜单,并通过 QMenu 提供的 addMenu() 函数来添加菜单 。

示例:

1.3 创建菜单项

在Qt中,并没有专门的菜单项类,可以通过 QAction 类,抽象出公共的动作。如在菜单中添加菜单项.

QAction可以给菜单栏使用,也可以给工具栏使用.

示例:

1.4 在菜单项之间添加分割线

在菜单项之间可以添加分割线。分割线如下图所示,添加分割线是通过 QMenu 类提供的addSeparator() 函数来实现;

示例:

1.5 综合示例

在窗口上创建一个菜单栏,在菜单栏中添加一些菜单,在某一个菜单中添加一些菜单项。

1、新建Qt项目

注意:此时新建项目时选择的基类 QMainwindow ,如下图示:

2、在"mainwindow.cpp"文件中创建菜单和中央控件

  • 创建一个菜单栏,一个菜单.
  • 两个菜单项:保存,加载
  • 创建一个 QTextEdit 作为窗口的中央控件.
cpp 复制代码 
MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 设置标题
    this->setWindowTitle(" 我的记事本 ");

    // 创建菜单栏
    QMenuBar* menuBar = new QMenuBar(this);
    this->setMenuBar(menuBar);

    // 创建菜单
    QMenu* menu = new QMenu(" 文件 ");
    menuBar->addMenu(menu);

    // 创建菜单项
    QAction* action1 = new QAction(" 保存 ");
    QAction* action2 = new QAction(" 加载 ");
    menu->addAction(action1);
    menu->addAction(action2);

    // 创建中央控件
    edit = new QTextEdit(this);
    this->setCentralWidget(edit);
    edit->setPlaceholderText(" 此处编写文本内容 ...");
}

3、给action添加一些动作

cpp 复制代码 
// 连接信号槽 , 点击 action 时触发一定的效果 .
connect(action1, &QAction::triggered, this, &MainWindow::save);
connect(action2, &QAction::triggered, this, &MainWindow::load);

实现这两个槽函数

  • 使用 QFileDialog 来实现选择文件的效果.
    • getSaveFileName 用于保存文件的场景.此时的对话框可以输入文件名.
    • getOpenFileName 用于打开文件的场景.此时的对话框可以获取到鼠标选择的文件名.
  • 搭配C++标准库的文件操作实现文件读写.
cpp 复制代码 
void MainWindow::save()
{
    // 弹出对话框 , 选择写入文件的路径
    QFileDialog* dialog = new QFileDialog(this);
    QString fileName = dialog->getSaveFileName(this, " 保存文件 ", "C:/Users/1/");
    qDebug() << "fileName: " << fileName;

    // 写入文件
    std::ofstream file(fileName.toStdString().c_str());
    if (!file.is_open()) {
        qDebug() << " 文件保存失败 !";
        return;
    }
    const QString& text = edit->toPlainText();
    file << text.toStdString();
    file.close();
}

void MainWindow::load()
{
    // 弹出对话框 , 选择打开的文件
    QFileDialog* dialog = new QFileDialog(this);
    QString fileName = dialog->getOpenFileName(this, " 加载文件 ", "C:/Users/1/");
    qDebug() << "fileName: " << fileName;

    // 读取文件
    std::ifstream file(fileName.toStdString().c_str());
    if (!file.is_open()) {
        qDebug() << " 文件加载失败 !";
        return;
    }
    std::string content;
    std::string line;
    while (std::getline(file, line)) {
        content += line;
        content += "\n";
    }
    file.close();

    // 显示到界面上
    QString text = QString::fromStdString(content);
    edit->setPlainText(text);
}

执行程序,可以看到此时就可以通过程序来保存/加载文件了.并且对文件进行编辑.

2. 工具栏

工具栏是应用程序中集成各种功能实现快捷键使用的一个区域。 可以有多个,也可以没有,它并不是应用程序中必须存在的组件。它是一个可移动的组件,它的元素可以是各种窗口组件,它的元素通常以图标按钮的方式存在。如下图为工具栏的示意图:

2.1 创建工具栏

调用 QMainWindow类 的 addToolBar() 函数来创建工具栏,每增加一个工具栏都需要调用一次该函数。

如添加两个工具栏:

2.2 设置停靠位置

工具栏停靠位置的设置有两种方式。一种是在创建工具栏的同时指定停靠的位置,另一种是通过QToolBar类 提供的 setAllowedAreas()函数 来设置。

方式一:创建工具栏的同时指定其停靠的位置。

在创建工具栏的同时,也可以设置工具栏的位置,其默认位置是在窗口的最上面;如上述代码,默认在最上面显示。工具栏允许停靠的区域由 QToolBar类 提供的 allowAreas()函数 决定,其中可以设置的位置包括:

  • Qt::LeftToolBarArea停靠在左侧
  • Qt::RightToolBarArea停靠在右侧
  • Qt::TopToolBarArea停靠在顶部
  • Qt::BottomToolBarArea停靠在底部
  • Qt::AllToolBarAreas以上四个位置都可停靠

示例:

方式二:使用QToolBar类提供的setAllowedAreas()函数设置停靠位置。如下示例:

说明:在创建工具栏的同时指定其停靠的位置,指的是程序运行时工具栏默认所在的位置;而使用setAllowedAreas()函数设置停靠位置,指的是工具栏允许其所能停靠的位置。

2.3 设置浮动属性

工具栏的浮动属性可以通过 QToolBar类 提供的 setFloatable()函数 来设置。 setFloatable()函数原型为:

voidsetFloatable(boolfloatable)

参数:

true:浮动

false:不浮动

示例:

2.4 设置移动属性

设置工具栏的移动属性可以通过 QToolBar类 提供的 setMovable()函数 来设置。 setMovable()函数原型为:

voidsetMovable(boolmovable)

参数:

true:移动

false:不移动

说明:若设置工具栏为不移动状态,则设置其停靠位置的操作就不会生效,所以设置工具栏的移动属性类似于总开关的效果。

示例:

2.5 综合示例

3. 状态栏

状态栏是应用程序中输出简要信息的区域。 一般位于主窗口的最底部,一个窗口中最多只能有一个状态栏。在Qt中,状态栏是通过 QStatusBar类 来实现的。 在状态栏中可以显示的消息类型有:

  • 实时消息:如当前程序状态
  • 永久消息:如程序版本号,机构名称
  • 进度消息:如进度条提示,百分百提示

3.1 状态栏的创建

状态栏的创建是通过 QMainWindow类 提供的 statusBar() 函数来创建;示例如下:

3.2 在状态栏中显示实时消息

在状态栏中显示实时消息是通过 showMessage()函数 来实现,示例如下:

3.3 在状态栏中显示永久消息

在状态栏中可以显示永久消息,此处的永久消息是通过 标签 来显示的;示例如下:

显示效果如下:

调整显示消息的位置

显示效果如下:

4. 浮动窗口

在Qt中,浮动窗口也称之为铆接部件 。 浮动窗口是通过 QDockWidget类 来实现浮动的功能。浮动窗口一般是位于核心部件的周围, 可以有多个。

4.1 浮动窗口的创建

浮动窗口的创建是通过 QDockWidget类 提供的构造方法 QDockWidget()函数 动态创建的;示例如下:

4.2 设置停靠的位置

浮动窗口是位于中心部件的周围。 可以通过 QDockWidget类 中提供 setAllowedAreas() 函数设置其允许停靠的位置。其中可以设置允许停靠的位置有:

  • Qt::LeftDockWidgetArea停靠在左侧
  • Qt::RightDockWidgetArea停靠在右侧
  • Qt::TopDockWidgetArea停靠在顶部
  • Qt::BottomDockWidgetArea停靠在底部
  • Qt::AllDockWidgetAreas以上四个位置都可停靠

示例如下: 设置浮动窗口只允许上下停靠

5. 对话框

5.1 对话框介绍

对话框是GUI程序中不可或缺的组成部分。一些不适合在主窗口实现的功能组件可以设置在对话框中。对话框通常是一个顶层窗口,出现在程序最上层,用于实现短期任务或者简洁的用戶交互。Qt常用的内置对话框有: QFiledialog(文件对话框)、QColorDialog(颜色对话框)、QFontDialog(字体对话框)、QInputDialog(输入对话框)和QMessageBox(消息框)。

5.2 对话框的分类

对话框分为 模态对话框 和 非模态对话框。

5.2.1 模态对话框

模态对话框指的是: 显示后无法与父窗口进行交互, 是一种阻塞式的对话框。使用QDialog::exec()函数调用。

模态对话框适用于必须依赖用戶选择的场合,比如消息显示,文件选择,打印设置等。

示例:

1、新建Qt项目,在ui文件中的菜单栏中设置两个菜单: "文件" 和 "编辑" ,在菜单 "文件" 下新建

菜单项: "创建"并将菜单项"新建"置于工具栏中; 如下图示:

2、在mainwindow.cpp文件中实现:当点击 "新建" 时,弹出一个模态对话框;

说明:在菜单项中,点击菜单项时就会触发triggered()信号。

5.2.2 非模态对话框

非模态对话框显示后独立存在, 可以同时与父窗口进行交互 ,是一种非阻塞式对话框,使用QDialog::show()函数调用。

非模态对话框一般在堆上创建,这是因为如果创建在栈上时,弹出的非模态对话框就会一闪而过。同时还需要设置Qt:WA_DeleteOnClose属性,目的是:当创建多个非模态对话框时(如打开了多个非模态窗口),为了避免内存泄漏要设置此属性。

非模态对话框适用于特殊功能设置的场合,比如查找操作,属性设置等。

示例:

5.2.3 混合属性对话框

混合属性对话框同时具有模态对话框和非模态对话框的属性,对话框的生成和销毁具有非模态对话框属性,功能上具有模态对话框的属性。

使用 QDialog::setModal()函数 可以创建混合特性的对话框。通常,创建对话框时需要指定对话框的父组件。

示例:

5.3 Qt内置对话框

Qt 提供了多种可复用的对话框类型,即 Qt标准对话框 。 Qt 标准对话框全部继承于 QDialog类 。常用标准对话框如下:

5.3.1 消息对话框QMessageBox

消息对话框是应用程序中最常用的界面元素。消息对话框主要用于为用戶提示重要信息,强制用戶进行选择操作。

QMessageBox类中定义了静态成员函数,可以直接调用创建不同风格的消息对话框,其中包括:

Question 用于正常操作过程中的提问

Information 用于报告正常运行信息

Warning 用于报告非关键错误

Critical 用于报告严重错误

其对应的函数原型如下:

示例1: 问题提示消息对话框

实现效果如下:

其中可以设置的按钮的类型如下:

更改消息对话框中的按钮类型:

实现效果如下:

示例2: 信息提示消息对话框

实现效果如下:

示例3: 警告信息消息对话框

实现效果如下:

示例4: 错误提示消息对话框

实现效果如下:

5.3.2 颜色对话框QColorDialog

颜色对话框的功能是允许用戶选择颜色。继承自QDialog类。颜色对话框如下图示:

常用方法介绍:

1、QColorDialog(QWidget*parent=nullptr)//创建对象的同时设置父对象

2、QColorDialog(constQColor&initial,QWidget*parent=nullptr)//创建对象的同时通过QColor对象设置默认颜色和父对象

3、voidsetCurrentColor(constQColor&color)//设置当前颜色对话框

4、QColorcurrentColor()const//获取当前颜色对话框

5QColorgetColor(constQColor&initial=Qt::white,QWidget*parent=nullptr,constQString&title=QString(),QColorDialog::ColorDialogOptionsoptions=ColorDialogOptions())//打开颜色选择对话框,并返回一个QColor对象

参数说明:

initial:设置默认颜色

parent:设置父对象

title:设置对话框标题

options:设置选项

6、 voidopen(QObjectreceiver,constcharmember)//打开颜色对话框

示例1:

效果如下:

示例2:

效果如下:

5.3.3 文件对话框QFileDialog

文件对话框用于应用程序中需要打开一个外部文件或需要将当前内容存储到指定的外部文件。

常用方法介绍:

1、打开文件(一次只能打开一个文件)

QStringgetOpenFileName(QWidgetparent=nullptr,constQString&caption=QString(),constQString&dir=QString(),constQString&filter=QString(),QStringselectedFilter=nullptr,QFileDialog::Optionsoptions=Options())

2、打开多个文件(一次可以打开多个文件)

QStringListgetOpenFileNames(QWidgetparent=nullptr,constQString&caption=QString(),constQString&dir=QString(),constQString&filter=QString(),QStringselectedFilter=nullptr,QFileDialog::Optionsoptions=Options())

3、保存文件

QStringgetSaveFileName(QWidgetparent=nullptr,constQString&caption=QString(),constQString&dir=QString(),constQString&filter=QString(),QStringselectedFilter=nullptr,QFileDialog::Optionsoptions=Options())

参数说明:

参数1:parent父亲

参数2:caption对话框标题

参数3:dir默认打开的路径

参数4:filter文件过滤器

示例1: 打开文件

运行效果:

示例2: 保存文件

5.3.4 字体对话框QFontDialog

Qt中提供了预定义的字体对话框类QFontDialog,用于提供选择字体的对话框部件。

示例:

运行效果如下:

5.3.5 输入对话框QInputDialog

Qt中提供了预定义的输入对话框类:QInputDialog,用于进行临时数据输入的场合。

常用方法介绍:

1、双精度浮点型输入数据对话框

doublegetDouble(QWidgetparent,constQString&title,constQString&label,doublevalue=0,doublemin=-2147483647,doublemax=2147483647,intdecimals=1,boolok=nullptr,Qt::WindowFlagsflags=Qt::WindowFlags());

2、整型输入数据对话框

intgetInt(QWidgetparent,constQString&title,constQString&label,intvalue=0,intmin=-2147483647,intmax=2147483647,intstep=1,boolok=nullptr,Qt::WindowFlagsflags=Qt::WindowFlags());

3、选择条目型输入数据框

QStringgetItem(QWidgetparent,constQString&title,constQString&label,constQStringList&items,intcurrent=0,booleditable=true,boolok=nullptr,Qt::WindowFlagsflags=Qt::WindowFlags(),Qt::InputMethodHintsinputMethodHints=Qt::ImhNone);

参数说明:

parent:父亲

title:对话框标题

label:对话框标签

items:可供选择的条目

示例1: 浮点型数据输入对话框

运行效果:

示例2: 整型数据输入对话框

运行效果:

示例3: 打开选择条目对话框

运行效果如下:

g&label,constQStringList&items,intcurrent=0,booleditable=true,bool*ok=nullptr,Qt::WindowFlagsflags=Qt::WindowFlags(),Qt::InputMethodHintsinputMethodHints=Qt::ImhNone);

参数说明:

parent:父亲

title:对话框标题

label:对话框标签

items:可供选择的条目

示例1: 浮点型数据输入对话框

外链图片转存中...(img-yd2nyl3a-1783009477832)

运行效果:

外链图片转存中...(img-Jr1tNLhI-1783009477832)

示例2: 整型数据输入对话框

外链图片转存中...(img-8IiLGmW0-1783009477832)

运行效果:

外链图片转存中...(img-98OBtC65-1783009477832)

示例3: 打开选择条目对话框

外链图片转存中...(img-wlrfsfQE-1783009477832)

运行效果如下:

外链图片转存中...(img-xQ8A0RiP-1783009477832)

相关推荐
旖-旎1 小时前
QT系统篇（5）（下）
开发语言·c++·qt
郝学胜_神的一滴3 小时前
Qt 高级编程 034：深耕QWidget底层内核—彻底吃透无边框窗口设计核心原理
c++·qt
澈2074 小时前
【无标题】QT入门第十二天：数据库编程（下）模型视图与数据展示 | 零基础学QT
数据库·qt·oracle
luoyayun3617 小时前
Qt/QML音视频文件原始十六进制查看器
qt·音视频·十六进制查看
小c君tt7 小时前
QT笔记记录
开发语言·笔记·qt
澈20711 小时前
QT入门第十一天：数据库编程（上）SQLite入门与增删改查 | 零基础学QT
数据库·qt·sqlite
原来是猿1 天前
Qt 信号与槽机制详解（上篇）：从入门到实践
开发语言·qt
用户805533698035 天前
不止三件套：QObject 属性系统全关键字与运行时反射!
c++·qt
xcyxiner5 天前
DicomViewer (vcpkg Windows和ubuntu编译)7
qt
热门推荐
012026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf02GitHub 镜像站点03【AI】2026 年具身智能模型和世界模型总结04AI科技热点日报 | 2026年07月01日052026 AI 编程工具终极实战指南：Cursor vs Claude Code vs Copilot，开发者该怎么选？062026年6月AI大模型全景报告：GPT-5.6、Claude Opus 4.8、Gemini 3.5，中美AI三足鼎立谁主沉浮？072026 年 AI 大模型 & AI 编程工具实战全总结08Claude Code、Codex、Cursor三分天下：2026年AI编程Agent生态全景剖析092026年6月AI行业全景：从百模大战到Agent元年，这30天发生了什么？10Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费