【Qt6】QWidgetAction 的使用

在开始主题前，先看一个 C++ 例子：

#include <iostream>  struct Data {     int a;     int b; };  // 注意这里 struct Data *s;  void doSome() {     Data k;     k.a = 100;     k.b = 300;     // 注意这里，会出大事     s = &k; }  int main() {     // 先调用了函数     doSome();     // 再输出 Data 结构体的内容     std::cout << "a = " << s->a << 'n';     std::cout << "b = " << s->b << 'n';     return 0; }

不要问这个例子的功能，问就是超能力。其实这个例子没啥功能，纯粹是为了运行后出错而写的。有同学会疑惑：这程序好像没啥问题。嗯，看着是没啥问题，我们预期的情况是：a 的值是 100，b 的值是 300。

遗憾的是，运行结果是这样的：

a = -858993460 b = -858993460

啥玩意儿？下面咱们就扒一下到底哪里出事了。

这个例子先定义了一个结构体叫 Data，里面有两个字段 a、b。然后声明 Data 类型的指针变量，在 doSome 函数中让变量 s 引用了一个 Data 实例的实例。在 main 函数中，先调用 doSome 函数，然后再输出 a、b 的值。这里就出现一个问题了：s 引用的 k 是在 doSome 函数内创建的，而且它的数据分配在栈上，当 doSome 函数执行结束时，k 的生命周期也差不多了。当调用 doSome 函数之后访问 s，此时 s 所指向的对象已经没有了，所以 a、b 输出的是一个“脏”的值。

若是把 k 改为 static，那结果就不一样了。

void doSome() {     static Data k;     k.a = 100;     k.b = 300;     // 注意这里，会出大事     s = &k; }

控制台将输出：

a = 100 b = 300

如果你不相信上述现象，也可以把例子改成这样：

#include <iostream>  class Test { public:     Test()     {         std::cout << "Test 构造函数 ..." << std::endl;     }      ~Test()     {         std::cout << "Test 析构函数 ..." << std::endl;     }     int a,b; };  // 注意这里 Test *s;  void doSome() {     Test k;     k.a= 100;     k.b = 300;     // 注意这里，会出大事     s = &k; }  int main() {     // 先调用了函数     std::cout << "调用doSome函数前n";         doSome();     std::cout << "调用doSome函数后n";     // 再输出a、b的内容     std::cout << "a = " << s->a << 'n';     std::cout << "b = " << s->b << 'n';     return 0; }

运行上述代码，得到的输出为：

Test 构造函数 ... Test 析构函数 ... 调用doSome函数后 a = -858993460 b = -858993460

这样就能清楚地知道，s 引用的对象在退出 doSome 函数之前就已经析构了。除了使用 static 关键字外，也可以让 Test 对象分配在堆上。

void doSome() {     Test *k = new Test;     k->a = 100;     k->b = 300;     // 复制的是地址，不是对象     s = k; }

把 k 赋值给 s，只是把指向的地址复制一遍罢了，对象实例并没有复制。栈上的数据会因变量的生命周期而被回收，但堆上的东西需要 delete。所以，在调用完 doSome 函数后，堆上的东西还在，所以输出的 a、b 值不会“脏”。按理说，s 用完了应该 delete 的，不过，我没写 delete 语句，毕竟这里 main 函数马上就执行完了，程序都结束了，堆上的东西早没了，所以，这里就偷偷懒吧，不必管它。

下面再来看一个 Qt 程序：

#include <QWidget> #include <QApplication> #include <QVBoxLayout> #include <QPushButton>   int main(int argc, char* argv[]) {     QApplication app(argc, argv);     // 创建两个按钮     QPushButton btnA("Yes");     QPushButton btnB("No");     // 创建顶层窗口     QWidget window;          // 构建对象树     btnA.setParent(&window);     btnB.setParent(&window);     // 设置按钮在窗口中的位置     btnA.move(28, 30);     btnB.move(28, 75);      // 显示窗口     window.show();      return QApplication::exec(); }

上述程序也是一个有问题的程序，但它能运行，只是在关闭窗口时报错。

Unhandled exception at 0x00007FFDD029C1F9 (ntdll.dll) in myapp.exe: 0xC0000374: 堆已损坏。 (parameters: 0x00007FFDD03118A0).

这个问题和第一个例子的有点像但又不完全一样。这个 Qt 程序是一个经典错误，问题出在两个 QPushButton 对象被析构了两次。由于所有变量都是在栈上分配的，上述程序的压入顺序是 btnA - btnB - window。按照后进先出的规则，window 变量是最新定义的，它首先发生析构。由于 btnA、btnB 调用了 setParent 方法设置了对象树关系，当 window 析构时会删除 btnA、btnB。又因变量生命周期的原因，在 window 析构之后，btnA 和 btnB 又发生析构（可刚才 window 让它们析构过了）。

解决方法：1、调整声明变量的顺序，先声明 window 变量，再声明其他变量；2、用指针。

下面代码改为用指针类型。

#include <QWidget> #include <QApplication> #include <QVBoxLayout> #include <QPushButton>   int main(int argc, char* argv[]) {     QApplication app(argc, argv);     // 创建两个按钮     QPushButton *btnA = new QPushButton("Yes");     QPushButton *btnB = new QPushButton("No");     // 创建顶层窗口     QWidget *window = new QWidget;          // 构建对象树     btnA->setParent(window);     btnB->setParent(window);     // 设置按钮在窗口中的位置     btnA->move(28, 30);     btnB->move(28, 75);      // 显示窗口     window->show();      return QApplication::exec(); }

这里咱们也不需要 delete，毕竟窗口和两个按钮在应用程序运行期间它们都必须存在的，只到了程序退出时才销毁，那就没必要 delete 了。

所以说：

1、不是所有指针变量都要 delete 的，因为它引用的可能不是堆上的对象，没准是栈上的对象；

2、不是所有 new 出来的对象就非要 delete 不可，主要看它的生命周期是否该结束。如果是短暂使用的，在应用程序运行期间不需要一直存在的，用完就要 delete。有些 new 出来的对象可能要传递给其他对象用，并由它们负责释放，那也不需要 delete，比如包装剪贴板数据的 QMimeData 类。

==========================================================================

好了，以上一大段内容就当作科普，正片现在才开始。本篇咱们看一下特殊的 QAction 类——QWidgetAction。看名字也可以联想到，它是可以把一个 QWidget 用作 action 的类。这个有什么用呢？作用就是你可以在菜单里做些交互功能。

 QWidgetAction 类有两种用法：

1、直接用，这是最简单方法。实例化后调用 setDefaultWidget 方法设置一个 widget；

2、派生出子类，重写 createWidget 方法，创建你需要的组件对象。

先看第一种用法，非常好办，你想在菜单项上显示什么组件就创建它，然后调用 setDefaultWidget 方法就行了。

// 头文件 #ifndef APP_H #define APP_H  #include <QMainWindow> #include <QWidget> #include <QAction> #include <QSpinBox> #include <QMenu> #include <QMenuBar> #include <QWidgetAction>  class MyWindow : public QMainWindow { public:     MyWindow(); };  #endif /*---------------------------------------------*/ // 代码文件 MyWindow::MyWindow()     :QMainWindow((QWidget*)nullptr) {     // 创建菜单栏     QMenuBar *menubar = this->menuBar();     // 创建菜单     QMenu *menu = menubar->addMenu("应用程序");     // 添加两个普通action，意思一下     menu->addAction("打开文件");     menu->addAction("关闭文件");     // 下面才是主角     QWidgetAction *widgetAct = new QWidgetAction(menu);     // 创建一个数字组件     QSpinBox *spinbox = new QSpinBox;     // 设置一下有效范围     spinbox->setRange(0, 1000);     // 设置当前值     spinbox->setValue(250);     // 设置为 QWidgetAction 的默认组件     widgetAct->setDefaultWidget(spinbox);     // 把action添加到菜单中     menu->addAction(widgetAct); }

应用程序窗口继承了 QMainWindow 类，因为这个类比较方便构建菜单栏、工具栏、状态栏、停靠栏。咱们用它来创建一个菜单栏对象（QMenuBar），然后添加一个叫“应用程序”的菜单（QMenu）。

“应用程序”菜单的前两个菜单项是普通的 action，第三个是 QWidgetAction 对象。在 new 出 QWidgetAction 后，先初始化一下 QSpinBox 组件，然后调用 setDefaultWidget 方法，这样 QSpinBox 组件就能显示在菜单项上了。

在 main 函数中显示主窗口。

int main(int argc, char** argv) {     QApplication app(argc, argv);     MyWindow *win = new MyWindow;     win->setWindowTitle("自定义菜单项");     win->resize(450, 400);     win->show();     return QApplication::exec(); }

好了，见证奇迹的时候到了，看看效果。

 

另一种用法，就是从 QWidgetAction 类派生。然后重写这个方法：

QWidget *createWidget(QWidget *parent);

parent 是父级对象，由调用者传递，这取决于这个自定义的 action 用在什么容器上了，如果用在菜单上，就是 QMenu 对象。返回值就是创建的自定义组件了。

另外，如果在析构自定义组件时有特殊处理，还可以重写 delete 方法。

void deleteWidget(QWidget *widget);

widget 参数是要被删除的自定义组件实例。如果无其他要实现的需求，没必要重写它。

下面咱们来个示例：自定义组件做个带三个滑块的界面。组件名称为 CustWidget，基类是 QFrame。选择 QFrame 作为基类是方便设置边框。

// 头文件 #ifndef CUSTWIDGET_H #define CUSTWIDGET_H #include <QWidget> #include <QFrame>  class CustWidget: public QFrame { public:     CustWidget(QWidget* parent = nullptr); private:     void initUI(); }; #endif  // 代码文件 #include "custWidget.h" #include <QFormLayout> #include <QSlider>  CustWidget::CustWidget(QWidget *parent)     :QFrame::QFrame(parent) {     this->initUI(); }  void CustWidget::initUI() {     // 创建布局     QFormLayout* layout = new QFormLayout(this);     // 创建三个滑条     QSlider* slider1 = new QSlider;     slider1->setRange(0,255);   // 有效范围     QSlider* slider2 = new QSlider;     slider2->setRange(0,255);     QSlider* slider3 = new QSlider;     slider3->setRange(0,255);     // 设置滑条的方向是水平方向     slider1->setOrientation(Qt::Horizontal);     slider2->setOrientation(Qt::Horizontal);     slider3->setOrientation(Qt::Horizontal);     // 把它们添加到布局中     layout->addRow("Red:", slider1);     layout->addRow("Green:", slider2);     layout->addRow("Blue:", slider3);     // 设置边框为面板     this->setFrameShape(QFrame::Panel); }

滑块条是 QSlider 组件，它默认的方向是垂直的，所以要将方向设定为水平。自定义组件还用到了 QFormLayout 类，它是布局类，类似 HTML Form 元素的布局方式，即表单。一般分为两列，左列是字段标题，右列是字段内容。

CustWidget 组件定义好了，接下来就是 MyWidgetAction 类，派生自 QWidgetAction。

// 头文件 #ifndef MYWIDGETACTION_H #define MYWIDGETACTION_H  #include <QWidgetAction> #include "custWidget.h"  class MyWidgetAction : public QWidgetAction { public:     MyWidgetAction(QObject *parent);  protected:     QWidget *createWidget(QWidget *parent) override; };  #endif  // 代码文件 #include "myWidgetAction.h"  MyWidgetAction::MyWidgetAction(QObject *parent)     :QWidgetAction::QWidgetAction(parent) { }  QWidget *MyWidgetAction::createWidget(QWidget *parent) {     CustWidget* w = new CustWidget(parent);     return w; }

整体逻辑很简单，就是返回 CustWidget 的实例。

 

然后咱们在前面 QWidgetAction 的示例上再添加一个菜单项，使用咱们刚定义的 MyWidgetAction。

MyWindow::MyWindow()     :QMainWindow((QWidget*)nullptr) {     // 创建菜单栏     QMenuBar *menubar = this->menuBar();     // 创建菜单     QMenu *menu = menubar->addMenu("应用程序");     ……     // 下面这个是自定义的     MyWidgetAction *custAct = new MyWidgetAction(menu);     menu->addAction(custAct); }

最后，咱们来看看效果。

这效果不错吧。

好了，今天就水到这里了，有空咱们继续聊。