Qt之分裂器(QSplitter)

一、QSplitter概述

QSplitter 是 Qt 中的一个布局管理器，允许用户在应用程序窗口中创建可拖动的分隔器，以便调整多个子窗口或控件的大小。它是一种非常有用的布局管理器，用于创建可分隔的多个部分，通常用于分割、重新排列和管理用户界面中的多个区域。

以下是有关 QSplitter 的详细介绍和使用方法：

QSplitter 的主要特点：

1. 分隔多个控件：QSplitter 允许你在水平或垂直方向上分割窗口中的多个子部件或控件。

2. 可拖动分隔器：用户可以通过拖动分隔器来动态调整子控件的大小，以满足他们的需求。

3. 嵌套使用：你可以嵌套多个 QSplitter 以创建复杂的布局，允许用户在多个方向上进行分剔。

4. 自动布局：QSplitter 处理子控件的自动布局，以确保它们占用可用空间。

二、函数介绍

1.setOrientation：设置分隔器的方向

QSplitter *splitter = new QSplitter;
splitter->setOrientation(Qt::Horizontal); // 设置为水平分隔器

2.setOpaqueResize：设置分隔器是否显示为不透明的样式

QSplitter *splitter = new QSplitter;
splitter->setOpaqueResize(true); // 设置为不透明分隔器

3.addWidget：将一个控件添加到分隔器中

QSplitter *splitter = new QSplitter;
QTextEdit *textEdit = new QTextEdit;
splitter->addWidget(textEdit);

4.setSizes：设置子控件的初始大小

QSplitter *splitter = new QSplitter;
splitter->setSizes(QList<int>() << 200 << 300); // 设置两个子控件的初始大小

5.sizes：获取子控件的当前大小

QSplitter *splitter = new QSplitter;
QList<int> sizes = splitter->sizes(); // 获取当前子控件的大小

6.handleWidth：获取分隔器的宽度

int width = QSplitter::handleWidth(); // 获取分隔器的宽度

7.refresh：重新布局和绘制分隔器

QSplitter *splitter = new QSplitter;
splitter->refresh(); // 重新布局和绘制分隔器

8.setCollapsible：设置是否允许子控件折叠

QSplitter *splitter = new QSplitter;
splitter->setCollapsible(0, true); // 允许第一个子控件折叠

三、代码示例　　

#include "main_window.h"

#include <QHBoxLayout>
#include <QVBoxLayout>
#include <QSplitter>
#include <QTextBrowser>

MainWindow::MainWindow(QWidget *parent)
    : QWidget(parent)
{
    this->setWindowTitle("分裂器布局");
    this->setFixedSize(800, 600);

    //使用水平布局
    QHBoxLayout *pLayout = new QHBoxLayout(this);

    //使用水平分裂器
    QSplitter *pHSplitter = new QSplitter(Qt::Horizontal, this);
    pHSplitter->setSizes(QList<int>() << 10 << 30); // 设置两个子控件的初始大小

    QWidget *pLeftWidget = new QWidget(this);
    pLeftWidget->setStyleSheet("QWidget{background-color:rgb(255, 0, 0)}");
    pLeftWidget->setMinimumHeight(300);

    //分裂器添加widget
    pHSplitter->addWidget(pLeftWidget);

    //右边的垂直分裂器
    QSplitter *pVSplitter = new QSplitter(Qt::Vertical, pHSplitter);
    pVSplitter->setOpaqueResize(false);//手动到位并弹出鼠标之后再显示分割条

    QWidget *pRightWidget = new QWidget(this);
    pRightWidget->setStyleSheet("QWidget{background-color:rgb(255, 255, 0)}");

    QTextBrowser *pTextBrowser = new QTextBrowser(this);

    pVSplitter->addWidget(pRightWidget);
    pVSplitter->addWidget(pTextBrowser);

    //将右边的垂直分裂器加入到水平分裂器中
    pHSplitter->addWidget(pVSplitter);

    //将分裂器加入到水平布局中
    pLayout->addWidget(pHSplitter);
}

MainWindow::~MainWindow()
{
}

效果展示：