如何在QT中创建带箭头、圆角抗锯齿的自定义即时Tooltip？

针对你需要的带精准定位箭头、可手动关闭且支持圆角抗锯齿的Tooltip需求，我推荐用自定义QWidget子类来实现——这能完美避开QDialog的焦点阻塞问题，同时完全掌控样式和行为。下面是具体的实现思路和代码示例：

核心思路 #

放弃QDialog的Qt::Popup标志（它会强制获取焦点导致父窗口冻结），改用Qt::ToolTip窗口标志配合无框、透明背景属性，这样Tooltip不会干扰父窗口的事件响应。同时通过重写paintEvent自定义绘制圆角背景和指向箭头，实现你要的视觉效果。

完整代码实现 #

自定义Tooltip类头文件（CustomTooltip.h） #

#include <QWidget>

class CustomTooltip : public QWidget
{
    Q_OBJECT
public:
    // 箭头方向枚举
    enum ArrowPosition {
        ArrowTop,    // 箭头向上（Tooltip在目标下方）
        ArrowBottom, // 箭头向下（Tooltip在目标上方）
        ArrowLeft,   // 箭头向左（Tooltip在目标右侧）
        ArrowRight   // 箭头向右（Tooltip在目标左侧）
    };

    explicit CustomTooltip(QWidget *parent = nullptr);

    // 设置Tooltip文本
    void setText(const QString &text);
    // 在指定全局位置显示Tooltip，指定箭头方向
    void showAt(const QPoint &globalPos, ArrowPosition arrowPos);
    // 静态快捷方法：显示Tooltip（自动管理单例，避免重复显示）
    static void showTooltip(const QString &text, const QPoint &globalPos, ArrowPosition arrowPos = ArrowBottom);
    // 静态快捷方法：关闭当前Tooltip
    static void hideTooltip();

protected:
    void paintEvent(QPaintEvent *event) override;

private:
    QString m_text;
    ArrowPosition m_arrowPos;
    static CustomTooltip *s_instance; // 单例实例，确保同一时间只有一个Tooltip显示
    const int m_arrowSize = 8;        // 箭头大小
    const int m_padding = 10;         // 文本内边距
};

自定义Tooltip类源文件（CustomTooltip.cpp） #

#include "CustomTooltip.h"
#include <QPainter>
#include <QFontMetrics>

CustomTooltip* CustomTooltip::s_instance = nullptr;

CustomTooltip::CustomTooltip(QWidget *parent) : QWidget(parent)
{
    // 设置窗口标志：无框、Tooltip类型（不抢焦点）、始终置顶
    setWindowFlags(Qt::FramelessWindowHint | Qt::ToolTip | Qt::WindowStaysOnTopHint);
    // 开启透明背景，才能绘制不规则形状（箭头+圆角）
    setAttribute(Qt::WA_TranslucentBackground);
    // 可选：关闭时自动销毁实例，避免内存泄漏
    setAttribute(Qt::WA_DeleteOnClose);
}

void CustomTooltip::setText(const QString &text)
{
    m_text = text;
    // 根据文本内容自动计算Tooltip大小
    QFontMetrics fm(font());
    QSize textSize = fm.size(Qt::TextWordWrap, text);
    resize(textSize.width() + 2*m_padding, textSize.height() + 2*m_padding);
}

void CustomTooltip::showAt(const QPoint &globalPos, ArrowPosition arrowPos)
{
    m_arrowPos = arrowPos;
    // 计算窗口位置，让箭头精准指向目标点
    QPoint pos = globalPos;
    switch (arrowPos) {
    case ArrowTop:
        pos.setY(pos.y() + m_arrowSize);
        pos.setX(pos.x() - width()/2);
        break;
    case ArrowBottom:
        pos.setY(pos.y() - height() - m_arrowSize);
        pos.setX(pos.x() - width()/2);
        break;
    case ArrowLeft:
        pos.setX(pos.x() + m_arrowSize);
        pos.setY(pos.y() - height()/2);
        break;
    case ArrowRight:
        pos.setX(pos.x() - width() - m_arrowSize);
        pos.setY(pos.y() - height()/2);
        break;
    }
    move(pos);
    show();
}

void CustomTooltip::showTooltip(const QString &text, const QPoint &globalPos, ArrowPosition arrowPos)
{
    // 如果已有Tooltip显示，先关闭
    if (s_instance) {
        s_instance->close();
    }
    s_instance = new CustomTooltip();
    s_instance->setText(text);
    s_instance->showAt(globalPos, arrowPos);
}

void CustomTooltip::hideTooltip()
{
    if (s_instance) {
        s_instance->close();
        s_instance = nullptr;
    }
}

void CustomTooltip::paintEvent(QPaintEvent *event)
{
    Q_UNUSED(event);
    QPainter painter(this);
    // 开启抗锯齿，确保圆角和箭头边缘平滑
    painter.setRenderHint(QPainter::Antialiasing);

    // 构建背景路径（圆角矩形+箭头）
    QPainterPath path;
    QRect contentRect = rect().adjusted(m_padding/2, m_padding/2, -m_padding/2, -m_padding/2);

    // 添加圆角矩形主体
    path.addRoundedRect(contentRect, 8, 8);

    // 添加箭头路径
    QPoint arrowPoint;
    switch (m_arrowPos) {
    case ArrowTop:
        arrowPoint = QPoint(width()/2, 0);
        path.moveTo(arrowPoint.x() - m_arrowSize, arrowPoint.y());
        path.lineTo(arrowPoint.x(), arrowPoint.y() + m_arrowSize);
        path.lineTo(arrowPoint.x() + m_arrowSize, arrowPoint.y());
        path.closeSubpath();
        break;
    case ArrowBottom:
        arrowPoint = QPoint(width()/2, height());
        path.moveTo(arrowPoint.x() - m_arrowSize, arrowPoint.y());
        path.lineTo(arrowPoint.x(), arrowPoint.y() - m_arrowSize);
        path.lineTo(arrowPoint.x() + m_arrowSize, arrowPoint.y());
        path.closeSubpath();
        break;
    case ArrowLeft:
        arrowPoint = QPoint(0, height()/2);
        path.moveTo(arrowPoint.x(), arrowPoint.y() - m_arrowSize);
        path.lineTo(arrowPoint.x() + m_arrowSize, arrowPoint.y());
        path.lineTo(arrowPoint.x(), arrowPoint.y() + m_arrowSize);
        path.closeSubpath();
        break;
    case ArrowRight:
        arrowPoint = QPoint(width(), height()/2);
        path.moveTo(arrowPoint.x(), arrowPoint.y() - m_arrowSize);
        path.lineTo(arrowPoint.x() - m_arrowSize, arrowPoint.y());
        path.lineTo(arrowPoint.x(), arrowPoint.y() + m_arrowSize);
        path.closeSubpath();
        break;
    }

    // 绘制背景（半深灰，可自行修改颜色）
    painter.fillPath(path, QColor(50,50,50,240));
    // 绘制白色文本
    painter.setPen(Qt::white);
    painter.drawText(contentRect, Qt::AlignCenter, m_text);
}

使用示例 #

在你的父窗口中，只需调用静态方法即可显示/关闭Tooltip：

// 示例：让Tooltip指向按钮的底部中心（箭头向上）
QPoint btnBottomCenter = ui->pushButton->mapToGlobal(
    QPoint(ui->pushButton->width()/2, ui->pushButton->height())
);
CustomTooltip::showTooltip("这是自定义的带箭头Tooltip", btnBottomCenter, CustomTooltip::ArrowTop);

// 示例：手动关闭Tooltip
// CustomTooltip::hideTooltip();

方案优势 #

1. 无焦点阻塞：使用Qt::ToolTip标志，Tooltip不会获取焦点，父窗口的所有事件（悬停、点击等）都能正常响应，解决了你之前QDialog的冻结问题。
2. 精准定位：通过showAt方法可以指定全局坐标，箭头会精准指向目标点。
3. 圆角抗锯齿：开启QPainter::Antialiasing渲染提示，配合QPainterPath绘制整体路径，实现平滑的圆角和箭头。
4. 灵活可控：提供静态方法方便外部调用关闭，也支持自定义箭头方向、文本内容和样式。

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