本文最后更新于：1 年前

实现效果

可拖拽
双击最大化
最大化后双击恢复
自定义标题栏文字和样式

源码

TitleBarWidget.cpp

#include "TitleBarWidget.h"

#define BUTTON_HEIGHT 20		// 按钮高度;
#define BUTTON_WIDTH 30			// 按钮宽度;
#define TITLE_HEIGHT 20			// 标题栏高度;

//标题栏背景色
#define colorR 250
#define colorG 250
#define colorB 250

TitleBarWidget::TitleBarWidget(QWidget* parent, QString titleContent)
	: QWidget(parent)
	, m_colorR(colorR)
	, m_colorG(colorG)
	, m_colorB(colorB)
	, m_isPressed(false)
	, m_windowBorderWidth(0)
	, m_isTransparent(false)
	, m_buttonType(ALL_BUTTON)
{
	// 初始化;
	initControl();
	initConnections();
	if (!titleContent.isEmpty())
	{
		setTitleContent(titleContent);
	}

	//记录父窗口指针
	QDockWidget* dw = qobject_cast<QDockWidget*>(parentWidget());
	Q_ASSERT(dw != 0);
	m_parentWidget = dw;
}

TitleBarWidget::~TitleBarWidget()
{

}

// 初始化控件;
void TitleBarWidget::initControl()
{
	m_pIcon = new QLabel;
	m_pTitleContent = new QLabel;

	QIcon minIcon(style()->standardPixmap(QStyle::SP_TitleBarMinButton));
	m_pButtonMin = new QPushButton(minIcon, "", this);
	m_pButtonMin->setStyleSheet(QString("background-color: rgb(%1, %2, %3);border:none;").arg(m_colorR).arg(m_colorG).arg(m_colorB));
	QIcon floatIcon(style()->standardPixmap(QStyle::SP_TitleBarNormalButton));
	m_pButtonRestore = new QPushButton(floatIcon, "", this);
	m_pButtonRestore->setStyleSheet(QString("background-color: rgb(%1, %2, %3);border:none;").arg(m_colorR).arg(m_colorG).arg(m_colorB));
	QIcon maxIcon(style()->standardPixmap(QStyle::SP_TitleBarMaxButton));
	m_pButtonMax = new QPushButton(maxIcon, "", this);
	m_pButtonMax->setStyleSheet(QString("background-color: rgb(%1, %2, %3);border:none;").arg(m_colorR).arg(m_colorG).arg(m_colorB));
	QIcon closeIcon(style()->standardPixmap(QStyle::SP_TitleBarCloseButton));
	m_pButtonClose = new QPushButton(closeIcon, "", this);
	m_pButtonClose->setStyleSheet(QString("background-color: rgb(%1, %2, %3);border:none;").arg(m_colorR).arg(m_colorG).arg(m_colorB));

	m_pButtonMin->setFixedSize(QSize(BUTTON_WIDTH, BUTTON_HEIGHT));
	m_pButtonRestore->setFixedSize(QSize(BUTTON_WIDTH, BUTTON_HEIGHT));
	m_pButtonMax->setFixedSize(QSize(BUTTON_WIDTH, BUTTON_HEIGHT));
	m_pButtonClose->setFixedSize(QSize(BUTTON_WIDTH, BUTTON_HEIGHT));

	m_pButtonMin->setToolTip(QStringLiteral("最小化"));
	m_pButtonRestore->setToolTip(QStringLiteral("向下还原"));
	m_pButtonMax->setToolTip(QStringLiteral("最大化"));
	m_pButtonClose->setToolTip(QStringLiteral("关闭"));

	QHBoxLayout* mylayout = new QHBoxLayout(this);
	mylayout->addWidget(m_pIcon);
	mylayout->addWidget(m_pTitleContent);
	mylayout->addWidget(m_pButtonMin);
	mylayout->addWidget(m_pButtonRestore);
	mylayout->addWidget(m_pButtonMax);
	mylayout->addWidget(m_pButtonClose);

	mylayout->setContentsMargins(5, 0, 0, 0);
	mylayout->setSpacing(0);

	m_pTitleContent->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
	m_pButtonRestore->setVisible(false);
	this->setFixedHeight(TITLE_HEIGHT);
	this->setWindowFlags(Qt::FramelessWindowHint);

}

// 信号槽的绑定;
void TitleBarWidget::initConnections()
{
	connect(m_pButtonRestore, SIGNAL(clicked()), this, SLOT(onButtonRestoreClicked()));
	connect(m_pButtonMin, SIGNAL(clicked()), this, SLOT(onButtonMinClicked()));
	connect(m_pButtonMax, SIGNAL(clicked()), this, SLOT(onButtonMaxClicked()));
	connect(m_pButtonClose, SIGNAL(clicked()), this, SLOT(onButtonCloseClicked()));
}

// 设置标题栏背景色,在paintEvent事件中进行绘制标题栏背景色;
// 在构造函数中给了默认值，可以外部设置颜色值改变标题栏背景色;
void TitleBarWidget::setBackgroundColor(int r, int g, int b, bool isTransparent)
{
	m_colorR = r;
	m_colorG = g;
	m_colorB = b;
	m_isTransparent = isTransparent;
	// 重新绘制（调用paintEvent事件）;
	update();
}

// 设置标题栏图标;
void TitleBarWidget::setTitleIcon(QString filePath, QSize IconSize)
{
	QPixmap titleIcon(filePath);
	m_pIcon->setPixmap(titleIcon.scaled(IconSize));
}

// 设置标题内容;
void TitleBarWidget::setTitleContent(QString titleContent, int titleFontSize)
{
	// 设置标题字体大小;
	QFont font = m_pTitleContent->font();
	font.setPointSize(titleFontSize);
	m_pTitleContent->setFont(font);
	// 设置标题内容;
	m_pTitleContent->setText(titleContent);
	m_titleContent = titleContent;
}

// 设置标题栏长度;
void TitleBarWidget::setTitleWidth(int width)
{
	this->setFixedWidth(width);
}

// 设置标题栏高度;
void TitleBarWidget::setTitleHeight(int width)
{
	this->setFixedHeight(width);
}

// 设置标题栏上按钮类型;
// 由于不同窗口标题栏上的按钮都不一样，所以可以自定义标题栏中的按钮;
// 这里提供了四个按钮，分别为最小化、还原、最大化、关闭按钮，如果需要其他按钮可自行添加设置;
void TitleBarWidget::setButtonType(ButtonType buttonType)
{
	m_buttonType = buttonType;

	switch (buttonType)
	{
		case MIN_MAX_BUTTON:
		{
			m_pButtonClose->setVisible(false);
		}
		break;
		case ONLY_CLOSE_BUTTON:
		{
			m_pButtonMin->setVisible(false);
			m_pButtonRestore->setVisible(false);
			m_pButtonMax->setVisible(false);
		}
		break;
		default:
			break;
	}
}

// 设置标题栏中的标题是否会自动滚动，跑马灯的效果;
// 一般情况下标题栏中的标题内容是不滚动的，但是既然自定义就看自己需要嘛，想怎么设计就怎么搞O(∩_∩)O！
void TitleBarWidget::setTitleRoll()
{
	connect(&m_titleRollTimer, SIGNAL(timeout()), this, SLOT(onRollTitle()));
	m_titleRollTimer.start(200);
}

// 设置窗口边框宽度;
void TitleBarWidget::setWindowBorderWidth(int borderWidth)
{
	m_windowBorderWidth = borderWidth;
}

// 保存窗口最大化前窗口的位置以及大小;
void TitleBarWidget::saveRestoreInfo(const QPoint point, const QSize size)
{
	m_restorePos = point;
	m_restoreSize = size;
}

// 获取窗口最大化前窗口的位置以及大小;
void TitleBarWidget::getRestoreInfo(QPoint& point, QSize& size)
{
	point = m_restorePos;
	size = m_restoreSize;
}

// 绘制标题栏背景色;
void TitleBarWidget::paintEvent(QPaintEvent* event)
{
	// 是否设置标题透明;
	if (!m_isTransparent)
	{
		//设置背景色;
		QPainter painter(this);
		QPainterPath pathBack;
		pathBack.setFillRule(Qt::WindingFill);
		pathBack.addRoundedRect(QRect(0, 0, this->width(), this->height()), 3, 3);
		painter.setRenderHint(QPainter::Antialiasing, true);
		painter.fillPath(pathBack, QBrush(QColor(m_colorR, m_colorG, m_colorB)));
	}

	// 当窗口最大化或者还原后，窗口长度变了，标题栏的长度应当一起改变;
	// 这里减去m_windowBorderWidth ，是因为窗口可能设置了不同宽度的边框;
	// 如果窗口有边框则需要设置m_windowBorderWidth的值，否则m_windowBorderWidth默认为0;
	if (this->width() != (this->parentWidget()->width() - m_windowBorderWidth))
	{
		this->setFixedWidth(this->parentWidget()->width() - m_windowBorderWidth);
	}
	QWidget::paintEvent(event);
}

// 双击响应事件，主要是实现双击标题栏进行最大化和最小化操作;
void TitleBarWidget::mouseDoubleClickEvent(QMouseEvent* event)
{
	if (m_buttonType != ONLY_CLOSE_BUTTON) //若设置只有关闭按钮，则不实现双击标题栏动作
	{
		if (m_pButtonMax->isVisible())
		{
			onButtonMaxClicked();
		}
		else
		{
			onButtonRestoreClicked();
		}
	}
}

//以下通过mousePressEvent、mouseMoveEvent、mouseReleaseEvent三个事件实现了鼠标拖动标题栏移动窗口的效果;
void TitleBarWidget::mousePressEvent(QMouseEvent* event)
{
	//m_isPressed = true;
	//m_startMovePos = event->globalPos();
	event->ignore();
}

void TitleBarWidget::mouseMoveEvent(QMouseEvent* event)
{
	/*if (m_isPressed)
	{
		QPoint movePoint = event->globalPos() - m_startMovePos;
		QPoint widgetPos = this->parentWidget()->pos();
		m_startMovePos = event->globalPos();
		this->parentWidget()->move(widgetPos.x() + movePoint.x(), widgetPos.y() + movePoint.y());
	}*/
	event->ignore();

}

void TitleBarWidget::mouseReleaseEvent(QMouseEvent* event)
{
	//m_isPressed = false;
	event->ignore();
}


// 以下为按钮操作响应的槽;
void TitleBarWidget::onButtonRestoreClicked()
{
	Q_ASSERT(m_parentWidget != 0);
	if (!m_parentWidget->isFloating())	//判断是否变为浮动窗口
	{
		m_parentWidget->setFloating(true);
	}

	QPoint parentWidgetPos;
	QSize parentWidgetSize;
	getRestoreInfo(parentWidgetPos, parentWidgetSize);
	m_parentWidget->setGeometry(QRect(parentWidgetPos, parentWidgetSize));

	m_pButtonRestore->setVisible(false);
	m_pButtonMax->setVisible(true);
}

void TitleBarWidget::onButtonMinClicked()
{
	Q_ASSERT(m_parentWidget != 0);
	if (m_parentWidget->isFloating())	//判断是否变为浮动窗口
	{
		m_parentWidget->setFloating(false);	//设置浮动标志为false
	}
	m_parentWidget->show(); 
	m_parentWidget->raise();

	m_pButtonRestore->setVisible(false);
	m_pButtonMax->setVisible(true);
}

void TitleBarWidget::onButtonMaxClicked()
{
	Q_ASSERT(m_parentWidget != 0);

	if (!m_parentWidget->isFloating())	//判断是否变为浮动窗口
	{
		m_parentWidget->setFloating(true);	//先将窗口设为浮动
	}

	//记录父窗口最大化之前的位置
	saveRestoreInfo(m_parentWidget->pos(), QSize(m_parentWidget->width(), m_parentWidget->height()));

	//最大化显示总是有问题，改成直接setGeometry设置大小和位置
	//m_parentWidget->showMaximized();
	//m_parentWidget->show();

	QDesktopWidget* desk = QApplication::desktop();
	QRect rect = desk->screenGeometry(desk->screenNumber(this));

	m_parentWidget->setGeometry(rect);
	m_parentWidget->show();

	m_pButtonRestore->setVisible(true);
	m_pButtonMax->setVisible(false);
}

void TitleBarWidget::onButtonCloseClicked()
{
	Q_ASSERT(m_parentWidget != 0);
	m_parentWidget->close();
}

// 该方法主要是让标题栏中的标题显示为滚动的效果;
void TitleBarWidget::onRollTitle()
{
	static int nPos = 0;
	QString titleContent = m_titleContent;
	// 当截取的位置比字符串长时，从头开始;
	if (nPos > titleContent.length())
		nPos = 0;

	m_pTitleContent->setText(titleContent.mid(nPos));
	nPos++;
}

TitleBarWidget.h

#pragma once
#include <QWidget>
#include <QDockWidget>
#include <QLabel>
#include <QPushButton>
#include <QTimer>
#include <QHBoxLayout>
#include <QPainter>
#include <QFile>
#include <QMouseEvent>
#include <QStyle>
#include <QDesktopWidget>
#include <QApplication>
#include <QDebug>

enum ButtonType
{
	MIN_MAX_BUTTON = 0,       // 最小化、最大化按钮;
	ONLY_CLOSE_BUTTON,		  // 只有关闭按钮;
	ALL_BUTTON				  // 所有按钮，最小化、最大化、关闭
};

class TitleBarWidget : public QWidget
{
	Q_OBJECT

public:
	TitleBarWidget(QWidget* parent, QString titleContent = "");
	//这里parent没有给默认值NULL，保证在创建TitleBarWidget对象时父指针必须得赋值;且赋值不为NULL;
	~TitleBarWidget();

	// 设置标题栏背景色及是否设置标题栏背景色透明;
	void setBackgroundColor(int r, int g, int b, bool isTransparent = false);
	// 设置标题栏图标;
	void setTitleIcon(QString filePath, QSize IconSize = QSize(25, 25));
	// 设置标题内容;
	void setTitleContent(QString titleContent, int titleFontSize = 9);
	// 设置标题栏长度;
	void setTitleWidth(int width);
	// 设置标题栏高度;
	void setTitleHeight(int width);
	// 设置标题栏上按钮类型;
	void setButtonType(ButtonType buttonType);
	// 设置标题栏中的标题是否会滚动;具体可以看效果;
	void setTitleRoll();
	// 设置窗口边框宽度;
	void setWindowBorderWidth(int borderWidth);

	// 保存/获取 最大化前窗口的位置及大小;
	void saveRestoreInfo(const QPoint point, const QSize size);
	void getRestoreInfo(QPoint& point, QSize& size);

private:
	void paintEvent(QPaintEvent* event);
	void mouseDoubleClickEvent(QMouseEvent* event);
	void mousePressEvent(QMouseEvent* event);
	void mouseMoveEvent(QMouseEvent* event);
	void mouseReleaseEvent(QMouseEvent* event);

	// 初始化控件;
	void initControl();
	// 信号槽的绑定;
	void initConnections();


private slots:
	// 按钮触发的槽;
	void onButtonRestoreClicked();
	void onButtonMinClicked();
	void onButtonMaxClicked();
	void onButtonCloseClicked();
	void onRollTitle();

private:
	QLabel* m_pIcon;                    // 标题栏图标;
	QLabel* m_pTitleContent;            // 标题栏内容;
	QPushButton* m_pButtonMin;          // 最小化按钮;
	QPushButton* m_pButtonRestore;      // 还原按钮
	QPushButton* m_pButtonMax;          // 最大化按钮;
	QPushButton* m_pButtonClose;        // 关闭按钮;

	// 标题栏背景色;
	int m_colorR;
	int m_colorG;
	int m_colorB;

	// 最大化，最小化变量;
	QPoint m_restorePos;
	QSize m_restoreSize;
	// 移动窗口的变量;
	bool m_isPressed;
	QPoint m_startMovePos;
	// 标题栏跑马灯效果时钟;
	QTimer m_titleRollTimer;
	// 标题栏内容;
	QString m_titleContent;
	// 窗口边框宽度;
	int m_windowBorderWidth;
	// 标题栏是否透明;
	bool m_isTransparent;
	// 父窗口指针
	QDockWidget* m_parentWidget;        
    // 按钮类型;
	ButtonType m_buttonType;
};

注意：主dock窗口需要配置setWindowFlags为FramelessWindowHint，不然会自带标题栏

mDockWidget* ZCTOOL::addDock(QString title, notpadClass* np, QString filePath)
{
    //停靠窗口
    mDockWidget* dw = new mDockWidget(title, this);
    dw->setFeatures(mDockWidget::DockWidgetMovable
        | mDockWidget::DockWidgetClosable
        | mDockWidget::DockWidgetFloatable);//可移动，可关闭, 可浮动
    dw->setAllowedAreas(Qt::AllDockWidgetAreas);
    dw->setWidget(np);
    
    //标题栏显示文件路径
    dw->setWindowFlags(Qt::FramelessWindowHint);
    TitleBarWidget* pTitleBar = new TitleBarWidget(dw, filePath);
    dw->setTitleBarWidget(pTitleBar);

    tabifyDockWidget(ui.dockWidget_2,dw);
    dw->show();
    dw->raise();

    connect(dw, &mDockWidget::close, this, [=]()
        {
            notpadPathMap.remove(np->FilePath());
            delete(np);
            delete(pTitleBar);
            removeDockWidget(dw);
        });
    return dw;
}

#QT技巧

QT-设置窗口属性上一篇

QT-QLineEdit输入校验下一篇

QT-自定义窗口标题栏

实现效果

源码