UserRole

Qt::UserRole 是 Qt::ItemDataRole 枚举中的一个成员，用于表示自定义数据角色（Data Role）的起始值。

在 Qt 中，Qt::ItemDataRole 枚举用于标识项（Item）中不同类型的数据。这些数据角色包括 Qt::DisplayRole、Qt::EditRole、Qt::ToolTipRole 等。每个数据角色都有特定的含义和用途。

而 Qt::UserRole 是用于表示用户自定义数据角色的起始值。它是一个预定义的常量，其值为 Qt::ItemDataRole(Qt::UserRole + 1)。通过使用 Qt::UserRole，我们可以创建和管理与项相关的自定义数据角色。

以下是一个示例，演示如何使用 Qt::UserRole 创建和访问自定义数据角色：

QStandardItemModel *model = new QStandardItemModel();

// 创建一个项
QStandardItem *item = new QStandardItem("Item 1");

// 设置自定义数据角色
item->setData("Custom Data", Qt::UserRole + 1);

// 将项添加到模型中
model->appendRow(item);

// 从模型中获取自定义数据角色
QString customData = model->data(model->index(0, 0), Qt::UserRole + 1).toString();

在上述示例中，我们创建了一个 QStandardItemModel 模型，并向其添加了一个项 item。通过调用 setData() 函数，我们将自定义数据（“Custom Data”）存储在项的 Qt::UserRole + 1 数据角色中。

然后，通过调用 data() 函数，我们可以从模型中检索存储在自定义数据角色中的自定义数据。

通过使用 Qt::UserRole 和其相邻值，我们可以轻松地创建和访问自定义数据角色，以满足特定的应用需求。这为我们提供了一种扩展和定制 Qt 数据模型的方式。