【QT】自定义QWidget标题栏，可拖拽（拖拽时窗体变为normal大小），可最小/大化、关闭（图文详情）

目录

0.背景

1.详细实现

思路简介

.h文件

.cpp文件

---

0.背景

Qt + Linux；项目遇到问题，解决后特此记录

项目需要，个性化的标题栏（是个widget），在传统的三个按钮（最大化、最小化、关闭）的基础上，新增了标题栏拖拽功能，有个额外要求是：拖拽标题栏的同时，让窗口变为normal状态（非最大化，也非最小化），也就是跟网页差不多的居中效果。

我希望的窗口大小效果：最大化（1920*1080）；普通normal状态（1344*756）；最小化（0）；

我遇到的问题是：在拖拽时界面从max变为normal时，大小虽然修改为了1344*756，但如果此时我的鼠标在点击标题栏时，是在normal大小之外（如下图示意），此时变为normal后，会发现鼠标和窗体是分开的状态（按住鼠标时仍可拖动），就很怪。

排查后发现是因为【当窗口从最大化状态恢复为普通大小时，窗口的左上角位置会改变，但鼠标的全局位置保持不变】；

修改思路：在最大化状态下，记录鼠标在窗口中的相对位置比例 (xRatio, yRatio)；恢复普通窗口后，按相同比例计算鼠标在新窗口中的位置 (newX, newY)；计算窗口的新位置 newWindowPos，使得鼠标在屏幕中的绝对位置保持不变。

修改后normal时鼠标状态如下：

修改后可以保证鼠标无论点击标题栏的何处，都是可以平滑的点击、移动，鼠标不会有点击后出现在normal窗体外的效果。详细代码见下文。

1.详细实现

思路简介

就是实现3个按钮release的事件；然后重写3个protectes函数；

.h文件

#ifndef BCI_SEEG_STEER_NEW_WIDGET_H
#define BCI_SEEG_STEER_NEW_WIDGET_H#include <QWidget>
#include <QMouseEvent>
#include <QDesktopWidget>namespace Ui {
class BCI_SEEG_Steer_New_Widget;
}class BCI_SEEG_Steer_New_Widget : public QWidget
{Q_OBJECTpublic:explicit BCI_SEEG_Steer_New_Widget(QWidget *parent = nullptr);~BCI_SEEG_Steer_New_Widget();protected:void mousePressEvent(QMouseEvent *event) override;void mouseMoveEvent(QMouseEvent *event) override;void mouseReleaseEvent(QMouseEvent *event) override;private slots:void on_btn_mini_released();void on_btn_max_released();void on_btn_close_released();private:Ui::BCI_SEEG_Steer_New_Widget *ui;bool m_isDragging = false;///<拖动标题栏QPoint m_dragPosition;
};#endif // BCI_SEEG_STEER_NEW_WIDGET_H

.cpp文件

#include "BCI_SEEG_Steer_New_Widget.h"
#include "ui_BCI_SEEG_Steer_New_Widget.h"BCI_SEEG_Steer_New_Widget::BCI_SEEG_Steer_New_Widget(QWidget *parent) :QWidget(parent),ui(new Ui::BCI_SEEG_Steer_New_Widget)
{ui->setupUi(this);setWindowFlags(Qt::FramelessWindowHint);showMaximized();//初始化时先告诉widget，是最大化的状态
}BCI_SEEG_Steer_New_Widget::~BCI_SEEG_Steer_New_Widget()
{delete ui;
}//重写鼠标按下事件
void BCI_SEEG_Steer_New_Widget::mousePressEvent(QMouseEvent *event)
{///< 判断是否点击了自定义标题栏，我的ui中标题栏名字叫【title_frame】，使用时要改成你的控件，你希望鼠标在哪个区域按下时，触发可移动的事件，就改成哪个控件的名字if (event->button() == Qt::LeftButton &&childAt(event->pos()) && childAt(event->pos())->objectName() == "title_frame"){if (isMaximized()) {// 保存鼠标在屏幕中的绝对位置QPoint globalMousePos = event->globalPos();// 保存鼠标在最大化窗口中的相对位置比例qreal xRatio = (qreal)event->pos().x() / width();qreal yRatio = (qreal)event->pos().y() / height();// 恢复普通窗口并调整大小showNormal();resize(1344, 756);ui->btn_max->setIcon(QIcon(":/img/maximize windows.svg"));// 计算鼠标在新窗口中的预期位置int newX = xRatio * width();int newY = yRatio * height();// 计算窗口应该移动到的位置，使鼠标保持在同一屏幕位置QPoint newWindowPos = globalMousePos - QPoint(newX, newY);// 确保窗口不会移出屏幕QRect screenGeometry = QApplication::desktop()->availableGeometry(this);newWindowPos.setX(qMax(screenGeometry.left(),qMin(newWindowPos.x(),screenGeometry.right() - width())));newWindowPos.setY(qMax(screenGeometry.top(),qMin(newWindowPos.y(),screenGeometry.bottom() - height())));// 移动窗口到新位置move(newWindowPos);// 更新拖动位置为鼠标在窗口中的新位置m_dragPosition = QPoint(newX, newY);}else {// 普通窗口状态下直接计算偏移m_dragPosition = event->globalPos() - frameGeometry().topLeft();}m_isDragging = true;event->accept();return;}QWidget::mousePressEvent(event);
}//重写鼠标移动事件
void BCI_SEEG_Steer_New_Widget::mouseMoveEvent(QMouseEvent *event)
{///< 处理窗口拖动if (m_isDragging && (event->buttons() & Qt::LeftButton)) {move(event->globalPos() - m_dragPosition);event->accept();return;}QWidget::mouseMoveEvent(event);
}//重写鼠标释放事件
void BCI_SEEG_Steer_New_Widget::mouseReleaseEvent(QMouseEvent *event)
{Q_UNUSED(event);m_isDragging = false;
}//点击最小化按钮
void BCI_SEEG_Steer_New_Widget::on_btn_mini_released()
{showMinimized();
}//点击最大化/normal按钮
void BCI_SEEG_Steer_New_Widget::on_btn_max_released()
{if (isMaximized()) {showNormal();this->resize(1344, 756);ui->btn_max->setIcon(QIcon(":/img/maximize windows.svg"));} else {showMaximized();this->resize(1920, 1080);ui->btn_max->setIcon(QIcon(":/img/restored windows.svg"));}
}//点击关闭按钮
void BCI_SEEG_Steer_New_Widget::on_btn_close_released()
{this->close();
}

.ui文件

ui界面代码我就不附上了，相关的只有标题栏和3个按钮而已，布局如下

--END--