【QT入门】对无边框窗口自定义标题栏并实现拖动和拉伸效果

不吃~香菜

已于 2024-04-03 20:00:21 修改

阅读量921

点赞数 28

分类专栏： QT入门文章标签： qt 开发语言自定义标题栏窗口句柄

于 2024-04-02 10:47:25 首次发布

本文链接：https://blog.csdn.net/LF__plus/article/details/137259560

版权

QT入门专栏收录该内容

49 篇文章 8 订阅

订阅专栏

往期回顾：

【QT入门】 QScrollArea实际运用之滑动Widget设计-CSDN博客

【QT入门】QWidget类的简单介绍-CSDN博客

【QT入门】鼠标按下和移动事件实现无边框窗口拖动-CSDN博客

【QT入门】对无边框窗口自定义标题栏并实现拖动和拉伸效果

对无边框窗口添加自定义标题栏是很简单的，难的是逻辑实现拖拽窗口边框和实现拉伸效果。特别是在无边框窗口下还要实现拉伸效果，我们分别把自定义标题栏的ui设计和拉伸效果放到两个类去实现。

一、UI界面设计

1、最终效果

2、创建标题栏类

用一个初始化ui函数，定义6个控件，分别是logo、标题、设置按钮、最小化最大化关闭按钮。

#pragma once
#include <QtWidgets/QWidget>
#include <QLabel>
#include <QPushButton>


class CTitleBar: public QWidget
{
public:
    CTitleBar(QWidget* parent = nullptr);
    ~CTitleBar();

private:
    void initUi();

    void mousePressEvent(QMouseEvent* event) override;

private :
    QLabel* m_pLogo;
    QLabel* m_pTitle;

    QPushButton* m_setBtn;
    QPushButton* m_minBtn;
    QPushButton* m_maxBtn;
    QPushButton* m_closeBtn;
};

3、定义相关控件并布局

我们需要分别定义实现每个控件，设置大小，最后用一个水平布局，把这些控件都加进去，在中间还加了一个弹簧。

setAttribute(Qt::WA_StyledBackground);

有些时候子窗口颜色会被父类窗口给替换掉，为了避免这种影响，这里通过setAttribute方法禁止父窗口影响子窗口样式。

pHlay->addStretch();//弹簧
pHlay->setContentsMargins(5, 5, 5, 5);//设置布局和窗口边框的距离

#include "CTitleBar.h"
#include <QHBoxLayout>
#include <qt_windows.h>
#include <QMouseEvent>
#include <QWidget>
#include <QSpacerItem>
#pragma comment(lib, "user32.lib")

CTitleBar::CTitleBar(QWidget* parent)
    : QWidget(parent)
{
    //在窗口关闭时自动删除窗口对象，即在调用close()函数关闭窗口时，窗口对象会被自动删除，释放内存。
    this->setAttribute(Qt::WA_DeleteOnClose);

    initUi();
}

CTitleBar::~CTitleBar()
{
}

void CTitleBar::initUi()
{

    //有些时候子窗口颜色会被父类窗口给替换掉
    //为了避免这种影响，禁止父窗口影响子窗口样式
    setAttribute(Qt::WA_StyledBackground);
    this->setFixedHeight(32 + 5 * 2);

    this->setStyleSheet("background-color:rgb(0,122,122)");

    QLabel* m_pLogo;
    QLabel* m_pTitle;
    QPushButton* m_minBtn;
    QPushButton* m_maxBtn;
    QPushButton* m_closeBtn;

    m_pLogo = new QLabel(this);
    m_pLogo->setFixedSize(32, 32);  

    m_pTitle = new QLabel(this);
    m_pTitle->setText(u8"我是标题");
    m_pTitle->setFixedWidth(120);

    m_setBtn = new QPushButton(this);
    m_setBtn->setFixedSize(32, 32);

    m_minBtn = new QPushButton(this);
    m_minBtn->setFixedSize(32, 32);

    m_maxBtn = new QPushButton(this);
    m_maxBtn->setFixedSize(32, 32);

    m_closeBtn = new QPushButton(this);
    m_closeBtn->setFixedSize(32, 32);

    QHBoxLayout* pHlay = new QHBoxLayout(this);
    pHlay->addWidget(m_pLogo);
    pHlay->addWidget(m_pTitle);
    pHlay->addStretch();//添加了一个弹簧到水平布局pHlay中，弹簧会随着窗口大小变化而比变化

    pHlay->addWidget(m_setBtn);

    pHlay->addWidget(m_minBtn);

    pHlay->addWidget(m_maxBtn);

    pHlay->addWidget(m_closeBtn);

    pHlay->setContentsMargins(5, 5, 5, 5);

}

4、添加到主类

由于在主类的.h文件里已经声明了m_pTitleBar，这里直接定义，创建w窗口，用一个垂直布局加进去就ok。

void _3_ListWidgetPro::initUI()
{
    m_pTitleBar = new CTitleBar(this);

    //m_pTitleBar->setStyleSheet("background-color:blue");

    QWidget* w = new QWidget(this);
    w->setMinimumSize(600, 400);

    QVBoxLayout* pVlay = new QVBoxLayout(this);
    pVlay->addWidget(m_pTitleBar);
    pVlay->addWidget(w);

    pVlay->setContentsMargins(0, 0, 0, 0);
}

二、拖动拉伸的逻辑实现

1、实现自定义标题栏拖动

我们前面其实已经涉及到这类方法，当时是通过重写mousepress和mousemove方法来实现的

【QT入门】鼠标按下和移动事件实现无边框窗口拖动-CSDN博客

这里我们换另一种方式来实现：

#include <qt_ windows.h>
#pragma comment(ib, "user32.lib")
void CTitleBar::mousePressEvent(QMouseEvent* event)
{
if (ReleaseCapture())
QWidget* pWindow = this->window();
if (pWindow->is TopLevel())
{
SendMessage(HWND(pWindow->winld(), WM_ SYSCOMMAND, SC_ _MOVE
+ HTCAPTION, 0);
}
evenf->ignore0;
}

首先调用了ReleaseCapture()函数来释放鼠标捕获，然后获取了当前窗口部件的指针。

接着，通过判断当前窗口部件是否为顶层窗口（top-level），如果是顶层窗口，则发送了一个WM_SYSCOMMAND消息给窗口的句柄（HWND），消息参数为SC_MOVE + HTCAPTION。这个消息的作用是模拟用户拖动窗口的操作，通过标题栏拖动来移动整个窗口。

最后，调用了event->ignore()函数来告诉Qt框架忽略这个鼠标事件，这样可以确保鼠标事件不会继续传递给其他事件处理函数。

这里涉及到了一个概念：窗口句柄

1.1窗口句柄

在Qt中，窗口句柄（Window Handle）是一个指向窗口对象的唯一标识符。在Qt中，窗口句柄通常表示为一个指向QWidget对象的指针。每个QWidget对象都有一个窗口句柄，用于在操作系统级别标识和管理窗口。

窗口句柄在Qt中通常用于与底层操作系统进行交互，例如在进行窗口管理、绘制和事件处理时。通过窗口句柄，可以实现与操作系统窗口相关的功能，如设置窗口属性、处理窗口事件等。

1.1.1获取窗口句柄方法：

QWidget::winId()	返回窗口句柄的唯一整数标识符。
QWidget::effectiveWinId()	返回窗口句柄的有效整数标识符。
QWidget::internalWinId()	返回窗口句柄的内部整数标识符。