Qt布局添加水平滚动条且保留垂直自适应的技术问题咨询

在滚动布局嵌套场景中，原本内部使用Grid Layout，替换为QScrollArea后出现垂直方向压缩的问题。需求是仅开启水平滚动，垂直方向保持原布局的自适应拉伸效果，且不设置固定高度，咨询该压缩是否由父布局导致，相关代码如下：

for item in json_data:
        group_box = QFrame(frameShape=QFrame.StyledPanel)
        group_layout = QVBoxLayout(group_box)
        group_box.setContextMenuPolicy(Qt.CustomContextMenu)
        group_box.customContextMenuRequested.connect(
            lambda pos, gb=group_box: self.create_group_context_menu(gb).popup(
                gb.mapToGlobal(pos - QPoint(10, 10))))
        tip_frame = QFrame(frameShape=QFrame.StyledPanel)
        tip_layout = QVBoxLayout(tip_frame)
        pair_frame = QFrame(frameShape=QFrame.StyledPanel)
        pair_layout = QVBoxLayout(pair_frame)
        level_frame = QFrame(frameShape=QFrame.StyledPanel)
        level_layout = QVBoxLayout(level_frame)
        group_layout.addWidget(level_frame)
        group_layout.addWidget(tip_frame)
        group_layout.addWidget(pair_frame)
        for key in item.keys():
            button_layout = QHBoxLayout()
            button = QPushButton(key)
            button_layout.addWidget(button)
            # 确定正确的 layout
            current_layout = tip_layout if key == "tip" else pair_layout if key == "pair" else level_layout
            if key == "level":
                level_layout.addLayout(button_layout)
                label = QLineEdit(item[key])
                level_layout.addWidget(label)
            elif key == "pair":
                pair_layout.addLayout(button_layout)
                # 检查pair是否包含多层列表
                if all(isinstance(el, list) for el in item["pair"]):
                    sizePolicy = QSizePolicy(QSizePolicy.Preferred, QSizePolicy.Expanding)
                    container = QWidget()  # 创建一个容器
                    grid_layout = QGridLayout(container)  # 直接将容器设置给grid_layout
                    grid_layout.setHorizontalSpacing(39)

                    for col, sub_list in enumerate(item["pair"]):
                        for row, text in enumerate(sub_list):
                            text_edit = QLineEdit(text)
                            text_edit.setMinimumWidth(150)  # 固定文本框长度
                            text_edit.setContextMenuPolicy(Qt.CustomContextMenu)
                            text_edit.customContextMenuRequested.connect(
                                lambda pos, te=text_edit: self.create_context_menu(te).popup(
                                    te.mapToGlobal(pos - QPoint(10, 10))))
                            grid_layout.addWidget(text_edit, row, col)

                    scroll_area = QScrollArea()
                    scroll_area.setWidgetResizable(False)

                    scroll_area.setHorizontalScrollBarPolicy(Qt.ScrollBarAsNeeded)  # 总是开启水平滚动条
                    scroll_area.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOff)  # 关闭垂直滚动条
                    scroll_area.setWidget(container)  # 将装有grid_layout的容器设置到滚动区域
                    scroll_area.setMinimumHeight(150)

                    pair_layout.addWidget(scroll_area)  # 将滚动区域添加到pair_layout

压缩问题和父布局、滚动区域的配置都有关，核心是QScrollArea的默认尺寸策略与容器布局约束不匹配，调整点如下：

• 修改widgetResizable属性
  当前设置scroll_area.setWidgetResizable(False)会让滚动区域强制使用容器的初始尺寸，无法跟随父布局拉伸。改成True后，滚动区域会根据父布局调整大小，同时保留水平滚动能力。

• 设置正确的尺寸策略
  给容器和滚动区域都设置垂直方向的Expanding策略，确保父布局（pair_layout）分配足够的垂直空间：

  container.setSizePolicy(QSizePolicy.Preferred, QSizePolicy.Expanding)
  scroll_area.setSizePolicy(QSizePolicy.Preferred, QSizePolicy.Expanding)
  

• 移除固定最小高度
  删除scroll_area.setMinimumHeight(150)，让布局自动计算垂直高度，避免限制自适应能力。

• 给Grid Layout添加垂直拉伸因子
  给Grid的最后一行设置拉伸，让内部控件能占满垂直空间：

  # 先统计Grid的最大行数
  row_count = max(len(sub_list) for sub_list in item["pair"])
  if row_count > 0:
      grid_layout.setRowStretch(row_count - 1, 1)
  

• 检查父布局约束
  确保pair_layout（QVBoxLayout）没有设置固定垂直间距或高度限制，保持默认的拉伸行为。

调整后的关键代码片段：

elif key == "pair":
    pair_layout.addLayout(button_layout)
    if all(isinstance(el, list) for el in item["pair"]):
        container = QWidget()
        grid_layout = QGridLayout(container)
        grid_layout.setHorizontalSpacing(39)

        # 统计Grid的最大行数
        row_count = max(len(sub_list) for sub_list in item["pair"])
        for col, sub_list in enumerate(item["pair"]):
            for row, text in enumerate(sub_list):
                text_edit = QLineEdit(text)
                text_edit.setMinimumWidth(150)
                text_edit.setContextMenuPolicy(Qt.CustomContextMenu)
                text_edit.customContextMenuRequested.connect(
                    lambda pos, te=text_edit: self.create_context_menu(te).popup(
                        te.mapToGlobal(pos - QPoint(10, 10))))
                grid_layout.addWidget(text_edit, row, col)
        
        # 给最后一行设置垂直拉伸
        if row_count > 0:
            grid_layout.setRowStretch(row_count - 1, 1)

        # 设置容器的尺寸策略
        container.setSizePolicy(QSizePolicy.Preferred, QSizePolicy.Expanding)

        scroll_area = QScrollArea()
        scroll_area.setWidgetResizable(True)  # 开启自适应容器大小
        scroll_area.setHorizontalScrollBarPolicy(Qt.ScrollBarAsNeeded)
        scroll_area.setVerticalScrollBarPolicy(Qt.ScrollBarAlwaysOff)
        scroll_area.setWidget(container)
        # 设置滚动区域的尺寸策略
        scroll_area.setSizePolicy(QSizePolicy.Preferred, QSizePolicy.Expanding)
        
        pair_layout.addWidget(scroll_area)

内容的提问来源于stack exchange，提问作者Cvu Leua