Qt TreeWidget 项目高亮与交互指引实现方案

1. 概述

在 Qt 应用程序开发中，经常需要对 QTreeWidget 中的特定项目进行高亮显示并引导用户进行交互操作。本文介绍了一个专门的代理类 HighlightDelegate，它能够实现项目高亮、鼠标操作提示以及自动展开节点等功能。

2. 功能特点

• 支持单个或多个项目的高亮显示

• 提供可视化的鼠标操作提示（左键/右键点击）

• 支持文本搜索并自动高亮匹配项

• 自动展开包含匹配项的节点

• 点击响应验证

• 智能提示工具提示（tooltip）

3. 核心实现

3.1 类定义

Apply to HighlightIte...

class HighlightDelegate : public QStyledItemDelegate

{

    Q_OBJECT

public:

    // 定义鼠标操作类型

    enum MouseAction {

        NoAction = 0,

        LeftClick = 1,

        RightClick = 2,

        BothClick = LeftClick | RightClick

    };

    explicit HighlightDelegate(QObject *parent = nullptr);

    

    void highlightItem(QTreeWidgetItem *item, const QString &tooltip,