如何在 Qt6 中将 QOpenGLWidget 嵌入 QWidget 显示

前言

在 Qt5 中，使用 QOpenGLWidget 并加入 QLayout 布局嵌入 QWidget，是没有啥大问题的，无边框窗口效果都是正常的；但是在 Qt6 中，会莫名其妙出现窗口管理器原生标题栏，破坏无边框窗口效果。

在给 deepin 23 修改 dde-desktop 动态壁纸插件时就不幸遇到了这个问题......
原本的代码使用 Qt5 + libdmr 播放视频，在早期 deepin 23 版本中，dde-desktop 使用 Qt5 编译，可以正常播放动态壁纸；后期 dde-desktop 修改为 dde-shell 插件，使用 Qt6 编译，一旦加入 QOpenGLWidget 播放视频，整个桌面就会从全屏状态变成一个有标题栏的窗口，即使修改窗口属性也无法去除标题栏。

libdmr 是 deepin-movie-reborn 提供的播放能力，类似 libmpv + QOpenGLWidget 方式

无奈之下，用了一些骚操作暂时规避了该问题，在桌面显示前先把 QOpenGLWidget 塞进布局，一起显示出来，就不会有标题栏了（但是 QOpenGLWidget 此后就不能析构了，一旦重新插入布局，标题栏就会出现）。

然而，这种操作在 deepin 25 上也不行了，咋搞都会导致桌面变成一个独立窗口。下定决心搜索了下 Qt opengl 相关的问题和文档，才搞清楚怎么回事......

省流

以下操作均在 deepin 25 中进行测试，仓库 Qt6 版本为 6.8.0

方法一：修改父窗口 QSurfaceType

https://doc.qt.io/qt-6/qopenglwidget.html

Note: When dynamically adding a QOpenGLWidget into a widget hierarchy, e.g. by parenting a new QOpenGLWidget to a widget where the corresponding top-level widget is already shown on screen, the associated native window may get implicitly destroyed and recreated if the QOpenGLWidget is the first of its kind within its window. This is because the window type changes from RasterSurface to OpenGLSurface and that has platform-specific implications. This behavior is new in Qt 6.4.

大概意思就是从 Qt 6.4 开始，如果首次把 QOpenGLWidget 嵌入一个已经显示出来的 QWidget 中，会导致原生窗口被销毁并重建，因为窗口 type 从 RasterSurface 变成 OpenGLSurface 。

所以，可以在调用父对象 QWidget::show() 显示窗口前，提前修改 surfaceType 为 QSurfaceType::OpenGLSurface，可以避免 QOpenGLWidget 插入布局后出现标题栏：

#include 
#include 
#include 
......
    QMainWindow w;
    ......
    QOpenGLWidget childWidget = new QOpenGLWidget(w);
    w.windowHandle()->setSurfaceType(QSurface::OpenGLSurface);

    w.show();

方法二（不推荐）：使用 QOpenGLWindow

https://doc.qt.io/qt-6/qopenglwidget.html

Alternatives
Adding a QOpenGLWidget into a window turns on OpenGL-based compositing for the entire window. In some special cases this may not be ideal, and the old QGLWidget-style behavior with a separate, native child window is desired. Desktop applications that understand the limitations of this approach (for example when it comes to overlaps, transparency, scroll views and MDI areas), can use QOpenGLWindow with QWidget::createWindowContainer(). This is a modern alternative to QGLWidget and is faster than QOpenGLWidget due to the lack of the additional composition step. It is strongly recommended to limit the usage of this approach to cases where there is no other choice. Note that this option is not suitable for most embedded and mobile platforms, and it is known to have issues on certain desktop platforms (e.g. macOS) too. The stable, cross-platform solution is always QOpenGLWidget.

大概翻译一下，QOpenGLWindow 和 QOpenGLWidget 使用方式类似，可以利用 QWidget::createWindowContainer() 把 QOpenGLWindow 转换为 QWidget 并塞进布局。

测试了一下，这种方式确实不会导致有标题栏，但问题也很大。根据帮助手册，这种方式无法保证窗口层级的正确显示。用在动态壁纸插件中，会导致视频层遮挡原本的桌面层，导致看不到图标也无法调用菜单......