QTreeView不能按子项内容长度自动出现水平滚动条及滚动不理想问题解决

本文链接：https://blog.youkuaiyun.com/danshiming/article/details/128642904

当QTreeView的子项内容超过其可视宽度时，设置水平滚动条策略为Qt::ScrollBarAlwaysOn无效。为实现自动显示滚动条，需创建QScrollArea，将QTreeView放入其中，并设置QTreeView的最小尺寸。同时，应禁用QTreeView的滚动条以避免与QScrollArea的滚动条冲突。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

现象

当树视图中的子项内容很长时，即比树视图可见的水平表头宽都长（宽）时，QTreeView水平滚动条不会自动出现，即使通过如下代码设置树视图的水平滚动条策略为Qt::ScrollBarAlwaysOn也不行：


m_pLayerTreeView->setHorizontalSrollBarPolicy(Qt::ScrollBarAlwaysOn);

现象如下：

树视图水平滚动策略为Qt::ScrollBarAsNeeded时的效果

树视图水平滚动策略为Qt::ScrollBarAlwaysOn时的效果

可以看到，树视图中的子项内容很长时，即比树视图可见的水平表头宽都长（宽）时，QTreeView水平滚动条不会自动出现，即水平滚动条出现了，滚动它也不能全部显示右侧的内容，即水平滚动条滚动最右边，树视图子中的内容依然显示不全。

解决方法

解决方法如下代码所示：


m_pLayerTreeView = new QTreeView(this);
auto pScrollArea = new QScrollArea(this);
pScrollArea->setWidget(m_pLayerTreeView);

/* 设置pScrollArea可以通过布局器来调整大小。该属性值默认设置为false，如果该值为false，则外层布局器改变大小
时，pScrollArea不会自动改变大小以适应布局器
*/
pScrollArea->setWidgetResizeable(true); 

// 注意：一定要调用用setMinimumSize函数来设置树视图的最小尺寸，否则会产生前文树视图自己滚动条同样的问题
m_pLayerTreeView->setMinimumSize(300， 600）;

也就是说要实现QTreeView水平滚动条按显示内容水平占据的范围自动出现和滚动，则必须创建一个

QScrollArea对象，然后将树视图对象通过QScrollArea对象的setWidget加入到它里面才行，上述代码效果如下：

一般地：当采用上述方法时，要用如下代码将树视图的垂直和水平滚动条禁止显示，否则QScrollArea对象和树视图对象都显示滚动条会很丑，客户也感觉到莫名其妙,客户会想：到底用哪个滚动条呢？


m_pLayerTreeView->setHorizontalSrollBarPolicy(Qt::ScrollBarAlwaysOff);
m_pLayerTreeView->setVerticalSrollBarPolicy(Qt::ScrollBarAlwaysOff);