PySide6 QChart叠加QLineSeries与QScatterSeries时hover信号失效问题

在基于PySide6开发图表数据可视化Python模块时，需要实现区分鼠标悬停在QLineSeries线段与数据点上的不同事件。由于原生QLineSeries无法直接区分两类悬停事件，尝试组合使用QLineSeries与QScatterSeries，分别绑定二者的hover悬停信号做独立处理。测试时出现异常：添加QScatterSeries后，此前已添加的所有序列均无法正常发射hover信号，QLineSeries的悬停检测仅在线条略微超出图表绘图区边框的外侧区域生效，即便线条本身已被边框裁剪。

最小复现代码如下：

from PySide6.QtCharts import QChart, QChartView, QLineSeries, QScatterSeries
from PySide6.QtWidgets import QApplication, QMainWindow
from PySide6.QtGui import QPen, QColor


def on_line_hover():
    print("line hover")


def on_point_hover():
    print("point hover")


app = QApplication()
main_window = QMainWindow()
main_window.show()
chart = QChart()
chart_view = QChartView(chart, main_window)
main_window.setCentralWidget(chart_view)
line = QLineSeries()
line.setPen(QPen(QColor("black"), 10))
line.append(0, 0)
line.append(1, 1)
line.hovered.connect(on_line_hover)
points = QScatterSeries()
points.setPen(QPen(QColor("blue"), 10))
points.append(0.25, 0.25)
points.append(0.75, 0.75)
points.hovered.connect(on_point_hover)

chart.addSeries(line)
chart.addSeries(points)
chart.createDefaultAxes()


app.exec()

这不是框架预期设计行为，是配置错误叠加Qt Charts的事件判定逻辑导致的异常：

• Qt Charts的序列渲染遵循后添加的序列层级更高、覆盖在下层序列上方的规则，鼠标事件默认会被最上层命中的序列拦截，不会向下传递。
• 对QScatterSeries的配置存在错误：setPen()是用来设置散点标记的描边画笔，不是设置散点大小，给描边设置10px的宽度，会让每个散点的实际悬停判定区域远大于肉眼可见的散点尺寸，几乎覆盖整个绘图区域，直接挡住了下层的折线序列。
• 折线超出绘图区边框的部分没有被上层散点序列覆盖，所以只有这部分区域能正常触发折线的hover信号，和观察到的现象完全吻合。

按以下步骤调整即可正常实现区分线段和数据点悬停的需求：

• 修正QScatterSeries的尺寸配置，使用专门的setMarkerSize()方法设置散点大小，不要通过描边画笔宽度间接控制，避免判定区域异常放大。
• 修正槽函数的参数匹配，hovered信号会携带坐标点和悬停状态两个参数，槽函数需要对应签名避免触发异常。

修复后的可运行代码：

from PySide6.QtCharts import QChart, QChartView, QLineSeries, QScatterSeries
from PySide6.QtWidgets import QApplication, QMainWindow
from PySide6.QtGui import QPen, QColor


def on_line_hover(point, state):
    if state:
        print("hover on line")


def on_point_hover(point, state):
    if state:
        print("hover on data point")


app = QApplication()
main_window = QMainWindow()
chart = QChart()
chart_view = QChartView(chart, main_window)
main_window.setCentralWidget(chart_view)

line = QLineSeries()
line.setPen(QPen(QColor("black"), 3))
line.append(0, 0)
line.append(1, 1)
line.hovered.connect(on_line_hover)

points = QScatterSeries()
points.setColor(QColor("blue"))
points.setMarkerSize(10) # 设置散点实际像素大小
points.append(0.25, 0.25)
points.append(0.75, 0.75)
points.hovered.connect(on_point_hover)

chart.addSeries(line)
chart.addSeries(points)
chart.createDefaultAxes()

main_window.resize(400, 300)
main_window.show()
app.exec()

注意：调整后效果为鼠标悬停在折线的非数据点位置时触发折线的hover信号，悬停在蓝色散点（即数据点）位置时优先触发散点序列的hover信号，完全匹配需求。

内容的提问来源于stack exchange，提问作者dr.umma