如何超链接到QAbstractItemModel中的项目？

Question

使用的Qt版本：4.7.1和4.8

我将分层数据存储为从QAbstractItemModel派生的模型中的节点。我的应用程序GUI中有一个QTreeView来显示分层数据。 （对于这个问题，分层数据可能不是必不可少的;我已经适用于任何模型和视图中的任何类型数据的一般问题。）

我的应用程序GUI中有一个显示超链接的文本框（QPlainTextEdit小部件，但这不是必需的）。当用户点击超链接时，我可以拦截它并获取超链接的URL。到现在为止还挺好。

当我拦截该超链接时，我将使QTreeView导航到特定节点，根据需要扩展其父节点，以便用户可以看到它。

超链接的URL将采用格式，让我知道正在请求节点，并将包含有关该特定节点的标识信息。例如：

<a href="node://something">Click me to see node A</a>

因此，问题是：什么是可以识别特定节点的东西，并且可以编码为文本字符串？

我一直在读关于QPersistentModelIndex。开始时听起来是合理的。在我格式化超链接的时候，我肯定会知道特定节点的QModelIndex，并且可以从中构造一个QPersistentModelIndex。但我迷失了如何将其转换为字符串，然后将字符串转换回QModelIndex，我可以从中推断出特定的节点。

任何建议表示赞赏。

Answer 1

您可以在模型中声明自定义data role，并为每个项目设置此角色的唯一值。

//MyModel.h
class MyModel : public QAbstractItemModel
{
    enum MyRoles {
         UrlRole = Qt::UserRole
    };
    // (...)
}

//MyModel.cpp
QVariant MyModel::data(const QModelIndex &index, int role) const
{
    if (role == UrlRole)
    {
        return "uniqueUrl"; //Up to you to decide what you return here
    }
    // (...)
}

然后在执行搜索时，只需使用模型的match function匹配您的唯一字符串，并从列表中获取第一个索引。

QModelIndex MyDialog::getIndexForUrl(QString myUrl)
{
    QModelIndex index = QModelIndex();
    QModelIndexList resultList = ui->treeView->model()->match(QModelIndex(),
        MyModel::UrlRole, "uniqueUrl", 1, Qt::MatchFixedString | Qt::MatchCaseSensitive);

    if (!resultList.empty())
    {
        index = resultList.first();
    }
    return index;
}

您可能需要根据定义模型的方式调整标志和起始索引。

Answer 2

正如@Cendolt所建议的那样，使用QAbstractItemModel::match()通过自定义数据角色搜索数据模型中的项目是一个很好的主意。我能够使用这个想法而不必在我的自定义数据模型中覆盖match()。

不过，我提供给QAbstractItemModel::match()的参数有点不同。结合@ Cendolt的其余部分，以下内容适用于我的情况。

QAbstractItemModel * pModel = ...;

// Start searching from the root of the tree.
QModelIndex startIndex = pModel->index( 0, 0 );

QModelIndexList results = p->match(
  startIndex,
  MyModel::UrlRole,
  "uniqueUrl",
  1,
  Qt::MatchRecursive );

有效的起始索引

为行和列指定带零的起始QModelIndex对于完成搜索至关重要。当我使用默认构造的QModelIndex时，搜索从未调用我的模型的data()方法。我认为这是因为默认构造的QModelIndex对于行和列具有-1，这使得它成为无效索引。在QAbstractItemModel::match()（{Qt dir} \ src \ corelib \ kernel \ qabstractitemmodel.cpp）的代码中，请注意，如果索引无效，它会跳过调用data()。

匹配标志

特别是对于分层数据，使用Qt::MatchRecursive标志是必不可少的。否则，搜索不会爬入子节点。