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 數據模型的方式。