QT快速开发自定义标题栏

前言

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

效果

方法

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

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

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

核心初始化函数

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


宏解释&＃xff1a;

FRAMELESS_DIALOG_INIT    模态对话框&＃xff08;只有关闭按钮&＃xff09;

FRAMELESS_MAIN_DIALOG_INIT   常用主窗口&＃xff08;包含最大化 、最小化、关闭按钮、可resize&＃xff09;

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

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

代码

#ifndef QFRAMELESSDIALOG_H
#define QFRAMELESSDIALOG_H#include class QFramelessDialog : public QDialog
{Q_OBJECTpublic:QFramelessDialog(QWidget *parent);~QFramelessDialog();void Init(QWidget *widget_title, QPushButton *menuButton_Close, QPushButton *menuButton_Max,QPushButton *menuButton_Min,bool bResize,bool bMinClose,bool bConnectClose);void setResizeable(bool resizeable);virtual void CloseDialog();
private:bool m_bMaximized;bool m_bMoveable;QPoint dragPosition;QRect m_rcNormal;protected:void mouseMoveEvent(QMouseEvent *e);void mousePressEvent(QMouseEvent *e);void mouseReleaseEvent(QMouseEvent *);void mouseDoubleClickEvent(QMouseEvent *event);bool nativeEvent(const QByteArray & eventType, void * message, long * result);void paintEvent(QPaintEvent *event);void keyPressEvent(QKeyEvent* e);public slots:
/* void sltCloseClick();*/void sltClickMin();void sltClickMaxRestore();void sltCloseDialog();public:bool m_bResize;QPushButton *m_menuButton_Close;QPushButton *m_menuButton_Max;QPushButton *m_menuButton_Min;QWidget *m_widget_title;bool m_bMinClose;bool m_bConnectClose;
};#define FRAMELESS_DIALOG_INIT() Init(ui.widget_title, ui.menuButton_Close, nullptr, nullptr, false, false, true)
#define FRAMELESS_MAIN_DIALOG_INIT() Init(ui.widget_title, ui.menuButton_Close, ui.menuButton_Max, ui.menuButton_Min, true, true, true)
#define FRAMELESS_MAIN_DIALOG_NOCLOSE_INIT() Init(ui.widget_title, ui.menuButton_Close, ui.menuButton_Max, ui.menuButton_Min, true, true, false)#define FRAMELESS_DIALOG_INIT2() Init(ui->widget_title, ui->menuButton_Close, nullptr, nullptr, false, false, true)
#define FRAMELESS_MAIN_DIALOG_INIT2() Init(ui->widget_title, ui->menuButton_Close, ui->menuButton_Max, ui->menuButton_Min, true, true, true)
#define FRAMELESS_MAIN_DIALOG_NOCLOSE_INIT2() Init(ui->widget_title, ui->menuButton_Close, ui->menuButton_Max, ui->menuButton_Min, true, true, false)#endif // QFRAMELESSDIALOG_H


#include "stdafx.h"
#include "QFramelessDialog.h"
#include "QIconHelper.hpp"QFramelessDialog::QFramelessDialog(QWidget *parent): QDialog(parent), m_bMaximized(false), m_bMoveable(false), m_bResize(false), m_menuButton_Close(nullptr), m_menuButton_Max(nullptr), m_menuButton_Min(nullptr), m_widget_title(nullptr), m_bMinClose(false)
{
/* setAttribute(Qt::WA_TranslucentBackground);*/setWindowFlags(Qt::FramelessWindowHint | Qt::Dialog | Qt::WindowMinMaxButtonsHint);setWindowModality(Qt::WindowModal);setFocusPolicy(Qt::ClickFocus);
}QFramelessDialog::~QFramelessDialog()
{}void QFramelessDialog::Init(QWidget *widget_title, QPushButton *menuButton_Close, QPushButton *menuButton_Max,QPushButton *menuButton_Min,bool bResize,bool bMinClose,bool bConnectClose)
{m_bResize &＃61; bResize;m_bMinClose &＃61; bMinClose;m_bConnectClose &＃61; bConnectClose;m_menuButton_Min &＃61; menuButton_Min;m_menuButton_Max &＃61; menuButton_Max;m_menuButton_Close &＃61; menuButton_Close;m_widget_title &＃61; widget_title;if (m_menuButton_Close){m_menuButton_Close->setFocusPolicy(Qt::ClickFocus);QIconHelper::SetIcon(m_menuButton_Close, QChar(0xf00d), 12);if (m_bMinClose){if (m_bConnectClose){connect(m_menuButton_Close, SIGNAL(clicked()), this, SLOT(hide()));}}else{connect(m_menuButton_Close, SIGNAL(clicked()), this, SLOT(sltCloseDialog()));}}if (m_menuButton_Max){m_menuButton_Max->setFocusPolicy(Qt::ClickFocus);QIconHelper::SetIcon(m_menuButton_Max, QChar(0xf096), 12);connect(m_menuButton_Max, SIGNAL(clicked()), this, SLOT(sltClickMaxRestore()));}if (m_menuButton_Min){m_menuButton_Min->setFocusPolicy(Qt::ClickFocus);QIconHelper::SetIcon(m_menuButton_Min, QChar(0xf068), 12);connect(m_menuButton_Min, SIGNAL(clicked()), this, SLOT(sltClickMin()));}return;
}void QFramelessDialog::CloseDialog()
{close();
}void QFramelessDialog::sltCloseDialog()
{CloseDialog();
}void QFramelessDialog::mousePressEvent(QMouseEvent *event)
{if (isFullScreen()){return;}if (event->button() &＃61;&＃61; Qt::LeftButton && m_widget_title){dragPosition &＃61; event->globalPos() - frameGeometry().topLeft();QRect rect &＃61; m_widget_title->rect();if (rect.contains(event->pos())){m_bMoveable &＃61; true;}}event->accept();
}void QFramelessDialog::mouseMoveEvent(QMouseEvent *event)
{if (isFullScreen()){return;}if (event->buttons() & Qt::LeftButton && m_bMoveable){if (isMaximized()){int nWidth &＃61; m_rcNormal.width();int nHeight &＃61; m_rcNormal.height();float fx &＃61; (float)event->pos().x() / (float)rect().width();//屏幕大小int old_x &＃61; m_rcNormal.width() * fx &＃43; m_rcNormal.left();int old_y &＃61; m_rcNormal.top() &＃43; event->pos().y();QPoint pt_new(m_rcNormal.left() &＃43; event->globalPos().x() - old_x, m_rcNormal.top() &＃43; event->globalPos().y() - old_y);m_rcNormal.moveTopLeft(pt_new);sltClickMaxRestore();//m_rcNormaldragPosition &＃61; event->globalPos() - frameGeometry().topLeft();}else{move(event->globalPos() - dragPosition);}}event->accept();}void QFramelessDialog::mouseReleaseEvent(QMouseEvent *event)
{if (isFullScreen()){return;}if (m_bMoveable){m_bMoveable &＃61; false;}event->accept();
}void QFramelessDialog::mouseDoubleClickEvent(QMouseEvent *event)
{if (m_bResize &＃61;&＃61; false){return;}if (m_menuButton_Max &＃61;&＃61; nullptr || m_menuButton_Min &＃61;&＃61; nullptr){return;}if (isFullScreen()){return;}if (event->buttons() & Qt::LeftButton && m_widget_title){QRect rect &＃61; m_widget_title->rect();if (rect.contains(event->pos())){sltClickMaxRestore();}}event->accept();
}void QFramelessDialog::sltClickMin()
{showMinimized();
}void QFramelessDialog::sltClickMaxRestore()
{if (isMaximized()){showNormal();setGeometry(m_rcNormal);qDebug() <setToolTip(QStringLiteral("最大化"));}else{m_rcNormal &＃61; geometry();showMaximized();QIconHelper::SetIcon(m_menuButton_Max, QChar(0xf079), 10);m_menuButton_Max->setToolTip(QStringLiteral("还原"));}
}bool QFramelessDialog::nativeEvent(const QByteArray & eventType, void * message, long * result)
{Q_UNUSED(eventType);const int HIT_BORDER &＃61; 4;const MSG *msg &＃61; static_cast(message);if (msg->message &＃61;&＃61; WM_NCCALCSIZE){*result &＃61; 0;return true;}else if (msg->message &＃61;&＃61; WM_NCHITTEST){if (m_bResize &＃61;&＃61; false || m_widget_title &＃61;&＃61; nullptr){return QDialog::nativeEvent(eventType, message, result);}if (isMaximized()){return false;}int xPos &＃61; ((int)(short)LOWORD(msg->lParam)) - this->frameGeometry().x();int yPos &＃61; ((int)(short)HIWORD(msg->lParam)) - this->frameGeometry().y();if (xPos >&＃61; 0 && xPos &＃61; 0 && yPos (this->width() - HIT_BORDER) && xPos <(this->width() - 0) && yPos > 0 && yPos 0 && xPos (this->height() - HIT_BORDER) && yPos <(this->height() - 0)) {*result &＃61; HTBOTTOMLEFT;return true;}if (xPos >(this->width() - HIT_BORDER) && xPos <(this->width() - 0) && yPos >(this->height() - HIT_BORDER) && yPos <(this->height() - 0)) {*result &＃61; HTBOTTOMRIGHT;return true;}if (xPos >&＃61; 0 && xPos (this->width() - HIT_BORDER) && xPos <(this->width() - 0)) {*result &＃61; HTRIGHT;return true;}if (yPos >&＃61; 0 && yPos (this->height() - HIT_BORDER) && yPos <(this->height() - 0)) {*result &＃61; HTBOTTOM;return true;}if (m_widget_title->geometry().contains(QPoint(xPos, yPos))){*result &＃61; HTCAPTION;return false;}return false;}return false;
}#define SHADOW_BORDER 6
void QFramelessDialog::paintEvent(QPaintEvent *event)
{return QDialog::paintEvent(event);
//
// QPainterPath path;
// path.setFillRule(Qt::WindingFill);
// path.addRect(SHADOW_BORDER, SHADOW_BORDER, this->width()-2*SHADOW_BORDER, this->height()-2*SHADOW_BORDER);
//
// QPainter painter(this);
// painter.setRenderHint(QPainter::Antialiasing, true);
// painter.fillPath(path, QBrush(Qt::white));
//
// QColor color(0, 0, 0, 60);
// for(int i&＃61;0; i// {
// QPainterPath path;
// path.setFillRule(Qt::WindingFill);
// path.addRect(SHADOW_BORDER-1-i, SHADOW_BORDER-1-i, this->width()-(SHADOW_BORDER-i)*2, this->height()-(SHADOW_BORDER-i)*2);
// color.setAlpha(40 - i * 7);
// painter.setPen(color);
// painter.drawPath(path);
// }
}void QFramelessDialog::keyPressEvent(QKeyEvent* e)
{qDebug()<key();switch (e->key()){case Qt::Key_Return:break;case Qt::Key_Enter:break;case Qt::Key_Escape:{if (m_bMinClose)break;}default:QDialog::keyPressEvent(e);}
}

调用示例&＃xff1a;

#include
#include "ui_QSubDialog.h"
#include "QFramelessDialog.h"class QSubDialog : public QFramelessDialog
{Q_OBJECTpublic:QSubDialog(QWidget *parent &＃61; 0);~QSubDialog();private:Ui::QSubDialog ui;
};

#include "stdafx.h"
#include "QSubDialog.h"QSubDialog::QSubDialog(QWidget *parent): QFramelessDialog(parent)
{ui.setupUi(this);FRAMELESS_DIALOG_INIT();
}QSubDialog::~QSubDialog()
{}


源代码下载

QT实战派交流群

群号码&＃xff1a;1149411109

群名称&＃xff1a;Qt实战派学习群