开发

这两天遇到两个问题： 1、对于一个 QTreeView，如何判断一个节点的 QModelIndex 是否处于 QTreeView 可视区域内。当 QTreeView 中有太多节点，必然有些节点是处于可视区域外部的，不显示的。QTreeView 也不会对这些不显示的节点调用 itemdelegate.paint() 方法。 2、如何获取 QTreeView 内容的滚动事件。 不只是对 QTreeView，所有的 QAbstractItemView 派生类，包括 QListView, QTableView 也都如此。 一、visualRect(index) QAbstractItemView.visualRect(index: QModelIndex) -> Qrect 返回 index 节点相对于可视区域 QAbstractItemView.viewport() 的位置矩形，即使节点在可视区域之外。（官方文档） 比如 viewport 是 (x=0, y=0, width=200, height=300)，如果节点的 visualRect(index) 返回的是 (0, -50, 200, 30)，那么这个节点就是在 viewport 之上的不可见区域。 所以，可以根据 visualRect.y 来判断节点是否处于可视区域。y < -height 或者 y > viewport.rect.height 的，都是在超出的不可见区域。 更简单的，可以使用 QRect.intersects(otherRect) 方法来判断 visualRect 与 viewport.rect 这两个矩形是否有交叉。如果有，就说明节点（部分/全部）处于可视区域。 intersect = treeView.visualRect(idx).intersects(treeView.viewport().rect()) logging.debug('%s 节点是否处于可视区域: %s', idx.data(), intersect) 二、indexAt(point), indexAbove(index), indexBelow(index) QAbstractItemView.indexAt(point: QPoint) -> QModelIndex 返回 viewport 中处于 point 位置的节点 index。（官方文档） 初次之外，QTreeView 还提供了两个特有的方法: indexAbove(index) -> QModelIndex 和 indexBelow(index) -> QModelIndex 用来返回位置紧邻着 index 之上，或之下的节点。如果 index 本来就是最顶端节点，没有 above，或者 index 本来就是最底部节点，没有 below。那么就会返回一个无效的 QModelIndex 实例 idx，用 idx.isValid() 判断返回 False，用 idx.data() 返回 None。 idx_topleft = self.treeView.indexAt(self.treeView.viewport().rect().topLeft()) # 取可视区域顶部位置的节点 idx_bottomright = self.treeView.indexAt(self.treeView.viewport().rect().bottomRight()) # 取可视区域底部位置的节点，如果没有，则返回一个无效 QModelIndex self.logger.info('左上节点: %s, 右下节点: %s', idx_topleft.data(), idx_bottomright.data()) self.logger.info('上上: %s, 下下: %s', self.treeView.indexAbove(idx_topleft).isValid(), self.treeView.indexBelow(idx_bottomright).isValid()) 三、verticalScrollBar(), horizontalScrollBar() 我一开始在 QTreeView, QAbstractitemView, QAbstractScrollArea 的官方文档里找了半天，也没有找到任何关于可视区域滚动的信号。后来也不知道怎么搜的，才发现原来 QAbstractitemView 是通过 verticalScrollBar / horizontalScrollBar 来触发滚动条滚动信号！！！😤 （ScrollBar 信号） self.treeView.verticalScrollBar().valueChanged.connect(self._on_v_scroll_changed) def _on_v_scroll_changed(self, value): self.logger.debug('V scroll bar value changed to: %s', value) pass  

1. 必须重写 paintEvent() 根据官方文档的说明，如果希望自定义的 QWidget 派生类能够响应 StyleSheet 中定义的样式，就必须用如下代码重写 paintEvent() 方法。（其实应该叫做实现 paintEvent()，因为 QWidget::paintEvent() 本来是个空函数，啥都没做） 换成 Python + PySide6 语法就是： class CustomWidget(QWidget): def __init__(self, parent: QWidget = None): super().__init__(parent) ... def paintEvent(self, event): opt = QStyleOption() opt.initFrom(self) painter = QPainter(self) self.style().drawPrimitive(QStyle.PrimitiveElement.PE_Widget, opt, painter, self) pass 2. paintEvent() 的作用 首先需要知道，所有 QWidget 派生类需要绘制的时候，都是调用 paintEvent() 方法进行绘制！（但 QWidget::paintEvent() 是空函数，具体实现都由派生类自己来做，比如 QLabel::paintEvent()） ① 如果继承自某个内建 widget（比如 QLabel, QPushButton 这些），那么重写该方法将会覆盖父类的绘制行为。 ② 如果该 widget 还有 child widgets 的话，在执行完自己的 paintEvent() 之后，还会接着自动调用所有 child widgets 的 paintEvent()！ （其实并不是所有，只需要调用与该 event.rect() 有交集的 child widgets 的 paintEvent() 方法。） ③ 对于由内建 widget 组合而成的自定义 widget。比如说我新建了一个 CustomWidget，它其实是由 QLabel + QPushButton 组合起来的。 那么根据 ② 中所述，是可以不需要重写 paintEvent() 方法的。child widgets 会自行绘制自己。 ④ 但是！如果不重写 paintEvent() 的话，自定义的 widget 就没办法响应 StyleSheet 中与其相匹配的样式。即在 qss 文件中，或者直接通过 setStyleSheet() 设置的 CustomWidget { background-color: #acdbb7 } 就无法生效。 3. 响应 StyleSheet 属性选择器的样式 CustomWidget[clicked="true"] { background-color: #dc5f5f } 这是 StyleSheet 属性选择器的例子。 要想让自定义控件 CustomWidget 的实例响应这个 [clicked="true"] 属性选择器。除了 CustomWidget 必须重写 paintEvent() 外，还必须在代码中给 CutomWidget 实例设置 clicked “属性”，还必须调用 QStyle.polish() 方法来重新加载 StyleSheet。 widget.setProperty('clicked', True) widget.style().polish(widget) 4. 示例代码 QSS = """ CustomWidget { background-color: #acdbb7 } CustomWidget[clicked="true"] { background-color: #dc5f5f } """ class CustomWidget(QWidget): def __init__(self, title: str, parent: QWidget = None): super().__init__(parent) # 1. 图标 self.label_icon = QLabel(self) self.label_icon.setPixmap(self.style().standardIcon(QStyle.StandardPixmap.SP_TitleBarMenuButton).pixmap(32, 32)) # 2. title self.label_title = QLabel(self) self.label_title.setText(title) self.horizontalLayout = QHBoxLayout(self) self.horizontalLayout.addWidget(self.label_icon) self.horizontalLayout.addWidget(self.label_title) pass def paintEvent(self, event): opt = QStyleOption() opt.initFrom(self) painter = QPainter(self) self.style().drawPrimitive(QStyle.PrimitiveElement.PE_Widget, opt, painter, self) pass def mousePressEvent(self, ev): self.setProperty('clicked', True) self.style().polish(self) pass if __name__ == '__main__': app = QApplication(sys.argv) app.setStyleSheet(QSS) main_window = QMainWindow() main_window.setCentralWidget(CustomWidget('测试')) main_window.show() sys.exit(app.exec()) pass  

假设现在有两个重叠显示的 QWidget 部件，widget_1 与 widget_2。二者无父子关系，只是位置重叠，widget_1 在 widget_2 之上，如下图所示。 这个时候如果鼠标点击在 widget_1 上，widget_2 是不会响应鼠标事件的。因为事件被位于上层的 widget_1 捕获了。 如果我们想让鼠标事件穿透 widget_1，由 widget_2 捕获。就可以给 widget_1 设置 WA_TransparentForMouseEvents 属性，让它对所有鼠标事件“透明”。 widget_1.setAttribute(QtCore.Qt.WidgetAttribute.WA_TransparentForMouseEvents) QLabel 显示富文本时会吞掉鼠标事件 今天还遇到一个问题，当 QLabel 作为子控件的时候，如果是 PlainText 模式，那么在 QLabel 上触发的鼠标事件会自动传递给父控件。但如果 QLabel 处于 RichText 模式，那么它会响应并且吞掉鼠标事件！事件无法传递给父控件！ BUG 复现代码如下： class Window(QMainWindow): def __init__(self): super().__init__() self.label = MyLabel(self) self.label.resize(200, 50) self.label.setStyleSheet("border: 1px solid black;") text = "Test mouse events on here" self.label.setText(text) self.label.setText("<p style='color:red;'>{}</p>".format(text)) # self.label.setAttribute(QtCore.Qt.WidgetAttribute.WA_TransparentForMouseEvents) def mouseReleaseEvent(self, e): if e.button() == QtCore.Qt.LeftButton: print("Left") if e.button() == QtCore.Qt.RightButton: print("Right") pass App = QApplication(sys.argv) window = Window() window.show() sys.exit(App.exec()) 有两种解决办法： （1）给 label 设置 setAttribute(QtCore.Qt.WidgetAttribute.WA_TransparentForMouseEvents) ，这样 label 自己就不响应鼠标事件，也不会吞掉事件而是直接传递给父节点。 （2）派生 QLabel，重写 mouseReleaseEvent() 方法，在该方法中，判断如果可能是富文本，就手动将鼠标事件传递给父节点。 def mouseReleaseEvent(self, event): if QtGui.Qt.mightBeRichText(self.text()): self.parent().mouseReleaseEvent(event) super().mouseReleaseEvent(event) pass