用VS Code搞Qt 6:Gui基础类型——QGuiApplication和QWindow
阅读原文时间:2023年07月09日阅读:1

在99.996%的情况下,我们弄 Qt 应用都会使用 QApplication 类和 QWidget 类,即直接用 Widgets 库中的组件/控件。为了方便开发人员自己造轮子,Qt 也提供了一套基础的 GUI 组件。这些组件位于 Gui 库中。

实际上,Widgets 也是在 Gui 库上实现的,算是官方默认为咱们实现的图形组件库。若是我们自己也想实现一套图形组件库,就得从 Gui 库入手。当然,此行为需要决心、恒心、耐心、信心、专心、勇气、朝气、力气、努力、神力、洪荒之力。毕竟是一项大工程,没有上述精神元素是很难做成的。因此,许多时候,我们压根儿不会去弄,就算要写个自定义的可视化组件,那一般也是从 QWidget 派生。

尽管不怎么用,但还得了解一下的。QGuiAppliction 类用于管理整个应用程序的消息循环,初始化完各类组件后,开启主消息循环,直到循环结束,程序归西。QApplication 类就是它的子类。

QWindow 类是各种窗口部件的基类。它不仅指窗体,也包括窗口上的控件什么的。控件会被视为子窗口(就是没有了标题栏和边框这些)。所以,从 QWindow 类派生既能实现窗体逻辑,也能自定义控件。不过,咱们一般不会直接从 QWindow 类派生,而是使用以下两个家伙:

1、QRasterWindow :这个很好使,就是我们最最最的绘图方式来画控件的可视化部分。Raster 是“光栅”的意思。

2、QOpenGLWindow :看名字也猜到,该类使用 OpenGL 来绘制控件的可视化部分。

下面老周弄一个简单的演示,实现一个 MyCustWindow 类,派生自 QRasterWindow。里面也没啥逻辑,就是先把窗口的背景刷成红色,显得异常地喜庆和活泼。然后当鼠标移到窗口上时,会在窗口上画一个饼……不,是一个圆,这个圆会跟着鼠标指针走——其实,圆并不会动,只不过在鼠标移动后不断地将窗口重新绘制,以制造出圆会动的效果。

总体的代码文件有四个,其实就两个,C/C++都有头文件,于是就四个了。

/* CMakeLists.txt */

project(MyApp LANGUAGES CXX)

find_package(Qt6 REQUIRED COMPONENTS Core Gui)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_AUTOMOC ON)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

add_executable(MyApp WIN32
app.h app.cpp MyCustWindow.h MyCustWindow.cpp)

target_link_libraries(MyApp PRIVATE
Qt6::Core
Qt6::Gui)

app.cpp 是写 main 的,自定义窗口是 MyCustWindow.h 和 MyCustWindow.cpp。老周有个习惯,写C++代码通常会新建个头文件,把要用到的所有头文件一次性弄上去,然后项目中其他地方包含这个头文件就行了。比如这里的 app.h。

#ifndef _APP_H_
#define _APP_H_

#include
#include
#include
#include
#include
#include
#include
#include

#endif

Qt 这厮基本就是这样的,每个类一个头文件,所以用到哪些类,直接上名字。_APP_H_ 只是个宏,为了防止多次包含此头文件时被重复定义,没有别的用途。这里老周没有用 #pragma once,据说这个不太通用。当然也没说不能用,只要不报错啥也能上。

接下来是自定义窗口类的定义。

/* MyCustWindow.h */

#include "app.h"

class MyCustWindow : public QRasterWindow {
Q_OBJECT
public:
explicit MyCustWindow(QWindow* parent = nullptr);
~MyCustWindow();
protected:
void paintEvent(QPaintEvent *event) override;
bool event(QEvent *event) override;

private:
QPoint _curr_pos;
};

用在Qt对象树上的类型(说白了是 QObject 的直接或间接子类)都要加个宏 Q_OBJECT,信号和 Cao 需要它。不知道是啥也没事,照搬就行了。

这里,_curr_pos 是私有的成员,主要用来记录当前鼠标指针的坐标,以便在 paintEvent 中画图用。这个示例需要重写两个成员:

1、paintEvent:绘制窗口内容。

2、event:处理事件,捕捉鼠标指针移动事件—— MouseMove。这里其实可以用 eventFilter,也能起来相同的效果,不过,直接重写 event 最划算。

下面看 event 方法的实现。

bool MyCustWindow::event(QEvent *event)
{
// 分析一下事件类型
if(event -> type() == QEvent::MouseMove)
{
QMouseEvent* msevent = dynamic_cast(event);
// 拿到当前鼠标指针的位置
_curr_pos = msevent->pos();

    // 重新绘制窗口  
    update();  
    // 已处理,返回true  
    return true;  
}

// 剩下的留给基类默认处理  
return QRasterWindow::event(event);  

}

如果是鼠标事件,那么,event 参数的指针实际指向的是 QMouseEvent 对象,所以我这里用 dynamic_cast 转换了一下,这个运算符虽然不太安全,但指针之间转换比较好用。这里其实不会有啥问题,因为如 event type 确定为 MouseMove,那么 event 参数就是 QMouseEvent* 类型。接着,访问 pos() 获得当前坐标,赋值给 _curr_pos。最后一步是调用 update 方法,这个一定要调用,这样才能强制窗口重新绘制,那个圆才会跟着鼠标走。

当然,最后一行也少不了,毕竟我们这里只关心鼠标事件,可能还有很多事件,于是这些我们不感兴趣的事件交给基类处理。

return QRasterWindow::event(event);

下一步,我们画窗口内容。

void MyCustWindow :: paintEvent(QPaintEvent *event)
{
QColor bkColor(255,0,0); // 背景色
QColor ptColor(255,255,0); // 跟随鼠标指针的颜色

// 开始表演  
QPainter painter(this);  
// 设置默认背景色  
painter.setBackgroundMode(Qt::OpaqueMode);  
painter.setBackground(QBrush(bkColor));  
painter.setBrush(QBrush(ptColor));  
// 擦除画布  
painter.eraseRect(0, 0, width(), height());  
// 画圆  
painter.drawEllipse(\_curr\_pos, 20, 20);

//event -> accept();  

}

最后一行的 accept 方法调用,此处可以有也可以省略。accept 后事件就不再传播到父对象了,不是父类,是对象树上的父对象。窗口算是这里的顶层对象了,所以传不传上去无所谓。

这里有坑,有不少同志说,调用 setBackground 方法无法设置背景,全是黑的。这里要注意两点:

1、setBackgroundMode 方法将模式设置为 OpaqueMode 时才能上背景,如果是 TransparentMode,表明是透明背景,此时设置不了背景色的。程序默认就是 OpaqueMode,所以 setBackgroundMode 一行可以省略。

2、设置背景色后,在绘制前一定要清空画布——调用 eraseRect 方法,本示例中要擦除整个窗口的区域,所以,矩形的大小和窗口大小相同。

调用 drawEllipse 方法直接就可以画圆了,我们这里画的不是椭圆,而是正圆,只要让 x 和 y 轴方向上的半径相等(都是 20)就可以了。

回到 app.cpp,写 main 入口函数。

#include "app.h"
#include "MyCustWindow.h"

int main(int argc, char* argv[])
{
QGuiApplication app(argc, argv);

// 实例化窗口  
MyCustWindow window;  
// 标题  
window.setTitle("喜狼狼和灰太羊");  
// 大小  
window.resize(300, 270);  
// 位置  
window.setPosition(670,364);  
// 显示窗口  
window.show();

return app.exec();  

}

app.exec 开启主消息循环,要在所有初始化工作完成再调用,因为它不会马上返回,而是等消息循环结束才返回。

末了,完工,咱们看看效果。

通过这个演示,大伙伴们对 QWindow 的用处,想必有所了解了。若某天你发现你要干自造轮子的大活,那就得这样弄了。