qt QSplitter详解

1、概述

QSplitter是Qt框架中的一个布局管理器类,它允许用户在应用程序窗口中创建可拖动的分隔器,以便动态地调整多个子窗口或控件的大小。QSplitter非常适合用于分割、重新排列和管理用户界面中的多个区域,提供了一种直观且灵活的方式来控制界面布局。

2、重要方法

QSplitter类提供了多种方法来管理和控制分隔器及其子控件:

  • 构造函数

    • QSplitter(Qt::Orientation orientation, QWidget *parent = nullptr):根据指定的方向(水平或垂直)创建一个QSplitter对象,并可选地指定一个父控件。
  • 添加和移除控件

    • void addWidget(QWidget *widget):将一个子控件添加到QSplitter中。
    • int indexOf(QWidget *widget):返回子控件在QSplitter中的索引位置。
    • void insertWidget(int index, QWidget *widget):在指定索引位置插入一个子控件。
    • void removeWidget(QWidget *widget):从QSplitter中移除一个子控件。
  • 设置和获取属性

    • void setOrientation(Qt::Orientation orientation):设置QSplitter的方向为水平或垂直。
    • Qt::Orientation orientation() const:获取QSplitter的当前方向。
    • void setOpaqueResize(bool opaque):设置分隔器在调整大小时是否显示为不透明的样式。
    • bool isOpaqueResize() const:检查分隔器在调整大小时是否显示为不透明。
    • void setSizes(const QList<int> &sizes):设置子控件的初始大小。
    • QList<int> sizes() const:获取当前子控件的大小。
    • int handleWidth() const:获取分隔器的宽度。
    • void setCollapsible(int index, bool collapsible):设置指定索引位置的子控件是否可以折叠。
    • bool isCollapsible(int index) const:检查指定索引位置的子控件是否可以折叠。
  • 布局和刷新

    • void refresh():重新布局和绘制分隔器及其子控件。

3、重要信号

  • splitterMoved(int pos,int index):当分割条被移动时发射

    #include <QApplication>
    #include <QSplitter>
    #include <QTextEdit>
    #include <QFrame>
    #include <QHBoxLayout>
    #include <QWidget>

    int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    复制代码
      // 创建一个主窗口  
      QWidget mainWindow;  
      mainWindow.setWindowTitle("QSplitter Example");  
      mainWindow.setFixedSize(800, 600);  
    
      // 创建一个水平布局  
      QHBoxLayout *layout = new QHBoxLayout(&mainWindow);  
    
      // 创建一个水平方向的QSplitter  
      QSplitter *horizontalSplitter = new QSplitter(Qt::Horizontal);  
    
      // 设置子控件的初始大小  
      horizontalSplitter->setSizes(QList<int>() << 100 << 200 << 300);  
    
      // 创建并添加子控件到水平QSplitter中  
      QFrame *leftFrame = new QFrame();  
      leftFrame->setStyleSheet("QFrame{background-color:rgb(255, 0, 0)}");  
      leftFrame->setMinimumWidth(100);  
      horizontalSplitter->addWidget(leftFrame);  
    
      QTextEdit *textEdit = new QTextEdit();  
      horizontalSplitter->addWidget(textEdit);  
    
      QSplitter *verticalSplitter = new QSplitter(Qt::Vertical);  
      verticalSplitter->setOpaqueResize(false);  
    
      QFrame *topRightFrame = new QFrame();  
      topRightFrame->setStyleSheet("QFrame{background-color:rgb(0, 255, 0)}");  
      verticalSplitter->addWidget(topRightFrame);  
    
      QTextEdit *bottomRightTextEdit = new QTextEdit();  
      verticalSplitter->addWidget(bottomRightTextEdit);  
    
      // 将垂直QSplitter添加到水平QSplitter中  
      horizontalSplitter->addWidget(verticalSplitter);  
    
      // 将水平QSplitter添加到主布局中  
      layout->addWidget(horizontalSplitter);  
    
      // 设置主窗口的布局  
      mainWindow.setLayout(layout);  
    
      // 显示主窗口  
      mainWindow.show();  
    
      return app.exec();  

    }

觉得有帮助的话,打赏一下呗。。

相关推荐
Ethon_王42 分钟前
走进Qt--QWidget基类详解
c++·qt
狗蛋儿l5 小时前
qt 3d航迹图
开发语言·qt·3d
Ethon_王7 小时前
走进Qt--信号与槽机制详解与实战
c++·qt
十五年专注C++开发8 小时前
Qt中的全局函数讲解集合(全)
开发语言·c++·qt·算法
.hopeful.10 小时前
基于QT的仿QQ音乐播放器
开发语言·c++·qt
溟洵10 小时前
【C++ Qt】快速上手 显⽰类控件(Label、LCDNumber、ProcessBar、CalendarWidget)
开发语言·c++·qt
我真的不会C1 天前
QT中的事件及其属性
开发语言·qt
Ethon_王1 天前
走进Qt--工程文件解析与构建系统
c++·qt
zhangzhangkeji1 天前
QT6 源(45):分隔条 QSplitter 允许程序的用户修改布局,程序员使用 IDE时,就是分隔条的用户,以及其 QSplitter 源代码
qt
Ethon_王1 天前
Qt 入门&安装
qt