Qt 6子窗口全屏显示

一、全屏显示效果

在这里插入图片描述

二、全屏相关函数

1,全屏显示函数

QWidget::showFullScreen(); // 此方法只对顶级窗口有效，对子窗口无效

2，恢复显示函数

QWidget::showNormal(); // 此方法也只对顶级窗口有效，对子窗口无效

3，最小化显示函数

QWidget::showMinimized();

4，最大化显示函数

QWidget::showMaximized();

5，设置窗口类型

QWidget::setWindowFlags(Qt::WindowFlags);

三，子窗口全屏显示两种实现方式

ps: 本文只测试了Qt 6环境运行情况。

Qt中的窗口QWidget成员函数showFullScreen，可以将窗口全屏显示，但是只是对窗口模式有用，也就是具有Qt::Window属性的窗口。

    enum WindowType {Widget = 0x00000000,Window = 0x00000001,Dialog = 0x00000002 | Window,Sheet = 0x00000004 | Window,Drawer = Sheet | Dialog,Popup = 0x00000008 | Window,Tool = Popup | Dialog,ToolTip = Popup | Sheet,SplashScreen = ToolTip | Dialog,Desktop = 0x00000010 | Window,SubWindow = 0x00000012,ForeignWindow = 0x00000020 | Window,CoverWindow = 0x00000040 | Window,...};

Dialog也具有Qt::Window属性。

1. 方式一：直接将主窗口全屏，只显示某个子窗口

这是一种实现起来可能比较繁琐的方式，因为要隐藏所有不想看到的控件，退出全屏还得恢复原样，控制粒度比较精细。

但是这种实现方式，不会有多屏显示器的问题，会直接全屏显示到当前窗口屏幕。

先建立一个工程如下

在这里插入图片描述

由于要隐藏控件，使用QWidget做布局控件，不要使用Vertical Layout或者Horizontal Layout，它们没有hide()函数。

点击按钮实现全屏或者退出全屏

void MainWindow::on_pushButtonHideFullScreen_clicked() {if (this->isFullScreen()) {this->showNormal();ui->widgetControl->show();ui->statusbar->show();} else {this->showFullScreen();ui->widgetControl->hide();ui->statusbar->hide();}
}

在全屏的方式下，不需要的控件需要隐藏，所以最好有一个QWidget来包含这些要隐藏的控件，就只需要隐藏这个QWidget本身。

当退出全屏时候需要恢复显示。

ESC按键退出全屏

在主窗口中进行键盘按键过滤可以直接实现keyPressEvent虚函数即可。

void MainWindow::keyPressEvent(QKeyEvent *event) {if (this->isFullScreen() && event->key() == Qt::Key_Escape) {qDebug() << "ESC";this->showNormal();ui->widgetControl->show();ui->statusbar->show();}
}

上述代码会在键盘按键按下那一瞬间执行，如果匹配Qt::Key_Escape就退出全屏。

2. 方式二：子窗口设置Qt::Window标志，全屏显示

mainwindow.h

需要用到成员变量，保存子窗口和它以前的WindowFlags，退出全屏时候需要恢复。

    // 子窗口全屏QWidget *fsWidget_ = nullptr;Qt::WindowFlags fsFlags_;void enableChildFullScreen();void disableChildFullScreen();

全屏与退出

void MainWindow::enableChildFullScreen() {fsWidget_ = ui->openGLWidget;fsFlags_ = fsWidget_->windowFlags();fsWidget_->setWindowFlags(Qt::Window | Qt::WindowStaysOnTopHint |Qt::FramelessWindowHint);fsWidget_->setFocus();fsWidget_->showFullScreen();fsWidget_->installEventFilter(this);
}void MainWindow::disableChildFullScreen() {fsWidget_->setWindowFlags(fsFlags_);fsWidget_->showNormal();fsWidget_->removeEventFilter(this);fsWidget_ = nullptr;
}

注意到这里有个installEventFilter，因为子窗口全屏了，MainWindow不是激活的，他没法捕捉到键盘事件，这里只能重新指定事件过滤器。

当全屏的时候安装子窗口事件过滤器，退出全屏时候移除。

响应按钮事件


void MainWindow::on_pushButtonChildFullScreen_clicked() {if (!fsWidget_) {qDebug() << "enable full screen";enableChildFullScreen();} else {qDebug() << "disable full screen";disableChildFullScreen();}
}

事件过滤器


bool MainWindow::eventFilter(QObject *watched, QEvent *event) {if (fsWidget_ != nullptr && watched == fsWidget_ &&event->type() == QEvent::KeyPress) {qDebug() << "ESC";QKeyEvent *keyEvent = static_cast<QKeyEvent *>(event);if (keyEvent->key() == Qt::Key_Escape) {disableChildFullScreen();return true; // 事件已处理，不传递给其他对象}}return QMainWindow::eventFilter(watched, event); // 将事件传递给基类处理
}

多显示器问题

这种方式如果遇到多显示器会有问题，子窗口全屏后只会显示在主显示器。同时原来的窗口框架依然在，会显示如下一个缺少那个子窗口的样子。
在这里插入图片描述
如果只有一个显示器，这个问题也就不用解决了。
另一个就是hide主窗口，子窗口依然会全屏，但是hide了之后任务栏是看不见的。
再或者解决方法就是移动子窗口到主窗口显示器……

四、源码

https://gitee.com/noevilme/QtDemo/tree/master/FullScreen