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