C++ Qt QMainWindow实现无边框窗口自定义标题栏可拖拽移动拉伸改变窗口大小

令狐掌门2024-04-25 6:04

本篇博客介绍C++ Qt QMainWindow实现无边框窗口，适用于win10/win11系统。

QMainWindow相对于QWidget多了dockedwidget功能，跟多人可能更喜欢用QMainWindow做主窗口，如果不需要dockedwidget功能，QMainWindow与QWidget做主窗口基本无差别。

效果图如下：

自带窗口阴影、圆角、可拉伸，拖拽。

具体实现过程如下：

一、编写无边框窗口基类CFramelessWindowBase

CFramelessWindowBase.h

cpp 复制代码 
/*

QMainWindow无边框窗口基类

可拉伸

其它QMainWindow窗口派生于该类即可

*/

#pragma once
#include <QMainWindow>

class CFramelessWindowBase : public QMainWindow
{
public:
	CFramelessWindowBase(QWidget* parent = nullptr);
	~CFramelessWindowBase();

protected:
	bool nativeEvent(const QByteArray& eventType, void* message, long* result) override;

private:
	int mouse_margin = 5;
};

CFramelessWindowBase.cpp

cpp 复制代码 
#include "CFramelessWindowBase.h"
#include <qt_windows.h>
#include <windowsx.h>
#include <QWindow>
#include <windows.h>
#include <dwmapi.h>

#pragma comment(lib, "dwmapi.lib")


CFramelessWindowBase::CFramelessWindowBase(QWidget* parent)
	: QMainWindow(parent)
{
	setWindowFlags(Qt::FramelessWindowHint | Qt::WindowMinMaxButtonsHint);
	setAttribute(Qt::WA_Hover);

	// 添加窗口阴影，窗口圆角
	HWND hWnd = reinterpret_cast<HWND>(winId());
	DWMNCRENDERINGPOLICY ncrp = DWMNCRP_ENABLED;
	::DwmSetWindowAttribute(hWnd, DWMWA_NCRENDERING_POLICY, &ncrp, sizeof(ncrp));
	MARGINS shadow = { 1, 1, 1, 1 };
	DwmExtendFrameIntoClientArea((HWND)winId(), &shadow);
}

CFramelessWindowBase::~CFramelessWindowBase()
{
}

bool CFramelessWindowBase::nativeEvent(const QByteArray& eventType, void* message, long* result)
{
	MSG* msg = static_cast<MSG*>(message);

	switch (msg->message)
	{
	case WM_NCHITTEST:
	{
		QPoint globalPos = QCursor::pos();
		int x = globalPos.x();
		int y = globalPos.y();

		//int nX = GET_X_LPARAM(param->lParam) - this->geometry().x();   // bug : windows 在高分屏下，坐标值不正确
		//int nY = GET_Y_LPARAM(param->lParam) - this->geometry().y();

		int nX = x - this->geometry().x();
		int nY = y - this->geometry().y();

		// 如果鼠标位于内部子控件上，则不进行处理
		if (nX > mouse_margin && nX < width() - mouse_margin &&
			nY > mouse_margin && nY < this->height() - mouse_margin)
		{
			if (childAt(nX, nY) != nullptr)
				return QWidget::nativeEvent(eventType, message, result);
		}

		// 鼠标区域位于窗体边框，进行缩放
		if ((nX > 0) && (nX < mouse_margin))
			*result = HTLEFT;

		if ((nX > this->width() - mouse_margin) && (nX < this->width()))
			*result = HTRIGHT;

		if ((nY > 0) && (nY < mouse_margin))
			*result = HTTOP;

		if ((nY > this->height() - mouse_margin) && (nY < this->height()))
			*result = HTBOTTOM;

		if ((nX > 0) && (nX < mouse_margin) && (nY > 0)
			&& (nY < mouse_margin))
			*result = HTTOPLEFT;

		if ((nX > this->width() - mouse_margin) && (nX < this->width())
			&& (nY > 0) && (nY < mouse_margin))
			*result = HTTOPRIGHT;

		if ((nX > 0) && (nX < mouse_margin)
			&& (nY > this->height() - mouse_margin) && (nY < this->height()))
			*result = HTBOTTOMLEFT;

		if ((nX > this->width() - mouse_margin) && (nX < this->width())
			&& (nY > this->height() - mouse_margin) && (nY < this->height()))
			*result = HTBOTTOMRIGHT;

		return true;
	}
	}

	return QWidget::nativeEvent(eventType, message, result);
}

代码解释：

（1）在CFramelessWindowBase类设置窗口标志，去掉窗口边框，设置最大最小显示效果。

cpp 复制代码 
setWindowFlags(Qt::FramelessWindowHint | Qt::WindowMinMaxButtonsHint);

（2）增加windows窗口阴影与圆角：

cpp 复制代码 
// 添加窗口阴影，窗口圆角
HWND hWnd = reinterpret_cast<HWND>(winId());
DWMNCRENDERINGPOLICY ncrp = DWMNCRP_ENABLED;
::DwmSetWindowAttribute(hWnd, DWMWA_NCRENDERING_POLICY, &ncrp, sizeof(ncrp));
MARGINS shadow = { 1, 1, 1, 1 };
DwmExtendFrameIntoClientArea((HWND)winId(), &shadow);

这里使用的是DWM API实现窗口阴影和圆角，圆角是windows窗口的圆角，不需要手动设置圆角大小。

（3）重写nativeEvent实现无边框窗口

cpp 复制代码 
bool CFramelessWindowBase::nativeEvent(const QByteArray& eventType, void* message, long* result)
{
	MSG* msg = static_cast<MSG*>(message);

	switch (msg->message)
	{
	case WM_NCHITTEST:
	{
		QPoint globalPos = QCursor::pos();
		int x = globalPos.x();
		int y = globalPos.y();

		//int nX = GET_X_LPARAM(param->lParam) - this->geometry().x();   // bug : windows 在高分屏下，坐标值不正确
		//int nY = GET_Y_LPARAM(param->lParam) - this->geometry().y();

		int nX = x - this->geometry().x();
		int nY = y - this->geometry().y();

		// 如果鼠标位于内部子控件上，则不进行处理
		if (nX > mouse_margin && nX < width() - mouse_margin &&
			nY > mouse_margin && nY < this->height() - mouse_margin)
		{
			if (childAt(nX, nY) != nullptr)
				return QWidget::nativeEvent(eventType, message, result);
		}

		// 鼠标区域位于窗体边框，进行缩放
		if ((nX > 0) && (nX < mouse_margin))
			*result = HTLEFT;

		if ((nX > this->width() - mouse_margin) && (nX < this->width()))
			*result = HTRIGHT;

		if ((nY > 0) && (nY < mouse_margin))
			*result = HTTOP;

		if ((nY > this->height() - mouse_margin) && (nY < this->height()))
			*result = HTBOTTOM;

		if ((nX > 0) && (nX < mouse_margin) && (nY > 0)
			&& (nY < mouse_margin))
			*result = HTTOPLEFT;

		if ((nX > this->width() - mouse_margin) && (nX < this->width())
			&& (nY > 0) && (nY < mouse_margin))
			*result = HTTOPRIGHT;

		if ((nX > 0) && (nX < mouse_margin)
			&& (nY > this->height() - mouse_margin) && (nY < this->height()))
			*result = HTBOTTOMLEFT;

		if ((nX > this->width() - mouse_margin) && (nX < this->width())
			&& (nY > this->height() - mouse_margin) && (nY < this->height()))
			*result = HTBOTTOMRIGHT;

		return true;
	}
	}

	return QWidget::nativeEvent(eventType, message, result);
}

二、实现主窗口

派生于上面的CFramelessWindowBase，代码如下：

FramelessWindow.h

cpp 复制代码 
#pragma once

#include <QtWidgets/QMainWindow>
#include "CFramelessWindowBase.h"
#include "TitleBar.h"
#include "ContentWidget.h"
#include "LeftBar.h"
#include "CustomStatusBar.h"

class FramelessWindow : public CFramelessWindowBase
{
    Q_OBJECT

public:
    FramelessWindow(QWidget *parent = nullptr);
    ~FramelessWindow();

private slots:
    void OnClose();

private:
    TitleBar* m_pTitleBar = nullptr;
    ContentWidget* m_pContentWidget = nullptr;
    LeftBar* m_pLeftBar = nullptr;
    CustomStatusBar* m_pStatusBar = nullptr;
};

FramelessWindow.cpp

cpp 复制代码 
/*

主窗口

*/

#include "FramelessWindow.h"
#include <QVBoxLayout>
#include <QMessageBox>


FramelessWindow::FramelessWindow(QWidget *parent)
    : CFramelessWindowBase(parent)
{
    this->resize(800, 600);

    QWidget* pWidget = new QWidget(this);
    this->setCentralWidget(pWidget);

    m_pTitleBar = new TitleBar(pWidget);
    m_pTitleBar->SetTitleText(tr("QMainWindow Custom Title"));

    QString logo_qss = R"(
		QLabel{
			background-image:url(:/TitleBar/Resources/TitleBar/logo32.svg);
			background-position:center; 
			background-repeat: no-repeat;
			border:none
		}
	)";

    m_pTitleBar->SetTitleIcon(logo_qss);

    m_pContentWidget = new ContentWidget(pWidget);

    m_pLeftBar = new LeftBar(pWidget);
    m_pStatusBar = new CustomStatusBar(pWidget);

    QVBoxLayout* pVLay = new QVBoxLayout(pWidget);
    pVLay->setSpacing(0);
    pVLay->setContentsMargins(0, 0, 0, 0);

    pVLay->addWidget(m_pTitleBar);

    QHBoxLayout* pHLay = new QHBoxLayout(pWidget);
    pHLay->setSpacing(0);
    pHLay->addWidget(m_pLeftBar);
    pHLay->addWidget(m_pContentWidget);

    pVLay->addLayout(pHLay);
    pVLay->addWidget(m_pStatusBar);

    pWidget->setLayout(pVLay);

    connect(m_pTitleBar, &TitleBar::sig_Close, this, &FramelessWindow::OnClose);
}

FramelessWindow::~FramelessWindow()
{
}

void FramelessWindow::OnClose()
{
    QMessageBox::StandardButton resBtn = QMessageBox::question(this, tr("Tips"),
        tr("Are you sure you want to close the window?"),
        QMessageBox::Cancel | QMessageBox::Yes,
        QMessageBox::Yes);

    if (resBtn == QMessageBox::Yes) 
    {
        close();
    }
}

本篇博客源码下载：
https://download.csdn.net/download/yao_hou/89211306?spm=1001.2014.3001.5501

相关推荐
knighthood20013 分钟前
解决：ros进行gazebo仿真，rviz没有显示传感器数据
c++·ubuntu·ros
半盏茶香32 分钟前
【C语言】分支和循环详解（下）猜数字游戏
c语言·开发语言·c++·算法·游戏
小堇不是码农38 分钟前
在VScode中配置C_C++环境
c语言·c++·vscode
Jack黄从零学c++41 分钟前
C++ 的异常处理详解
c++·经验分享
捕鲸叉6 小时前
创建线程时传递参数给线程
开发语言·c++·算法
A charmer6 小时前
【C++】vector 类深度解析：探索动态数组的奥秘
开发语言·c++·算法
Peter_chq6 小时前
【操作系统】基于环形队列的生产消费模型
linux·c语言·开发语言·c++·后端
青花瓷8 小时前
C++__XCode工程中Debug版本库向Release版本库的切换
c++·xcode
幺零九零零9 小时前
【C++】socket套接字编程
linux·服务器·网络·c++
捕鲸叉9 小时前
MVC（Model-View-Controller）模式概述
开发语言·c++·设计模式
热门推荐
01【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总02(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明03组基轨迹建模 GBTM的介绍与实现（Stata 或 R）04【AIGC】重塑未来的科技巨轮05全面解析：构建基于深度学习的安全帽检测系统（UI界面+YOLO代码+数据集）06【经验分享】Ubuntu22.04安装微信(linux官方版)07基于YOLOv10深度学习的CT扫描图像肾结石智能检测系统【python源码+Pyqt5界面+数据集+训练代码】深度学习实战、目标检测08Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO09RAG 实践- Ollama+RagFlow 部署本地知识库10红米手机使用google play