Qt中鼠标位置转QChart坐标系及QBarSeries标注锚点设置问题

我完全理解这个痛点——QChart的坐标系转换确实容易让人绕晕，尤其是在悬停事件里要精准定位callout的时候。下面我会一步步带你实现正确的坐标转换，在barSeriesHovered事件里搞定callout的锚点定位：

核心思路 #

要把鼠标位置转成QChart可用的坐标系，需要经过两次关键转换：

1. 全局鼠标坐标 → QChartView的局部坐标
2. QChartView局部坐标 → QChart的数值坐标系（或场景坐标系，用于定位callout）

完整代码实现 #

假设你已经有了自定义的Callout类（继承自QGraphicsWidget或QGraphicsItem），并且在MainWindow里有QChartView（比如ui->chartView）和QChart实例（比如m_chart），还有一个成员变量m_callout来管理标注框：

#include "callout.h"
#include <QCursor>
#include <QBarCategoryAxis>

void MainWindow::barSeriesHovered(bool status, int index, QBarSet *barset)
{
    // 鼠标离开柱子时，隐藏callout
    if (!status) {
        if (m_callout) {
            m_callout->hide();
        }
        return;
    }

    // 获取关键控件实例
    QChartView* chartView = ui->chartView;
    QChart* chart = m_chart;

    // 步骤1：全局鼠标坐标转成ChartView的局部坐标
    QPointF chartViewLocalPos = chartView->mapFromGlobal(QCursor::pos());

    // 步骤2：ChartView局部坐标转成QChart的数值坐标系（x为类别索引，y为柱子数值）
    QPointF chartValueCoord = chart->mapToValue(chartViewLocalPos);

    // 初始化callout（如果还没创建）
    if (!m_callout) {
        m_callout = new Callout(chart);
    }

    // 设置callout显示的内容（比如当前柱子的数值）
    m_callout->setText(QString("数值: %1").arg(barset->at(index)));

    // 步骤3：把数值坐标系转成场景坐标系（因为callout是场景中的图形项）
    QPointF scenePos = chart->mapToScene(chartValueCoord);

    // 设置callout的位置，往上偏移20像素避免遮挡鼠标/柱子
    m_callout->setPos(scenePos.x(), scenePos.y() - 20);

    // 如果你想让callout精准锚定柱子中心（而不是鼠标位置），可以用下面的代码替换上面的场景坐标转换：
    /*
    QBarCategoryAxis* xAxis = qobject_cast<QBarCategoryAxis*>(chart->axisX());
    if (xAxis) {
        // 柱子中心的x坐标：每个类别占1单位宽度，中心在索引+0.5的位置
        qreal barCenterX = index + 0.5;
        // 柱子的y坐标就是当前柱子的数值
        qreal barCenterY = barset->at(index);
        QPointF barCenter(barCenterX, barCenterY);
        // 转成场景坐标
        QPointF barScenePos = chart->mapToScene(barCenter);
        m_callout->setPos(barScenePos.x(), barScenePos.y() - 20);
    }
    */

    m_callout->show();
}

关键函数解释 #

• mapFromGlobal(QCursor::pos())：把系统全局的鼠标坐标，转换为QChartView控件内部的局部坐标，这是坐标转换的第一步。
• mapToValue(chartViewLocalPos)：把QChartView的局部坐标，转换为QChart的数值坐标系——也就是你在图表上看到的x轴类别、y轴数值对应的坐标。
• mapToScene(chartValueCoord)：把数值坐标系转换为QGraphicsScene的坐标，因为callout是场景中的图形项，必须用场景坐标来设置它的位置。

常见坑点提醒 #

1. 不要直接用QCursor::pos()设置callout位置，这是全局坐标，和图表的场景坐标系完全不匹配。
2. 确保你的Callout实例是添加到QChart的场景中的，比如在Callout的构造函数里调用chart->scene()->addItem(this)。
3. 如果你的x轴是QValueAxis而不是QBarCategoryAxis，柱子中心的x坐标计算方式会不同，需要根据轴的范围和柱子宽度调整。

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