Qt 自定义通用标题栏TitleBar类

已于 2024-08-09 17:06:15 修改
阅读量481 收藏 5
点赞数 4
分类专栏： qt 文章标签： qt 开发语言
于 2024-08-09 16:58:16 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/JinhuCheng/article/details/141063182
版权

Qt自定义通用标题栏TitleBar类

功能

  • 自定义 Qt 通用标题栏，包含图标、标题、最小化、最大化、关闭；
  • 支持设置最小化、最大化是否显示和是否可用；
  • 支持拖动窗口;
  • 图标、最小化、最大化、关闭控件的样式，支持通过应用程序的QSS文件设置，也可以通过修改TitleBar类的构造函数实现。

效果

在这里插入图片描述

实现

  • 自定义TitleBar类继承自QWidget
  • TitleBar类构造函数
    TitleBar(QString title, QWidget* parent);
    说明：title 用来设置标题
  • TitleBar类声明signals
    • void setMinEnabled(bool enable)
      设置最小化按钮可用性
    • void setMinVisible(bool visible)
      设置最小化按钮可见性
    • void setMaxEnabled(bool enable)
      设置最大化按钮可用性
    • void setMaxVisible(bool visible)
      设置最大化按钮可见性
  • TitleBar类重新QWidget如下函数
    • virtual void painEvent(QPaintEvent*)
    • virtual void mousePressEvent(QMouseEvent* event);
      记录鼠标按下的标记m_pressed
    • virtual void mouseReleaseEvent(QMouseEvent* event);
      清除鼠标按下的标记m_pressed
    • virtual void mouseDoubleClickEvent(QMouseEvent* event);
      实现鼠标左键双击标题栏放大、缩小窗口
    • virtual void mouseMoveEvent(QMouseEvent* event);
      实现鼠标左键拖着窗口移动
  • TitleBar类定义私有变量
    • QWidget* m_parent;
      保存父窗口，用于窗口移动、双击放大、缩小
    • bool m_pressed;
      保存鼠标左键是否按下，用于拖拽窗口
    • QPoint m_move_pos;
      保存鼠标左键移动位置，用于推拽窗口到指定位置

TitleBar类声明

#include <QWidget>
#include <QString>
#include <QPoint>
#include <QMouseEvent>
#include <QPaintEvent>
#include <QTextCodec>

extern QTextCodec *codec;
#define TU codec->toUnicode

class TitleBar : public QWidget
{
	Q_OBJECT
	
public:
    TitleBar(QString title, QWidget *parent);
    
signals:
    void setMinEnabled(bool enable);
    void setMinVisible(bool visible);

	void setMaxEnabled(bool enable);
    void setMaxVisible(bool visible);
    
protected:
	virtual void paintEvent(QPaintEvent *);
	
	virtual void mousePressEvent(QMouseEvent *event);
	virtual void mouseReleaseEvent(QMouseEvent *event);
	virtual void mouseDoubleClickEvent(QMouseEvent *event);
	virtual void mouseMoveEvent(QMouseEvent *event);

 private:
    QWidget * m_parent;
	
    bool m_pressed;
    QPoint m_move_pos;
};

TitleBar类实现

#include "titlebar.h"
#include <QLabel>
#include <QHBoxLayout>
#include <QPushButton>
#include <QTextCodec>
#include <QFile>
#include <QStyleOption>
#include <QPainter>
#include <QStyle>
#include <QApplication>

QTextCodec *codec = QTextCodec::codecForName("utf-8");

#if _MSC_VER >= 1600
#pragma execution_character_set("utf-8")
#endif

TitleBar::TitleBar(QString title, QWidget *parent)
	: QWidget(parent)
    , m_parent(parent)
    , m_pressed(false)
{
	setMouseTracking(true);
    setObjectName("TitleBar");
	setSizePolicy(QSizePolicy::Preferred, QSizePolicy::Fixed);

	QLabel *title_icon = new QLabel(this);
	title_icon->setObjectName("title_icon"); 
	title_icon->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Fixed);
	
	QLabel *title_text = new QLabel(this);
	title_text->setObjectName("title_text");
	title_text->setText(title);

	QPushButton *title_btn_min = new QPushButton(this);
	title_btn_min->setObjectName("title_btn_min");
	title_btn_min->setToolTip(TU("最小化"));
	title_btn_min->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Fixed);
    connect(title_btn_min, &QPushButton::clicked, parent, &QWidget::showMinimized);
    connect(this, &TitleBar::setMinEnabled, title_btn_min, &QPushButton::setEnabled);
    connect(this, &TitleBar::setMinVisible, title_btn_min, &QPushButton::setVisible);

	QPushButton *title_btn_max = new QPushButton(this);
	title_btn_max->setObjectName("title_btn_max");
	title_btn_max->setToolTip(TU("最大化"));
	title_btn_max->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Fixed);
    connect(title_btn_max, &QPushButton::clicked, parent, &QWidget::showMaximized);
    connect(this, &TitleBar::setMaxEnabled, title_btn_max, &QPushButton::setEnabled);
    connect(this, &TitleBar::setMaxVisible, title_btn_max, &QPushButton::setVisible);

	QPushButton *title_btn_close = new QPushButton(this);
	title_btn_close->setObjectName("title_btn_close");
	title_btn_close->setToolTip(TU("关闭"));
	title_btn_close->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Fixed);
    connect(title_btn_close, &QPushButton::clicked, parent, &QWidget::close);

	QHBoxLayout* title_h_layout = new QHBoxLayout(this);
    title_h_layout->setSpacing(15);
    title_h_layout->setContentsMargins(2, 2, 20, 2);
	title_h_layout->addWidget(title_icon);
	title_h_layout->addWidget(title_text);
	title_h_layout->addStretch();
	title_h_layout->addWidget(title_btn_min);
	title_h_layout->addWidget(title_btn_max);
	title_h_layout->addWidget(title_btn_close);

	setLayout(title_h_layout);

    QString qss;
    qss.append("#title_icon{min-width: 20px; min-height: 15px; border-image: url(:/image/title_icon.png)}");
    qss.append("#title_btn_min{min-width: 20px; min-height: 15px; border-image: url(:/image/min.png)}");
    qss.append("#title_btn_max{min-width: 20px; min-height: 15px; border-image: url(:/image/max.png)}");
    qss.append("#title_btn_close{min-width: 20px; min-height: 15px; border-image: url(:/image/close.png)}");

    setStyleSheet(qss);
}

void TitleBar::paintEvent(QPaintEvent *event)
{
	QStyleOption opt;
	opt.init(this);

	QPainter p(this);
	style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);

	QWidget::::paintEvent(event);
}

void TitleBar::mousePressEvent(QMouseEvent *event)
{
	if (event->button() == Qt::LeftButton)
	{
    	m_pressed = true;
        m_move_pos = event->globalPos() - m_parent->pos();
	}

	QWidget::mousePressEvent(event);
}

void TitleBar::mouseReleaseEvent(QMouseEvent *event)
{
	if (event->button() == Qt::LeftButton)
	{
        m_pressed = false;
	}

	QWidget::mouseReleaseEvent(event);
}

void TitleBar::mouseDoubleClickEvent(QMouseEvent *event)
{
    if (m_parent->isMaximized())
    {
        m_parent->showNormal();
    }
    else
    {
        m_parent->showMaximized();
    }
    // QWidget::mouseDoubleClickEvent(event);
}

void TitleBar::mouseMoveEvent(QMouseEvent *event)
{
	QWidget::mouseMoveEvent(event);

    if (m_pressed && (event->buttons() && Qt::LeftButton)
        && (event->globalPos() - m_move_pos).manhattanLength() > QApplication::startDragDistance())
	{
        m_parent->move(event->globalPos() - m_move_pos);
        m_move_pos = event->globalPos() - m_parent->pos();
	}
}

使用

// widget.h
#include <QWidget>
#include "titlebar.h"

class Widget : public QWidget
{
	Q_OBJECT
public:
	Widget(QWidget* parent = nullptr);
	~Widget();
	
private:
	Ui::WIdget *ui;
	TitleBar* m_title_bar;
};

// widget.cpp
#include "widget.h"
#include "ui_widget.h"
#include <QVBoxLayout>

Widget::Widget(QWidget*parent)
	: ui(new Ui::Widget)
{
	ui->setupUi(this);
	
	m_title_bar = new TitleBar("Hello", this);
	
	QVBoxLayout* main_layout = new QVBoxLayout();
	main_layout->setContentsMargins(2, 2, 2, 2);
	main_layout->setSpacing(0);
	main_layout->addWidget(m_title_bar);
	main_layout->addStretch();
	setLayout(m_title_bar);
}

Widget::~Widget()
{
	delete ui;
}
行者记
关注
专栏目录
Qt 之 自定义窗口标题栏
前行之路还需前行
12-06 7万+
首先自定义标题栏解决了我们程序在不同平台乃至同一平台不同的版本中样式不同的问题，使用自定义标题栏，能够保证外观的一致性，这也是为什么像QQ、有道词典、360等软件都没有使用系统标题栏，都是自定义标题栏了。正是因为自定义标题栏，我们可以自定义不再受约束，想怎么设计就怎么设计。自定义标题栏可以使用自己设计的图标，当然比系统的图标要美观了，颜值当然更高了。下面就讲一讲如何用Qt实现自定义窗口标题栏。
Qt 实现 自定义窗口标题栏
12-07
以上代码用Qt实现了自定义窗口标题栏，非常实用，提供了窗口图标、窗口标题、最小化、最大化、关闭按钮等几个部分。可以应用到每一个窗口中去，保持每个窗口外观的一致性，同时自定义的标题栏也比系统自带的漂亮很多。
QT自定义TitleBar
yinyuchen1的博客
11-08 3997
头文件 #ifndef TITLEBAR_H #define TITLEBAR_H /************************************************* 功能：重写标题栏 作者: YYC 时间：2017-10-13 *************************************************/
Qt自定义标题栏
热门推荐
shenmingyi.blog.csdn.net
07-30 1万+
Qt自带的标题栏确实不美观,直接开门见山自定义标题栏 markdown 的语法排版都不熟悉，凑合看吧. 自定义标题栏说白了就是摒弃原来的那套标题栏。 继承QWidget 实现一下基本的 最大化 最小化和关闭,当然也可以加上一写属于自己的东西 效果图： 为啥颜色是黑色的？因为我加载了 qss（qss网上有好多例子，我这个写的也不好看）， 下面上自定义标题栏的代码 这是 custo...
Qt 自定义标题栏
01-23
QWidget及其子类窗体组件的标题栏受操作系统的控制，即标题栏的界面风格与操作系统的主题风格相同，工程实践中需要开发者自行定义，达到美化应用程序界面的目的。开发环境是Qt5.7，调试成功，可自行下载，如有问题请留言，谢谢！
qt5 自定义标题栏
03-20
1. **创建自定义标题栏类**： 创建一个继承自QWidget的新类，例如`CustomTitleBar`。在这个类中，你需要添加必要的UI元素，如按钮、图标和布局。使用`QHBoxLayout`或`QVBoxLayout`来组织这些元素。 2. **实现基本...
Android自定义通用标题栏CustomTitleBar
01-21
本文实例为大家分享了Android自定义通用标题栏的具体代码，供大家参考，具体内容如下/p> 1自定义一个public_titlebar.xml文件 <?xml version=1.0 encoding=utf-8?> <LinearLayout xmlns:android=...
qt 自定义标题栏
swartz_lubel的专栏
02-06 1242
TitleBar.h #ifndef TITLE_BAR #define TITLE_BAR #include class QLabel; class QPushButton; class TitleBar : public QWidget { Q_OBJECT public: explicit TitleBar(QWidget *parent = 0); ~TitleBar()
qt 的顶部标题栏(ActionBar)
12-29
顶部标题栏（ActionBar），这个项目是基于qt for android的版本，不过也适用于桌面版本。
Qss：具有自定义TitleBar的Qt样式表库！！！
02-05
Qss：具有自定义TitleBar的Qt样式表库！！！
QT之独立标题栏
雨田哥的博客
12-09 1537
QT之独立标题栏QT之独立标题栏 应用背景 QT标题栏效果图 QT标题栏效果图-续 上代码 浅谈独立标题栏的封装 代码下载 结尾应用背景 我们在只用QT设计界面的时候，QT会默认为我们带上边框以及标题栏。而在我们真正应用当中我们却不想使用QT默认效果，为什么呢？相信做过的伙伴们都应该知道，QT默认效果虽好，但是界面不友好哇，不友好怎么办呢，去掉嘛，我们自己设计一个Beautiful的标题栏出来。
Qt之自定义界面（添加自定义标题栏）
weixin_34211761的博客
01-21 2356
简述 通过上节内容，我们实现了自定义窗体的移动，但是我们缺少一个标题栏来显示窗体的图标、标题，以及控制窗体最小化、最大化、关闭的按钮。 自定义标题栏后，所有的控件我们都可以定制，比如：在标题栏中添加换肤、设置按钮以及其他控件。 简述 效果 自定义标题栏 实现 接口说明 使用方式 效果 自定义标题栏 ...
Qt自定义标题栏（可拖动标题栏编辑修改窗口大小）
weixin_46246664的博客
06-06 6576
记录下Qt的自定义标题栏
QT 自定义简单标题栏
qq_36500197的博客
05-03 698
系统自带的标题栏不知道怎么给它设置样式，所以自己写一个吧，将就用
27、Qt自定义标题栏
最新发布
Viciower的博客
05-10 1343
Qt自定义标题栏
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值