devbox
Gausst松鼠会
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

QT快速开发自定义标题栏_qt如何把标题栏重新绘制

作者：Gausst松鼠会 | 2024-03-14 13:53:00

赞

踩

qt如何把标题栏重新绘制

前言

大家在用QT进行客户端开发的时候，难免都会觉得原生的QT窗口标题栏很丑，希望能自绘漂亮的标题栏，实现方法其实也比较简单，网上资料也挺多，方法基本都差不多，不过我觉得不够简洁，对此我特地封装总结了一个最高效快捷的方法，3分钟实现一个自绘制标题栏，包含：左上角图标、标题、按钮、双击标题栏、最大化时候拖拽缩小、菜单栏等功能。

效果

方法

1、目标窗口添加标题栏、最大化最小化关闭按钮（该步最好每次使用时，从模板程序中直接复制）

2、窗口基类从QDialog改为QFramelessDialog，如果是QWidget的话，请参考QFramelessDialog自行编写QFramelessWidget即可，非常简单，只需要将QDialog改成QWidget即可，至于为什么我写程序更喜欢用QDialog而不是QWidget，主要原因是QDialog默认自带外边框，设置外边框更简单，而QWidget设置外边框比较麻烦，必须在ui中将边框宽度pad预留出来。

3、窗口构造函数中，调用无边框窗体初始化函数，头文件中已经写好几个宏函数直接调用即可，使用宏的情况下，必须保证标题栏、按钮对象名称一致，注意调用初始化函数一定要在ui.setupUi(this);后面。

核心初始化函数

  1. 	void Init(QWidget *widget_title, 		//标题栏对象
  2. 			  QPushButton *menuButton_Close,//关闭按钮 
  3. 			  QPushButton *menuButton_Max,	//最大化按钮
  4. 			  QPushButton *menuButton_Min,	//最小化按钮
  5. 			  bool bResize,					//窗体支持resize
  6. 			  bool bMinHide,				//点击close按钮时隐藏窗口，通常用在主窗口中
  7. 			  bool bConnectClose);			//当bMinHide为true时，是否自动处理隐藏

宏解释：

FRAMELESS_DIALOG_INIT    模态对话框（只有关闭按钮）

FRAMELESS_MAIN_DIALOG_INIT   常用主窗口（包含最大化 、最小化、关闭按钮、可resize）

关于Demo中qss样式、编辑可参考作者早期博文《QT-智能QSS设计器》

https://blog.csdn.net/redchairman/article/details/82012984

代码

  1. #ifndef QFRAMELESSDIALOG_H
  2. #define QFRAMELESSDIALOG_H
  3.  
  4. #include <QDialog>
  5.  
  6. class QFramelessDialog : public QDialog
  7. {
  8. 	Q_OBJECT
  9.  
  10. public:
  11. 	QFramelessDialog(QWidget *parent);
  12. 	~QFramelessDialog();
  13.  
  14. 	void Init(QWidget *widget_title, 
  15. 			  QPushButton *menuButton_Close, 
  16. 			  QPushButton *menuButton_Max,
  17. 			  QPushButton *menuButton_Min,
  18. 			  bool bResize,
  19. 			  bool bMinClose,
  20. 			  bool bConnectClose);
  21.  
  22. 	void setResizeable(bool resizeable);
  23. 	virtual void CloseDialog();
  24. private:
  25. 	bool m_bMaximized;
  26. 	bool m_bMoveable;
  27. 	QPoint dragPosition;
  28. 	QRect m_rcNormal;
  29.  
  30. protected:
  31. 	void mouseMoveEvent(QMouseEvent *e);
  32. 	void mousePressEvent(QMouseEvent *e);
  33. 	void mouseReleaseEvent(QMouseEvent *);
  34. 	void mouseDoubleClickEvent(QMouseEvent *event);
  35.  
  36. 	bool nativeEvent(const QByteArray & eventType, void * message, long * result);
  37.  
  38. 	void paintEvent(QPaintEvent *event);
  39.  
  40. 	void keyPressEvent(QKeyEvent* e);
  41.  
  42. public slots:
  43. /*	void sltCloseClick();*/
  44. 	void sltClickMin();
  45. 	void sltClickMaxRestore();
  46. 	void sltCloseDialog();
  47.  
  48. public:
  49. 	bool m_bResize;
  50. 	QPushButton *m_menuButton_Close;
  51. 	QPushButton *m_menuButton_Max;
  52. 	QPushButton *m_menuButton_Min;
  53. 	QWidget *m_widget_title;
  54. 	bool m_bMinClose;
  55. 	bool m_bConnectClose;
  56. };
  57.  
  58. #define FRAMELESS_DIALOG_INIT() Init(ui.widget_title, ui.menuButton_Close, nullptr, nullptr, false, false, true)
  59. #define FRAMELESS_MAIN_DIALOG_INIT() Init(ui.widget_title, ui.menuButton_Close, ui.menuButton_Max, ui.menuButton_Min, true, true, true)
  60. #define FRAMELESS_MAIN_DIALOG_NOCLOSE_INIT() Init(ui.widget_title, ui.menuButton_Close, ui.menuButton_Max, ui.menuButton_Min, true, true, false)
  61.  
  62. #define FRAMELESS_DIALOG_INIT2() Init(ui->widget_title, ui->menuButton_Close, nullptr, nullptr, false, false, true)
  63. #define FRAMELESS_MAIN_DIALOG_INIT2() Init(ui->widget_title, ui->menuButton_Close, ui->menuButton_Max, ui->menuButton_Min, true, true, true)
  64. #define FRAMELESS_MAIN_DIALOG_NOCLOSE_INIT2() Init(ui->widget_title, ui->menuButton_Close, ui->menuButton_Max, ui->menuButton_Min, true, true, false)
  65.  
  66.  
  67.  
  68.  
  69. #endif // QFRAMELESSDIALOG_H

 

  1. #include "stdafx.h"
  2. #include "QFramelessDialog.h"
  3. #include "QIconHelper.hpp"
  4.  
  5. QFramelessDialog::QFramelessDialog(QWidget *parent)
  6. 	: QDialog(parent)
  7. 	, m_bMaximized(false)
  8. 	, m_bMoveable(false)
  9. 	, m_bResize(false)
  10. 	, m_menuButton_Close(nullptr)
  11. 	, m_menuButton_Max(nullptr)
  12. 	, m_menuButton_Min(nullptr)
  13. 	, m_widget_title(nullptr)
  14. 	, m_bMinClose(false)
  15. {
  16. /*	setAttribute(Qt::WA_TranslucentBackground);*/
  17. 	setWindowFlags(Qt::FramelessWindowHint | Qt::Dialog | Qt::WindowMinMaxButtonsHint);
  18. 	setWindowModality(Qt::WindowModal);
  19. 	setFocusPolicy(Qt::ClickFocus);
  20. }
  21.  
  22. QFramelessDialog::~QFramelessDialog()
  23. {
  24.  
  25. }
  26.  
  27. void QFramelessDialog::Init(QWidget *widget_title, 
  28. 							QPushButton *menuButton_Close, 
  29. 							QPushButton *menuButton_Max,
  30. 							QPushButton *menuButton_Min,
  31. 							bool bResize,
  32. 							bool bMinClose,
  33. 							bool bConnectClose)
  34. {
  35. 	m_bResize = bResize;
  36. 	m_bMinClose = bMinClose;
  37. 	m_bConnectClose = bConnectClose;
  38. 	m_menuButton_Min = menuButton_Min;
  39. 	m_menuButton_Max = menuButton_Max;
  40. 	m_menuButton_Close = menuButton_Close;
  41. 	m_widget_title = widget_title;
  42. 	
  43. 	if (m_menuButton_Close)
  44. 	{
  45. 		m_menuButton_Close->setFocusPolicy(Qt::ClickFocus);
  46. 		QIconHelper::SetIcon(m_menuButton_Close, QChar(0xf00d), 12);
  47. 		if (m_bMinClose)
  48. 		{
  49. 			if (m_bConnectClose)
  50. 			{
  51. 				connect(m_menuButton_Close, SIGNAL(clicked()), this, SLOT(hide()));
  52. 			}
  53. 		}
  54. 		else
  55. 		{
  56. 			connect(m_menuButton_Close, SIGNAL(clicked()), this, SLOT(sltCloseDialog()));
  57. 		}
  58. 	}
  59. 	if (m_menuButton_Max)
  60. 	{
  61. 		m_menuButton_Max->setFocusPolicy(Qt::ClickFocus);
  62. 		QIconHelper::SetIcon(m_menuButton_Max, QChar(0xf096), 12);
  63. 		connect(m_menuButton_Max, SIGNAL(clicked()), this, SLOT(sltClickMaxRestore()));
  64. 	}
  65. 	if (m_menuButton_Min)
  66. 	{
  67. 		m_menuButton_Min->setFocusPolicy(Qt::ClickFocus);
  68. 		QIconHelper::SetIcon(m_menuButton_Min, QChar(0xf068), 12);
  69. 		connect(m_menuButton_Min, SIGNAL(clicked()), this, SLOT(sltClickMin()));
  70. 	}
  71.  
  72. 	return;
  73. }
  74.  
  75. void QFramelessDialog::CloseDialog()
  76. {
  77. 	close();
  78. }
  79.  
  80. void QFramelessDialog::sltCloseDialog()
  81. {
  82. 	CloseDialog();
  83. }
  84.  
  85. void QFramelessDialog::mousePressEvent(QMouseEvent *event)
  86. {
  87. 	if (isFullScreen())
  88. 	{
  89. 		return;
  90. 	}
  91.  
  92.     if (event->button() == Qt::LeftButton && m_widget_title)
  93. 	{
  94. 		dragPosition = event->globalPos() - frameGeometry().topLeft();
  95.  
  96. 		QRect rect = m_widget_title->rect();
  97. 		if (rect.contains(event->pos()))
  98. 		{
  99. 			m_bMoveable = true;
  100. 		}
  101. 	}
  102. 	event->accept();
  103. }
  104.  
  105. void QFramelessDialog::mouseMoveEvent(QMouseEvent *event)
  106. {
  107. 	if (isFullScreen())
  108. 	{
  109. 		return;
  110. 	}
  111.  
  112. 	if (event->buttons() & Qt::LeftButton && m_bMoveable)
  113. 	{
  114. 		if (isMaximized())
  115. 		{
  116. 			int nWidth = m_rcNormal.width();
  117. 			int nHeight = m_rcNormal.height();
  118.  
  119. 			float fx = (float)event->pos().x() / (float)rect().width();
  120. 			//屏幕大小
  121. 			int old_x = m_rcNormal.width() * fx + m_rcNormal.left();
  122. 			int old_y = m_rcNormal.top() + event->pos().y();
  123.  
  124. 			QPoint pt_new(m_rcNormal.left() + event->globalPos().x() - old_x, m_rcNormal.top() + event->globalPos().y() - old_y);
  125. 			m_rcNormal.moveTopLeft(pt_new);
  126. 			sltClickMaxRestore();
  127. 			//m_rcNormal
  128. 			dragPosition = event->globalPos() - frameGeometry().topLeft();
  129. 		}
  130. 		else
  131. 		{
  132. 			move(event->globalPos() - dragPosition);
  133. 		}
  134. 	}
  135. 	event->accept();
  136.  
  137. }
  138.  
  139. void QFramelessDialog::mouseReleaseEvent(QMouseEvent *event)
  140. {
  141. 	if (isFullScreen())
  142. 	{
  143. 		return;
  144. 	}
  145. 	if (m_bMoveable)
  146. 	{
  147. 		m_bMoveable = false;
  148. 	}
  149. 	event->accept();
  150. }
  151.  
  152. void QFramelessDialog::mouseDoubleClickEvent(QMouseEvent *event)
  153. {
  154. 	if (m_bResize == false)
  155. 	{
  156. 		return;
  157. 	}
  158. 	if (m_menuButton_Max == nullptr || m_menuButton_Min == nullptr)
  159. 	{
  160. 		return;
  161. 	}
  162. 	if (isFullScreen())
  163. 	{
  164. 		return;
  165. 	}
  166.     if (event->buttons() & Qt::LeftButton && m_widget_title)
  167. 	{
  168. 		QRect rect = m_widget_title->rect();
  169. 		if (rect.contains(event->pos()))
  170. 		{
  171. 			sltClickMaxRestore();
  172. 		}
  173. 	}
  174. 	event->accept();
  175. }
  176.  
  177. void QFramelessDialog::sltClickMin()
  178. {
  179. 	showMinimized();
  180. }
  181.  
  182. void QFramelessDialog::sltClickMaxRestore()
  183. {
  184. 	if (isMaximized())
  185. 	{
  186. 		showNormal();
  187. 		setGeometry(m_rcNormal);
  188. 		qDebug() << m_rcNormal;
  189.  
  190. 		QIconHelper::SetIcon(m_menuButton_Max, QChar(0xf096), 10);
  191. 		m_menuButton_Max->setToolTip(QStringLiteral("最大化"));
  192. 	}
  193. 	else
  194. 	{
  195. 		m_rcNormal = geometry();
  196. 		showMaximized();
  197.  
  198. 		QIconHelper::SetIcon(m_menuButton_Max, QChar(0xf079), 10);
  199. 		m_menuButton_Max->setToolTip(QStringLiteral("还原"));
  200. 	}
  201. }
  202.  
  203. bool QFramelessDialog::nativeEvent(const QByteArray & eventType, void * message, long * result)
  204. {
  205. 	Q_UNUSED(eventType);
  206. 	const int HIT_BORDER = 4;
  207. 	const MSG *msg = static_cast<MSG*>(message);
  208.  
  209. 	if (msg->message == WM_NCCALCSIZE)
  210. 	{
  211. 		*result = 0;
  212. 		return true;
  213. 	}
  214. 	else if (msg->message == WM_NCHITTEST)
  215. 	{
  216. 		if (m_bResize == false || m_widget_title == nullptr)
  217. 		{
  218. 			return QDialog::nativeEvent(eventType, message, result);
  219. 		}
  220.  
  221. 		if (isMaximized())
  222. 		{
  223. 			return false;
  224. 		}
  225. 		int xPos = ((int)(short)LOWORD(msg->lParam)) - this->frameGeometry().x();
  226. 		int yPos = ((int)(short)HIWORD(msg->lParam)) - this->frameGeometry().y();
  227.  
  228. 		if (xPos >= 0 && xPos < HIT_BORDER && yPos >= 0 && yPos < HIT_BORDER) {
  229. 			*result = HTTOPLEFT;
  230. 			return true;
  231. 		}
  232. 		if (xPos >(this->width() - HIT_BORDER) && xPos < (this->width() - 0) && yPos > 0 && yPos < HIT_BORDER) {
  233. 			*result = HTTOPRIGHT;
  234. 			return true;
  235. 		}
  236. 		if (xPos > 0 && xPos < HIT_BORDER && yPos >(this->height() - HIT_BORDER) && yPos < (this->height() - 0)) {
  237. 			*result = HTBOTTOMLEFT;
  238. 			return true;
  239. 		}
  240. 		if (xPos >(this->width() - HIT_BORDER) && xPos < (this->width() - 0) && yPos >(this->height() - HIT_BORDER) && yPos < (this->height() - 0)) {
  241. 			*result = HTBOTTOMRIGHT;
  242. 			return true;
  243. 		}
  244. 		if (xPos >= 0 && xPos < HIT_BORDER) {
  245. 			*result = HTLEFT;
  246. 			return true;
  247. 		}
  248. 		if (xPos >(this->width() - HIT_BORDER) && xPos < (this->width() - 0)) {
  249. 			*result = HTRIGHT;
  250. 			return true;
  251. 		}
  252. 		if (yPos >= 0 && yPos < HIT_BORDER) {
  253. 			*result = HTTOP;
  254. 			return true;
  255. 		}
  256. 		if (yPos >(this->height() - HIT_BORDER) && yPos < (this->height() - 0)) {
  257. 			*result = HTBOTTOM;
  258. 			return true;
  259. 		}
  260. 		if (m_widget_title->geometry().contains(QPoint(xPos, yPos)))
  261. 		{
  262. 			*result = HTCAPTION;
  263. 			return false;
  264. 		}
  265. 		return false;
  266. 	}
  267. 	return false;
  268. }
  269.  
  270. #define SHADOW_BORDER 6
  271. void QFramelessDialog::paintEvent(QPaintEvent *event)
  272. {
  273. 	return QDialog::paintEvent(event);
  274. // 
  275. // 	QPainterPath path;
  276. // 	path.setFillRule(Qt::WindingFill);
  277. // 	path.addRect(SHADOW_BORDER, SHADOW_BORDER, this->width()-2*SHADOW_BORDER, this->height()-2*SHADOW_BORDER);
  278. // 
  279. // 	QPainter painter(this);
  280. // 	painter.setRenderHint(QPainter::Antialiasing, true);
  281. // 	painter.fillPath(path, QBrush(Qt::white));
  282. // 
  283. // 	QColor color(0, 0, 0, 60);
  284. // 	for(int i=0; i<SHADOW_BORDER; i++)
  285. // 	{
  286. // 		QPainterPath path;
  287. // 		path.setFillRule(Qt::WindingFill);
  288. // 		path.addRect(SHADOW_BORDER-1-i, SHADOW_BORDER-1-i, this->width()-(SHADOW_BORDER-i)*2, this->height()-(SHADOW_BORDER-i)*2);
  289. // 		color.setAlpha(40 - i * 7);
  290. // 		painter.setPen(color);
  291. // 		painter.drawPath(path);
  292. // 	}
  293. }
  294.  
  295. void QFramelessDialog::keyPressEvent(QKeyEvent* e)
  296. {
  297. 	qDebug()<<e->key();
  298. 	switch (e->key())
  299. 	{
  300. 	case Qt::Key_Return:
  301. 		break;
  302. 	case Qt::Key_Enter:
  303. 		break;
  304. 	case Qt::Key_Escape:
  305. 		{
  306. 			if (m_bMinClose)
  307. 				break;
  308. 		}
  309. 	default:
  310. 		QDialog::keyPressEvent(e);
  311. 	}
  312. }
  313.

调用示例：

  1. #include <QDialog>
  2. #include "ui_QSubDialog.h"
  3. #include "QFramelessDialog.h"
  4.  
  5. class QSubDialog : public QFramelessDialog
  6. {
  7. 	Q_OBJECT
  8.  
  9. public:
  10. 	QSubDialog(QWidget *parent = 0);
  11. 	~QSubDialog();
  12.  
  13. private:
  14. 	Ui::QSubDialog ui;
  15. };
  1. #include "stdafx.h"
  2. #include "QSubDialog.h"
  3.  
  4. QSubDialog::QSubDialog(QWidget *parent)
  5. 	: QFramelessDialog(parent)
  6. {
  7. 	ui.setupUi(this);
  8. 	FRAMELESS_DIALOG_INIT();
  9. }
  10.  
  11. QSubDialog::~QSubDialog()
  12. {
  13.  
  14. }

源代码下载

https://download.csdn.net/download/redchairman/12914480

QT实战派交流群

群号码：1149411109

群名称：Qt实战派学习群

 

 

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/Gausst松鼠会/article/detail/234953
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号