QListWidget图标视图模式下调整窗口/对话框时项消失问题咨询

我之前也碰到过一模一样的情况，大概率是自定义项Widget的尺寸管理或者QListWidget的视图配置没做好，下面给你几个针对性的解决方案：

1. 给自定义Widget添加正确的sizeHint实现 #

QListWidget在图标模式下完全依赖项的sizeHint来计算布局位置，如果你的LayerWidget没重写这个方法，视图很可能无法正确识别项的尺寸，窗口resize时就会把项挤出视野或者直接隐藏。

在你的LayerWidget类里补上这段代码：

def sizeHint(self):
    # 根据你的缩略图和控件需求返回合适大小，比如缩略图100x100，加上文字区就设120x140
    return QtCore.QSize(120, 140)

2. 绑定ListWidgetItem的大小到Widget的sizeHint #

当你把自定义Widget加到QListWidget里时，必须手动同步Item的尺寸，否则ListWidget无法识别Widget的真实大小：

# 假设这是你添加列表项的代码段
item = QtGui.QListWidgetItem(self.list_widget)
layer_widget = LayerWidget()
# 把Item的大小和Widget的sizeHint绑定，让ListWidget能正确计算布局
item.setSizeHint(layer_widget.sizeHint())
self.list_widget.setItemWidget(item, layer_widget)

3. 配置QListWidget的视图模式参数 #

调整QListWidget的resize模式和图标大小，确保窗口变化时自动重新排列项：

self.list_widget = QtGui.QListWidget()
self.list_widget.setViewMode(QtGui.QListWidget.IconMode)
# 关键设置：开启自动调整布局，窗口resize时自动重排项
self.list_widget.setResizeMode(QtGui.QListWidget.Adjust)
# 设置图标大小和你的缩略图尺寸匹配
self.list_widget.setIconSize(QtCore.QSize(100, 100))
# 可选：设置项之间的间距，避免拥挤导致显示异常
self.list_widget.setSpacing(8)

4. 修复自定义Widget的内部布局问题 #

如果LayerWidget内部没有用布局管理控件，resize时控件可能会超出边界，看起来就像项消失了。确保用布局来管理内部元素：

class LayerWidget(QtGui.QWidget):
    def __init__(self):
        super(LayerWidget, self).__init__()
        # 用布局管理内部控件，避免手动定位的混乱
        layout = QtGui.QVBoxLayout(self)
        layout.setContentsMargins(4, 4, 4, 4)  # 设置内边距，防止控件贴边
        
        self.ui_thumbnail = QtSvg.QSvgWidget()
        self.ui_thumbnail.setFixedSize(100, 100)  # 固定缩略图大小，保持统一
        layout.addWidget(self.ui_thumbnail)
        
        # 比如添加一个显示层名称的标签
        self.ui_layer_name = QtGui.QLabel("Sample Layer")
        layout.addWidget(self.ui_layer_name)

5. 可选：处理resizeEvent刷新动态内容 #

如果你的自定义Widget有动态绘制的元素（比如SVG缩略图），可以在resize时强制刷新，避免显示异常：

def resizeEvent(self, event):
    super(LayerWidget, self).resizeEvent(event)
    # 刷新缩略图，确保尺寸变化后显示正常
    self.ui_thumbnail.update()

按照上面的步骤调整后，基本就能解决窗口resize时项消失的问题了。如果还是有异常，可以检查下PySide版本，某些旧版本的PySide在图标视图模式下存在布局bug，升级到较新的版本可能就能解决。

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