Qt开发：分裂器(QSplitter)

QSplitter介绍

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

分隔多个控件：QSplitter 允许你在水平或垂直方向上分割窗口中的多个子部件或控件。
可拖动分隔器：用户可以通过拖动分隔器来动态调整子控件的大小，以满足他们的需求。
嵌套使用：你可以嵌套多个 QSplitter 以创建复杂的布局，允许用户在多个方向上进行分剔。
自动布局：QSplitter 处理子控件的自动布局，以确保它们占用可用空间。

QSplitter常用函数介绍

设置分隔器的方向

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

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

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

将一个控件添加到分隔器中

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

设置子控件的初始大小

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

获取子控件的当前大小

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

获取分隔器的宽度

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

重新布局和绘制分隔器

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

设置是否允许子控件折叠

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

QSplitter的示例

#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);
}