devbox
菜鸟追梦旅行
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

Qt高级——Qt自定义标题栏

作者：菜鸟追梦旅行 | 2024-03-14 13:56:48

赞

踩

qt自定义标题栏

一、Qt自定义标题栏简介

QWidget及其子类窗体组件的标题栏受操作系统的控制，即标题栏的界面风格与操作系统的主题风格相同，工程实践中需要开发者自行定义，达到美化应用程序界面的目的。

二、Qt自定义标题栏实现

1、自定义标题栏的功能

自定义标题栏需要完成功能如下：
（1）自定义标题栏需要包含最小化按钮、最大化按钮、关闭按钮、标题标签、图标标签等图形元素。
（2）标题栏的拖拽。
（3）鼠标双击标题栏实现窗体的最大化、最小化。

2、自定义标题栏的界面布局

自定义标题栏的界面布局如下：
Qt高级——Qt自定义标题栏

3、标题栏拖拽功能的实现

窗体的拖拽平移过程如下图：
Qt高级——Qt自定义标题栏
当鼠标在窗体的标题栏按下并移动时，窗体会按照鼠标移动的轨迹进行平移。因此，窗体每次移动都是在当前位置按照鼠标移动的矢量进行移动。标题栏拖拽功能的实现需要实现mousePressEvent、mouseMoveEvent、mouseReleaseEvent三个事件处理函数。
MouseEvent中的globalPos()函数返回的是相对屏幕的位置坐标，而pos()则是返回鼠标在当前控件（即捕获该鼠标事件的控件）中的位置。
QWidget窗体的geometry().topLeft()则返回的是当前窗体的左上角在屏幕中的位置。

  1. startPos = event->globalPos();// 鼠标的全局初始位置，按下时记住 
  2. curWindowPos = geometry().topleft();// 窗体的全局位置，移动时 
  3. endPos = event->globalPos();// 鼠标按下发生移动之后的位置，移动时 
  4. move(curWindowPos+(startPos-endPos));// 根据矢量移动方向是初始位置减去末位置，移动时 
  5. startPos = endPos;// 将初始位置记为上次末位置，然后执行直到释放拖拽，移动时

实现代码如下：

  1. void TitleBar::mousePressEvent(QMouseEvent *event)
  2. {
  3.     // 鼠标左键按下事件
  4.     if (event->button() == Qt::LeftButton)
  5.     {
  6.         // 记录鼠标左键状态
  7.         m_leftButtonPressed = true;
  8.         //记录鼠标在屏幕中的位置
  9.         m_start = event->globalPos();
  10.     }
  11.  
  12. }
  13.  
  14. void TitleBar::mouseMoveEvent(QMouseEvent *event)
  15. {
  16.     // 持续按住才做对应事件
  17.     if(m_leftButtonPressed)
  18.     {
  19.         //将父窗体移动到父窗体原来的位置加上鼠标移动的位置：event->globalPos()-m_start
  20.         parentWidget()->move(parentWidget()->geometry().topLeft() +
  21.                              event->globalPos() - m_start);
  22.         //将鼠标在屏幕中的位置替换为新的位置
  23.         m_start = event->globalPos();
  24.     }
  25.  
  26. }
  27.  
  28. void TitleBar::mouseReleaseEvent(QMouseEvent *event)
  29. {
  30.     // 鼠标左键释放
  31.     if (event->button() == Qt::LeftButton)
  32.     {
  33.         // 记录鼠标状态
  34.         m_leftButtonPressed = false;
  35.     }
  36. }

4、标题栏双击实现最大化、最小化

鼠标双击事件处理函数mouseDoubleClickEvent实现如下：

  1. void TitleBar::mouseDoubleClickEvent(QMouseEvent *event)
  2. {
  3.     m_maximizeButton->click();
  4. }

最大化、最小化、关闭按钮的槽函数如下：

  1. void TitleBar::onClicked()
  2. {
  3.     QPushButton *pButton = qobject_cast<QPushButton *>(sender());
  4.     QWidget *pWindow = this->window();
  5.     if (pWindow->isTopLevel())
  6.     {
  7.         if (pButton == m_minimizeButton)
  8.         {
  9.             pWindow->showMinimized();
  10.         }
  11.         else if (pButton == m_maximizeButton)
  12.         {
  13.             pWindow->isMaximized() ? pWindow->showNormal() : pWindow->showMaximized();
  14.         }
  15.         else if (pButton == m_closeButton)
  16.         {
  17.             pWindow->close();
  18.         }
  19.     }
  20. }

三、Qt自定义窗体基类示例

1、自定义窗体基类的功能

自定义窗体基类的功能如下：
（1）自定义标题栏。
（2）增加内容组件，内容组件内部的界面布局完全由具体的用户决定。

2、自定义窗体基类的实现

TitleBar.h文件：

  1. #ifndef TITLEBAR_H
  2. #define TITLEBAR_H
  3.  
  4. #include <QWidget>
  5. #include <QPushButton>
  6. #include <QLabel>
  7. #include <QHBoxLayout>
  8. #include <QEvent>
  9. #include <QMouseEvent>
  10. #include <QApplication>
  11. #include <QPoint>
  12. #include <QPixmap>
  13. #include <QString>
  14. /**
  15.  * @brief 标题栏界面组件
  16.  * @author 
  17.  */
  19. class TitleBar : public QWidget
  20. {
  21.     Q_OBJECT
  22. public:
  23.     explicit TitleBar(QWidget *parent = NULL);
  24.     /**
  25.      * @brief 设置标题栏标题
  26.      * @param title，参数，设置的标题
  27.      */
  28.     void setWindowTitle(const QString& title);
  29.     /**
  30.      * @brief 设置标题栏的图标
  31.      * @param iconPath，参数，图标的路径
  32.      */
  33.     void SetTitleBarIcon(const QString& iconPath);
  34.  
  35. protected:
  36.     /**
  37.      * @brief 鼠标双击事件处理函数
  38.      * @param event，参数，事件
  39.      * @note 双击标题栏进行界面的最大化/还原
  40.      */
  41.     virtual void mouseDoubleClickEvent(QMouseEvent *event);
  42.  
  43.     /**
  44.      * @brief 鼠标按下事件处理函数
  45.      * @param event，参数，事件
  46.      * @note 按下鼠标左键
  47.      */
  48.     virtual void mousePressEvent(QMouseEvent *event);
  49.     /**
  50.      * @brief 鼠标移动事件处理函数
  51.      * @param event，参数，事件
  52.      * @note 移动鼠标
  53.      */
  54.     virtual void mouseMoveEvent(QMouseEvent *event);
  55.     /**
  56.      * @brief 鼠标释放事件处理函数
  57.      * @param event，参数，事件
  58.      * @note 释放鼠标
  59.      */
  60.     virtual void mouseReleaseEvent(QMouseEvent *event);
  61.  
  62.     /**
  63.      * @brief 事件过滤处理器
  64.      * @param obj，参数
  65.      * @param event，参数，事件
  66.      * @return 成功返回true，失败返回false
  67.      * @note 设置标题、图标
  68.      */
  69.     virtual bool eventFilter(QObject *obj, QEvent *event);
  70.  
  71.     /**
  72.      * @brief 最大化/还原
  73.      */
  74.     void updateMaximize();
  75.  
  76. protected slots:
  77.     /**
  78.      * @brief 最小化、最大化/还原、关闭按钮点击时响应的槽函数
  79.      */
  80.     void onClicked();
  81.  
  82. private:
  83.     QLabel* m_iconLabel;
  84.     QLabel* m_titleLabel;
  85.     QPushButton* m_minimizeButton;
  86.     QPushButton* m_maximizeButton;
  87.     QPushButton* m_closeButton;
  88.     QPoint m_start;//起始点
  89.     QPoint m_end;//结束点
  90.     bool m_leftButtonPressed;//鼠标左键按下标记
  91. };
  92.  
  93. #endif // TITLEBAR_H

TitleBar.cpp文件：

  1. #include "TitleBar.h"
  2.  
  3. TitleBar::TitleBar(QWidget *parent) : QWidget(parent)
  4. {
  5.     setFixedHeight(30);
  6.     setWindowFlags(Qt::FramelessWindowHint);
  7.     m_iconLabel = new QLabel(this);
  8.     m_iconLabel->setFixedSize(20, 20);
  9.     m_iconLabel->setScaledContents(true);
  10.  
  11.     m_titleLabel = new QLabel(this);
  12.     m_titleLabel->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
  13.  
  14.     m_minimizeButton = new QPushButton(this);
  15.     m_minimizeButton->setFixedSize(27, 22);
  16.     m_minimizeButton->setObjectName("minimizeButton");
  17.  
  18.     m_maximizeButton = new QPushButton(this);
  19.     m_maximizeButton->setFixedSize(27, 22);
  20.     m_maximizeButton->setObjectName("maximizeButton");
  21.  
  22.     m_closeButton = new QPushButton(this);
  23.     m_closeButton->setFixedSize(27, 22);
  24.     m_closeButton->setObjectName("closeButton");
  25.  
  26.     QHBoxLayout* layout = new QHBoxLayout;
  27.     layout->addWidget(m_iconLabel);
  28.     layout->addStretch(1);
  29.     layout->addWidget(m_titleLabel);
  30.     layout->addStretch(1);
  31.     layout->addWidget(m_minimizeButton);
  32.     layout->addWidget(m_maximizeButton);
  33.     layout->addWidget(m_closeButton);
  34.     setLayout(layout);
  35.  
  36.     setProperty("titleBar", true);
  37.     setObjectName("titleBar");
  38.  
  39.     connect(m_minimizeButton, SIGNAL(clicked(bool)), this, SLOT(onClicked()));
  40.     connect(m_maximizeButton, SIGNAL(clicked(bool)), this, SLOT(onClicked()));
  41.     connect(m_closeButton, SIGNAL(clicked(bool)), this, SLOT(onClicked()));
  42. }
  43.  
  44. void TitleBar::setWindowTitle(const QString &title)
  45. {
  46.     m_titleLabel->setAlignment(Qt::AlignCenter);
  47.     m_titleLabel->setText(title);
  48. }
  49.  
  50. void TitleBar::SetTitleBarIcon(const QString &iconPath)
  51. {
  52.     QPixmap map(iconPath);
  53.     m_iconLabel->setPixmap(map);
  54. }
  55.  
  56. void TitleBar::mouseDoubleClickEvent(QMouseEvent *event)
  57. {
  58.     m_maximizeButton->click();
  59. }
  60.  
  61. void TitleBar::mousePressEvent(QMouseEvent *event)
  62. {
  63.     // 鼠标左键按下事件
  64.     if (event->button() == Qt::LeftButton)
  65.     {
  66.         // 记录鼠标左键状态
  67.         m_leftButtonPressed = true;
  68.         //记录鼠标在屏幕中的位置
  69.         m_start = event->globalPos();
  70.     }
  71.  
  72. }
  73.  
  74. void TitleBar::mouseMoveEvent(QMouseEvent *event)
  75. {
  76.     // 持续按住才做对应事件
  77.     if(m_leftButtonPressed)
  78.     {
  79.         //将父窗体移动到父窗体原来的位置加上鼠标移动的位置：event->globalPos()-m_start
  80.         parentWidget()->move(parentWidget()->geometry().topLeft() +
  81.                              event->globalPos() - m_start);
  82.         //将鼠标在屏幕中的位置替换为新的位置
  83.         m_start = event->globalPos();
  84.     }
  85.  
  86. }
  87.  
  88. void TitleBar::mouseReleaseEvent(QMouseEvent *event)
  89. {
  90.     // 鼠标左键释放
  91.     if (event->button() == Qt::LeftButton)
  92.     {
  93.         // 记录鼠标状态
  94.         m_leftButtonPressed = false;
  95.     }
  96. }
  97.  
  98. bool TitleBar::eventFilter(QObject *obj, QEvent *event)
  99. {
  100.     switch(event->type())
  101.     {
  102.     //设置标题
  103.     case QEvent::WindowTitleChange:
  104.     {
  105.         QWidget *pWidget = qobject_cast<QWidget *>(obj);
  106.         if (pWidget)
  107.         {
  108.             m_titleLabel->setText(pWidget->windowTitle());
  109.             return true;
  110.         }
  111.     }
  112.     //设置图标
  113.     case QEvent::WindowIconChange:
  114.     {
  115.         QWidget *pWidget = qobject_cast<QWidget *>(obj);
  116.         if (pWidget)
  117.         {
  118.             QIcon icon = pWidget->windowIcon();
  119.             m_iconLabel->setPixmap(icon.pixmap(m_iconLabel->size()));
  120.             return true;
  121.         }
  122.     }
  123.     // 窗口状态变化、窗口大小变化
  124.     case QEvent::WindowStateChange:
  125.     case QEvent::Resize:
  126.         updateMaximize();
  127.         return true;
  128.     }
  129.     return QWidget::eventFilter(obj, event);
  130. }
  131.  
  132. void TitleBar::updateMaximize()
  133. {
  134.     QWidget *pWindow = this->window();
  135.     if (pWindow->isTopLevel())
  136.     {
  137.         bool bMaximize = pWindow->isMaximized();
  138.         if (bMaximize)
  139.         {
  140.             m_maximizeButton->setToolTip(tr("Restore"));
  141.             m_maximizeButton->setProperty("maximizeProperty", "restore");
  142.         }
  143.         else
  144.         {
  145.             m_maximizeButton->setProperty("maximizeProperty", "maximize");
  146.             m_maximizeButton->setToolTip(tr("Maximize"));
  147.         }
  148.  
  149.         m_maximizeButton->setStyle(QApplication::style());
  150.     }
  151. }
  152.  
  153. void TitleBar::onClicked()
  154. {
  155.     QPushButton *pButton = qobject_cast<QPushButton *>(sender());
  156.     QWidget *pWindow = this->window();
  157.     if (pWindow->isTopLevel())
  158.     {
  159.         if (pButton == m_minimizeButton)
  160.         {
  161.             pWindow->showMinimized();
  162.         }
  163.         else if (pButton == m_maximizeButton)
  164.         {
  165.             pWindow->isMaximized() ? pWindow->showNormal() : pWindow->showMaximized();
  166.         }
  167.         else if (pButton == m_closeButton)
  168.         {
  169.             pWindow->close();
  170.         }
  171.     }
  172. }

QWindowBase.h文件：

  1. #ifndef QWINDOWBASE_H
  2. #define QWINDOWBASE_H
  3.  
  4. #include <QFrame>
  5. #include <QWidget>
  6. #include <QVBoxLayout>
  7. #include "TitleBar.h"
  8.  
  9. /**
  10.  * @brief 界面组件基类
  11.  * @note QWindowBase界面组件主要用作顶层窗口，对于非顶层窗口的界面组件使用QWidget。
  12.  */
  13. class QWindowBase : public QFrame
  14. {
  15.     Q_OBJECT
  16. public:
  17.     QWindowBase(QFrame* parent = NULL);
  18.     /**
  19.      * @brief 设置标题
  20.      * @param title，输入参数，标题内容
  21.      */
  22.     void setWindowTitle(const QString& title);
  23.     /**
  24.      * @brief 设置标题栏的图标
  25.      * @param iconPath，输入参数，图标资源路径
  26.      */
  27.     void SetTitleBarIcon(const QString& iconPath);
  28.     /**
  29.      * @brief 获取内容组件对象指针
  30.      * @return 返回QWidget*
  31.      */
  32.     QWidget* contentWidget();
  33.     /**
  34.      * @brief 设置标题栏高度
  35.      * @param h，输入参数，标题栏高度
  36.      */
  37.     void setWindowTitleHeight(int h);
  38.  
  39. private:
  40.     QWidget* m_contentWidget;//内容组件
  41.     TitleBar* m_titleBar;//标题栏
  42.     QVBoxLayout* m_layout;//布局管理器
  43. };
  44.  
  45. #endif // QWINDOWBASE_H

QWindowBase.cpp文件：

  1. #include "QWindowBase.h"
  2.  
  3. QWindowBase::QWindowBase(QFrame *parent): QFrame(parent)
  4. {
  5.     setWindowFlags(windowFlags() | Qt::FramelessWindowHint);
  6.     m_titleBar = new TitleBar(this);
  7.     m_contentWidget = new QWidget(this);
  8.     m_contentWidget->setObjectName("Contents");
  9.     m_layout = new QVBoxLayout;
  10.     m_layout->addWidget(m_titleBar);
  11.     m_layout->addWidget(m_contentWidget);
  12.     m_layout->setSpacing(0);
  13.     m_layout->setContentsMargins(0, 0, 0, 0);
  14.  
  15.     setLayout(m_layout);
  16. }
  17.  
  18. void QWindowBase::setWindowTitle(const QString &title)
  19. {
  20.     m_titleBar->setWindowTitle(title);
  21. }
  22.  
  23. void QWindowBase::SetTitleBarIcon(const QString &iconPath)
  24. {
  25.     m_titleBar->SetTitleBarIcon(iconPath);
  26. }
  27.  
  28. QWidget *QWindowBase::contentWidget()
  29. {
  30.     return m_contentWidget;
  31. }
  32.  
  33. void QWindowBase::setWindowTitleHeight(int h)
  34. {
  35.     m_titleBar->setFixedHeight(h);
  36. }

CommonHelper.h文件：

  1. #ifndef COMMONHELPER_H
  2. #define COMMONHELPER_H
  3.  
  4. #include <QString>
  5. #include <QFile>
  6. #include <QApplication>
  7. #include <QDebug>
  8. #include <QColor>
  9. #include <QPalette>
  10.  
  11. /**
  12.  * @brief 通用功能辅助类
  13.  */
  14. class CommonHelper
  15. {
  16. public:
  17.     /**
  18.      * @brief 为应用程序设置QSS样式表
  19.      * @param filepath，输入参数，QSS文件路径
  20.      */
  21.     static void setStyleSheet(const QString& filepath)
  22.     {
  23.         //加载样式文件
  24.         QFile qss(filepath);
  25.         if(qss.open(QFile::ReadOnly))
  26.         {
  27.             QString stylesheet = QLatin1String(qss.readAll());
  28.             QString paletteColor = stylesheet.mid(20, 7);
  29.             qApp->setPalette(QPalette(QColor(paletteColor)));
  30.             qApp->setStyleSheet(stylesheet);
  31.         }
  32.     }
  33. };
  34.  
  35. #endif // COMMONHELPER_H

main.cpp文件：

  1. #include <QApplication>
  2. #include "CommonHelper.h"
  3. #include "QWindowBase.h"
  4. #include <QPushButton>
  5. #include <QVBoxLayout>
  6. #include <QHBoxLayout>
  7. #include <QTreeView>
  8.  
  9. int main(int argc, char *argv[])
  10. {
  11.     QApplication a(argc, argv);
  12.     QWindowBase w;
  13.     w.setWindowTitle("WidgetBase");
  14.     QPushButton* button1 = new QPushButton("OK");
  15.     QHBoxLayout* hLayout1 = new QHBoxLayout;
  16.     hLayout1->addStretch(1);
  17.     hLayout1->addWidget(button1);
  18.  
  19.     QVBoxLayout* layout = new QVBoxLayout;
  20.     QTreeView* treeView = new QTreeView;
  21.     layout->addWidget(treeView);
  22.     layout->addLayout(hLayout1);
  23.     layout->addStretch(1);
  24.     w.contentWidget()->setLayout(layout);
  25.     w.setWindowTitleHeight(40);
  26.     w.show();
  27.     CommonHelper::setStyleSheet("://qss/lightblue.qss");
  28.     return a.exec();
  29. }

工程文件：

  1. QT       += core gui
  2.  
  3. greaterThan(QT_MAJOR_VERSION, 4): QT += widgets
  4.  
  5. TARGET = TitleBarDemo
  6. TEMPLATE = app
  7.  
  8. # The following define makes your compiler emit warnings if you use
  9. # any feature of Qt which has been marked as deprecated (the exact warnings
  10. # depend on your compiler). Please consult the documentation of the
  11. # deprecated API in order to know how to port your code away from it.
  12. DEFINES += QT_DEPRECATED_WARNINGS
  13.  
  14. # You can also make your code fail to compile if you use deprecated APIs.
  15. # In order to do so, uncomment the following line.
  16. # You can also select to disable deprecated APIs only up to a certain version of Qt.
  17. #DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0
  18.  
  19. SOURCES += \
  20.         main.cpp \
  21.     TitleBar.cpp \
  22.     QWindowBase.cpp
  23.  
  24. HEADERS += \
  25.     TitleBar.h \
  26.     CommonHelper.h \
  27.     QWindowBase.h
  28.  
  29. RESOURCES += \
  30.     TitileBarDemo.qrc

工程目录结构：
Qt高级——Qt自定义标题栏

3、自定义窗体基类结果展示

运行结果：
Qt高级——Qt自定义标题栏

源码：http://down.51cto.com/data/2457159

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

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

  

闽ICP备14008679号