当前位置: 首页 > news >正文

QT实现DockWidget内部组件自动换行布局

主要功能概述

当DockWidget窗口大小改变时,内部的按钮能够自动重新排列,以最佳方式利用可用空间。具体表现为:

1. 当水平空间足够时,按钮排成一行

2. 当水平空间不足时,按钮自动换行

程序环境

Python 3.8.9
pyside6==6.1.3

pip install pyside6==6.1.3

设计结构图解

微信图片_2025-10-22_152148_073

实现效果

20251022_155729

demo代码获取

Gitee:dockwidget-demo

百度网盘:https://pan.baidu.com/s/1PRAjVGBtLQFZkWnZsJ2f2A?pwd=eiti

image

代码实现

以下是完整的实现代码:

import re
import sys
from PySide6.QtWidgets import QApplication
from ui_main_windowtest import *class MainWindow(QMainWindow, Ui_MainWindow):def __init__(self):super().__init__()self.setupUi(self)self.row = 0    # 行self.col = 0    # 列self.buttons_per_row = 0    # 每行按钮数量self.scrollArea.widget().installEventFilter(self)# 获取布局参数self.h_spacing = self.gridLayout_2.horizontalSpacing()self.v_spacing = self.gridLayout_2.verticalSpacing()self.margins = self.gridLayout_2.contentsMargins()# 获取第一个按钮的参考尺寸if self.gridLayout_2.count() > 0:first_button = self.gridLayout_2.itemAt(0).widget()self.button_width = first_button.sizeHint().width() + self.h_spacingself.button_height = first_button.sizeHint().height() + self.v_spacing + 10 # 根据测试这里+10容差可以防止出现程序无限执行rearrangeButtons方法的情况def eventFilter(self, obj, event):"""监控ScrollArea内widget的resize事件"""if event.type() == QEvent.Resize:# 获取当前可用宽高available_height = self.scrollArea.widget().size().height()available_width = self.scrollArea.widget().size().width()# 检查是否需要重新排列按钮if available_height > (self.row + 1) * self.button_height and available_width > self.button_width:self.rearrangeButtons()elif available_width > (self.buttons_per_row + 1) * self.button_width and available_height > self.button_height:self.rearrangeButtons()return super().eventFilter(obj, event)def rearrangeButtons(self):"""重新排列按钮以适应新的窗口大小"""# 计算新的每行按钮数量available_width = self.scrollArea.widget().width() - self.margins.left() - self.margins.right()new_buttons_per_row = max(1, available_width // self.button_width)# 如果每行按钮数量没有变化,则不需要重新排列if new_buttons_per_row != self.buttons_per_row:self.buttons_per_row = new_buttons_per_rowelse:return# 收集所有按钮buttons = []for i in range(self.gridLayout_2.count()):item = self.gridLayout_2.itemAt(i)if item.widget():buttons.append(item.widget())# 按按钮名称自然排序(1, 2, 3, ..., 10, 11),不排序每次重启程序顺序都会不一样buttons.sort(key=lambda btn: [int(text) if text.isdigit() else text.lower()for text in re.split('([0-9]+)', btn.objectName())])# 清除当前布局while self.gridLayout_2.count():item = self.gridLayout_2.takeAt(0)if item.widget():item.widget().setParent(None)# 重新排列按钮for i, button in enumerate(buttons):self.row = i // self.buttons_per_rowself.col = i % self.buttons_per_rowself.gridLayout_2.addWidget(button, self.row, self.col)if __name__ == "__main__":app = QApplication(sys.argv)window = MainWindow()window.show()sys.exit(app.exec())

代码解析

1. 初始化布局参数

获取了布局的关键参数,这些参数用于准确计算可用空间和按钮尺寸:

self.h_spacing = self.gridLayout_2.horizontalSpacing()
self.v_spacing = self.gridLayout_2.verticalSpacing()
self.margins = self.gridLayout_2.contentsMargins()

2. 计算按钮尺寸

我们以scrollArea第一个Qwidget为参考,计算Qwidget的宽度和高度(所有Qwidget宽高必须统一):

ps:这里变量名写成了button,其实获取的是Qwidget的宽度和高度

first_button = self.gridLayout_2.itemAt(0).widget()
self.button_width = first_button.sizeHint().width() + self.h_spacing
self.button_height = first_button.sizeHint().height() + self.v_spacing + 10

注意这里加了10像素的容差,这是为了避免在某些边界情况下出现无限循环的问题。

3. 事件过滤器

通过eventFilter监控ScrollArea内widget的resize事件:

def eventFilter(self, obj, event):if event.type() == QEvent.Resize:# 获取当前可用宽高available_height = self.scrollArea.widget().size().height()available_width = self.scrollArea.widget().size().width()# 检查是否需要重新排列if available_height > (self.row + 1) * self.button_height and available_width > self.button_width:self.rearrangeButtons()elif available_width > (self.buttons_per_row + 1) * self.button_width and available_height > self.button_height:self.rearrangeButtons()return super().eventFilter(obj, event)

4. 重新排列按钮

rearrangeButtons方法是核心逻辑所在:

def rearrangeButtons(self):# 计算新的每行按钮数量available_width = self.scrollArea.widget().width() - self.margins.left() - self.margins.right()new_buttons_per_row = max(1, available_width // self.button_width)# 如果每行按钮数量没有变化,则不需要重新排列if new_buttons_per_row != self.buttons_per_row:self.buttons_per_row = new_buttons_per_rowelse:return# 收集并排序按钮buttons = []for i in range(self.gridLayout_2.count()):item = self.gridLayout_2.itemAt(i)if item.widget():buttons.append(item.widget())# 使用正则表达式实现按钮名称的自然排序,可以通过命名的方式强制规定Qwidget组件顺序buttons.sort(key=lambda btn: [int(text) if text.isdigit() else text.lower()for text in re.split('([0-9]+)', btn.objectName())])# 清除当前布局while self.gridLayout_2.count():item = self.gridLayout_2.takeAt(0)if item.widget():item.widget().setParent(None)# 重新排列for i, button in enumerate(buttons):self.row = i // self.buttons_per_rowself.col = i % self.buttons_per_rowself.gridLayout_2.addWidget(button, self.row, self.col)

注意事项

  1. 按钮尺寸:DockWidget下的所有Qwidget应具有相同或相似的尺寸,否则布局可能会不均匀
  2. 容差设置:代码中的+10像素容差是经验值,可能需要根据实际情况调整

END 😃

http://www.hskmm.com/?act=detail&tid=36720

相关文章:

  • 2025年知名的工业防锈漆厂家最新推荐榜 - Di
  • java8以上快速生成wsdl
  • 2025 年 10 月深圳市激光雕刻机厂家解析,基于专业技术及市场分析
  • UMDF驱动开发入门:二 详解INF文件与设备类选择
  • 2025年诚信的光学真空镀膜机厂家推荐及选择指南 - Di
  • 2025 蛋白/8秒液体/发膜推荐榜:玛丝兰 5 星领跑,这些修护力出众的品牌值得囤!西安悦己容凭技术实力登顶
  • 2025年耐用的破碎机TOP厂家推荐
  • 2025年知名的雕塑推荐TOP品牌企业 - Di
  • 美股及墨西哥股票数据接口文档
  • Spring - 教程
  • 例子:vue3+vite+router创建多级导航菜单
  • 2025 - Di
  • JVM探究(Leo)
  • Higress v2.1.8:30 项引擎更新 + 4 项控制台更新
  • 2025 年最新推荐!集装箱拖车供应厂家权威榜单重磅发布,全方位解析优质厂家实力助企业选对合作伙伴
  • 实战案例 | 利用山海鲸可视化软件,构建制造业数字孪生监控大屏
  • 权威调研榜单:无线电环形导轨配件生产厂家TOP3榜单好评深度解析
  • 10.22模拟赛总结
  • 从零开始制作操作系统—— 最简单的操作系统内核
  • 【CSP出版 | 最快投稿后一个月见刊 | 检索稳定】2025年艺术、教育与管理国际学术会议(ICAEM 2025)- 第六期
  • 【LeetCode 每日一题】120. 三角形最小路径和——(解法二)自底向上 - 实践
  • HDFS Java api操作-cnblog
  • 电网不平衡条件下DFIG风力发电机动态建模与控制
  • Pandas 深入学习【3】材料标准化处理 StandardScaler
  • C#实现CRC8、CRC16、CRC32校验算法
  • JAVA 开发者入门 AI:基于 JBoltAI 平台快速搭建第一个 AI 应用
  • 2025 年切纸机源头厂家最新推荐榜单:全自动 / 程控 / 大型等设备品牌评测,深度解析大鹏等企业实力
  • 成功案例分享|ArmSoM CM5赋能海洋保育,边缘AI守护鲸豚之声
  • 2025 年最新推荐走心机加工实力厂家排行榜:覆盖航空 / 医疗 / 汽车等多领域优质企业精选 不锈钢零件/高铁零件/精密数控走心机加工厂家推荐
  • 权威调研榜单:简易丝杆模组厂家TOP3榜单好评深度解析