【Qt6】QWidgetAction 的使用

qt6,qwidgetaction,使用 · 浏览次数 : 230

小编点评

**代码示例:** **custWidget.h** ```c++ #ifndef CUSTWIDGET_H #define CUSTWIDGET_H #include class CustWidget : public QFrame{public: CustWidget(QWidget* parent = nullptr); private: void initUI(); }; #endif ``` **custWidget.cpp** ```c++ #include "custWidget.h" #include #include 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);} ``` **myWidgetAction.h** ```c++ #ifndef MYWIDGETACTION_H #define MYWIDGETACTION_H #include class MyWidgetAction : public QWidgetAction{public: MyWidgetAction(QObject *parent); protected: QWidget *createWidget(QWidget *parent) override; }; #endif ``` **myWidgetAction.cpp** ```c++ #include "myWidgetAction.h" #include "custWidget.h" MyWidgetAction::MyWidgetAction(QObject *parent) :QWidgetAction::QWidgetAction(parent){} QWidget *MyWidgetAction::createWidget(QWidget *parent){ CustWidget* w = new CustWidget(parent); return w;} ``` **主窗口 MyWindow::MyWindow()** ```c++ #include #include "custWidget.h" #include "myWidgetAction.h" class MyWindow : public QMainWindow((QWidget*)nullptr){ // 创建菜单栏 QMenuBar *menubar = this->menuBar(); // 创建菜单 QMenu *menu = menubar->addMenu("应用程序\"); // 创建自定义的 MyWidgetAction *custAct = new MyWidgetAction(menu); // 添加自定义的菜单项 menu->addAction(custAct); // 设置窗口标题 win->setWindowTitle("自定义菜单项"); // 设置窗口大小 win->resize(450, 400); // 显示窗口 win->show(); return QApplication::exec();} ``` **效果:** 这个代码会创建一个包含三个红色的滑条和三个绿色滑条的窗口,并有一个名为“应用程序”的菜单项,其中包含一个名为“自定义”的菜单项。

正文

在开始主题前,先看一个 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);
}

最后,咱们来看看效果。

这效果不错吧。

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

与【Qt6】QWidgetAction 的使用相似的内容:

【Qt6】QWidgetAction 的使用

在开始主题前,先看一个 C++ 例子: #include struct Data { int a; int b; }; // 注意这里 struct Data *s; void doSome() { Data k; k.a = 100; k.b = 300; // 注意这里,会

【Qt6】QWindow类可以做什么

原来的水文标题是“用 VS Code 搞 Qt6”,想想还是直接改为“Qt6”,反正这个用不用 VS Code 也能搞。虽然我知道大伙伴们都很讨厌 CMake,但毕竟这厮几乎成了 C++ 的玩家规范了。Qt 也算识大体,支持用 CMake 来构建程序。所以,只要你用的是能写 C++ 的工具,理论上都

【Qt6】嵌套 QWindow

在上个世纪的文章中,老周简单介绍了 QWindow 类的基本使用——包括从 QWindow 类派生和从 QRasterWindow 类派生。 其实,QWindow 类并不是只能充当主窗口用,它也可以嵌套到父级窗口中,变成子级对象。咱们一般称之为【控件】。F 话不多讲,下面咱们用实际案例来说明。 这个

【Qt6】工具提示以及调色板设置

工具提示即 Tool Tip,当用户把鼠标移动到某个UI对象上并悬停片刻,就会出现一个“短小精悍”的窗口,显示一些说明性文本。一般就是功能描述,让用户知道这个XX是干啥用的。 在 Qt 中使用工具提示最方便的做法是直接用 QWidget 类的成员方法:setToolTip。从 QWidget 类派生

【Qt6】列表模型——抽象基类

列表模型(Item Model),老周没有翻译为“项目模型”,因为 Project 和 Item 都可以翻译为“项目”,容易出现歧义。干脆叫列表模型。这个模型也确实是为数据列表准备的,它以 MVC 的概念为基础,在原始数据和用户界面视图之间搭建桥梁,使两者可以传递数据(提取、修改)。 Qt 里面使用

【Qt6】列表模型——便捷类型

前一篇水文中,老周演示了 QAbstractItemModel 抽象类的继承方法。其实,在 Qt 的库里面,QAbstractItemModel 类也派生了两个基类,能让开发者继承起来【稍稍】轻松一些。 这两个类是 QAbstractListModel 和 QAbstractTableModel。

【Qt6】列表模型——树形列表

QStandardItemModel 类作为标准模型,主打“类型通用”,前一篇水文中,老周还没提到树形结构的列表,本篇咱们就好好探讨一下这货。 还是老办法,咱们先做示例,然后再聊知识点。下面这个例子,使用 QTreeView 组件来显示数据,使用的列表模型比较简单,只有一列。 #include

QT中各控件的属性和方法

1.在QT6中,QLabel类具有许多属性和方法,以下是QLabel类的常见属性和调用方法:setText(const QString &text):设置标签的文本内容。setAlignment(Qt::Alignment align):设置文本在标签中的对齐方式。setPixmap(const Q

用 VS Code 搞 Qt6:让信号和槽自动建立连接

Qt 具备让某个对象的信号与符合要求的槽函数自动建立连接。弄起来也很简单,只要调用这个静态方法即可: QMetaObject::connectSlotsByName(...); connectSlotsByName 方法需要一个参数,此参数的指针指向一个实例,这个实例自身的信号,以及它的子级对象的信

【VS Code+Qt6】拖放操作

由于老周的示例代码都是用 VS Code + CMake + Qt 写的,为了不误导人,在标题中还是加上“VS Code”好一些。 上次咱们研究了剪贴板的基本用法,也了解了叫 QMimeData 的重要类。为啥要强调这个类?因为接下来扯到的拖放操作也是和它有关系。哦,对了,咱们先避开一下主题,关于剪