QT基础 - QMainWindow主窗口

零. 简介

一. 菜单栏

二. 工具栏

三. 状态栏

四. 可停靠区域

五. 总结

零. 简介

QMainWindow 是 Qt 中用于构建主窗口的类。

它通常包含以下几个主要部分：

菜单栏：用于提供各种操作选项。
工具栏：放置常用的操作按钮。
中心区域：用于显示主要的内容或控件。
状态栏：用于显示一些状态信息。

QMainWindow 为应用程序提供了一个标准的、功能丰富的主界面框架，方便开发者组织和管理窗口中的各种元素。它可以方便地进行布局管理，添加各种控件和功能组件，以满足不同应用程序的需求。开发者可以通过代码灵活地定制 QMainWindow 的各个部分，实现个性化的用户界面设计和功能实现。例如，可以动态添加或移除菜单项、工具栏按钮，以及在中心区域显示不同的控件或窗口。

一. 菜单栏

QMainWindow的菜单栏是位于主窗口顶部的一个菜单条，其中包含了多个菜单，每个菜单又可以包含多个菜单项。以下是关于QMainWindow菜单栏的详细介绍：

菜单栏的创建：通过调用QMainWindow类的menuBar()函数可以获取主窗口的菜单栏指针。然后，可以使用QMenu类的addMenu()函数添加菜单。
菜单的添加：使用QMenu类的addAction()函数可以向菜单中添加菜单项。QAction类用于表示菜单项或工具栏按钮的动作，可以设置动作的文本、图标、快捷键等属性。
菜单项的点击响应：当用户点击菜单项时，会触发相应的信号。可以通过连接信号和槽函数来处理菜单项的点击事件。
菜单栏的布局：菜单栏的布局可以通过设置菜单的位置和顺序来调整。可以使用QMenu类的insertMenu()函数在指定位置插入菜单，或者使用removeMenu()函数移除菜单。
多级菜单：可以创建多级菜单，即在一个菜单下再添加子菜单，形成层次结构。
快捷键和助记符：可以为菜单项设置快捷键和助记符，方便用户通过键盘操作。
动态菜单：可以根据程序的运行状态动态地添加、修改或删除菜单项。
样式设置：可以通过设置菜单栏和菜单项的样式来美化界面。

通过合理使用菜单栏，可以提供方便的用户操作入口，增强应用程序的功能和易用性。开发者可以根据具体需求创建各种菜单和菜单项，并通过信号与槽机制实现相应的功能。

属性：

通常没有特别突出的特定属性。

方法：

addMenu(QString menuTitle)：添加一个新的菜单。
addAction(QAction* action)：向菜单中添加一个动作。

示例：

#include <QApplication>
#include <QMainWindow>
#include <QMenu>
#include <QAction>
#include<QMenuBar>

class MyMainWindow : public QMainWindow {
public:
    MyMainWindow() {
        QMenuBar *menuBar = this->menuBar();

        // 文件菜单
        QMenu *fileMenu = new QMenu("文件", this);
        menuBar->addMenu(fileMenu);

        QAction *newFileAction = new QAction("新建文件", this);
        fileMenu->addAction(newFileAction);

        QAction *openFileAction = new QAction("打开文件", this);
        fileMenu->addAction(openFileAction);

        // 编辑菜单
        QMenu *editMenu = new QMenu("编辑", this);
        menuBar->addMenu(editMenu);

        QAction *cutAction = new QAction("剪切", this);
        editMenu->addAction(cutAction);

        QAction *copyAction = new QAction("复制", this);
        editMenu->addAction(copyAction);

        QAction *pasteAction = new QAction("粘贴", this);
        editMenu->addAction(pasteAction);

        // 视图菜单
        QMenu *viewMenu = new QMenu("视图", this);
        menuBar->addMenu(viewMenu);

        QAction *zoomInAction = new QAction("放大", this);
        viewMenu->addAction(zoomInAction);

        QAction *zoomOutAction = new QAction("缩小", this);
        viewMenu->addAction(zoomOutAction);

        // 连接一些信号与槽
        connect(newFileAction, &QAction::triggered, this, [this]() {
            qDebug() << "点击了新建文件";
        });

        connect(openFileAction, &QAction::triggered, this, [this]() {
            qDebug() << "点击了打开文件";
        });

        connect(cutAction, &QAction::triggered, this, [this]() {
            qDebug() << "点击了剪切";
        });

        connect(copyAction, &QAction::triggered, this, [this]() {
            qDebug() << "点击了复制";
        });

        connect(pasteAction, &QAction::triggered, this, [this]() {
            qDebug() << "点击了粘贴";
        });

        connect(zoomInAction, &QAction::triggered, this, [this]() {
            qDebug() << "点击了放大";
        });

        connect(zoomOutAction, &QAction::triggered, this, [this]() {
            qDebug() << "点击了缩小";
        });
    }
};

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);
    MyMainWindow w;
    w.show();
    return a.exec();
}

效果图

二. 工具栏

工具栏是Qt中用于提供快速访问常用操作的界面组件。它通常位于菜单栏下方或窗口的其他位置，可以包含各种按钮、图标和其他控件。

属性：

orientation：工具栏的方向，可以是水平或垂直。
iconSize：工具栏上图标的大小。
movable：工具栏是否可移动。
Floatable：工具栏是否可浮动。

方法：

addAction(QAction*)：向工具栏添加一个动作。
insertAction(QAction*, QAction*)：在指定的动作之前插入一个新的动作。
removeAction(QAction*)：从工具栏中移除一个动作。
setOrientation(Qt::Orientation)：设置工具栏的方向。
setIconSize(QSize)：设置工具栏上图标的大小。

示例:

#include <QApplication>
#include <QMainWindow>
#include <QToolBar>
#include <QAction>

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    QMainWindow w;

    // 创建工具栏
    QToolBar *toolBar = new QToolBar(&w);

    // 创建动作
    QAction *action1 = new QAction("Action 1", &w);
    QAction *action2 = new QAction("Action 2", &w);

    // 将动作添加到工具栏
    toolBar->addAction(action1);
    toolBar->addAction(action2);

    // 设置工具栏的位置
    w.addToolBar(Qt::TopToolBarArea, toolBar);

    w.show();

    return a.exec();
}

效果图:

三. 状态栏

Qt 中的状态栏是用于显示应用程序状态信息的区域，通常位于主窗口的底部。

它可以显示各种类型的信息，如实时消息、永久消息和进度条等。

常用属性：

message()：获取当前状态栏显示的消息。
isVisible()：判断状态栏是否可见。
sizeGripEnabled()：状态栏右下角的尺寸控制点是否可用。

常用方法：

showMessage(QString message, int timeout = 0)：在状态栏中显示指定的消息，timeout参数表示消息显示的时间（毫秒），默认为 0 表示一直显示。
clearMessage()：清除状态栏中的消息。
addWidget(QWidget * widget, int stretch = 0)：向状态栏中添加一个控件，stretch参数表示控件的伸缩比例。
removeWidget(QWidget * widget)：从状态栏中移除一个控件。

代码示例：

#include <QApplication>
#include <QMainWindow>
#include <QStatusBar>
#include <QLabel>

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    QMainWindow w;

    QStatusBar *statusBar = new QStatusBar(&w);
    w.setStatusBar(statusBar);

    // 添加一个文本消息
    statusBar->showMessage("这是状态栏的消息");

    // 添加一个标签到状态栏
    QLabel *label = new QLabel("自定义信息");
    statusBar->addWidget(label);

    w.show();

    return a.exec();
}

效果图:

四. 可停靠区域

可停靠区域（QDockWidget）是 Qt 中的一个窗口部件，用于创建可停靠的窗口，通常用于构建多文档接口（MDI）或可定制的用户界面。QDockWidget 允许用户将窗口停靠在应用程序的主窗口周围，或将其拖动到独立的浮动窗口中。

以下是有关 QDockWidget 的详细介绍和使用方法：

QDockWidget 的主要特点：

停靠功能：QDockWidget 允许用户将窗口部件停靠在主窗口的各个位置，如左侧、右侧、上方或下方；
浮动窗口：用户还可以将 QDockWidget 拖动到独立的浮动窗口中；
可关闭：QDockWidget 可以关闭，允许用户根据需要隐藏或显示它；
自定义部件：可以将自定义的部件放在 QDockWidget 中，以构建自定义的界面元素。

常用函数介绍：

setWidget：设置停靠窗口中的部件；
setAllowedAreas：设置允许停靠的区域；
setFeatures：设置停靠窗口的功能特性，如关闭按钮、可浮动等；
setWindowTitle：设置停靠窗口的标题；
setVisible：设置停靠窗口的可见性；
isFloating：检查停靠窗口是否在浮动状态；
close：关闭停靠窗口；
toggleViewAction：获取一个 QAction 对象，用于在工具栏中切换停靠窗口的可见性；
topLevelChanged信号：在停靠窗口的浮动状态发生变化时触发

示例:

#include <QApplication>
#include <QMainWindow>
#include <QDockWidget>
#include <QPushButton>

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);

    QMainWindow mainWindow;

    QDockWidget *dockWidget1 = new QDockWidget("Dock 1", &mainWindow);
    QPushButton *button1 = new QPushButton("Button in Dock 1");
    dockWidget1->setWidget(button1);
    mainWindow.addDockWidget(Qt::LeftDockWidgetArea, dockWidget1);

    QDockWidget *dockWidget2 = new QDockWidget("Dock 2", &mainWindow);
    QPushButton *button2 = new QPushButton("Button in Dock 2");
    dockWidget2->setWidget(button2);
    mainWindow.addDockWidget(Qt::RightDockWidgetArea, dockWidget2);

    mainWindow.show();

    return a.exec();
}

效果图: