Qt::ItemDataRole
模型中的每个数据项都会有一组与其对应的数据元素,每个数据元素对应一个角色.视图通过这些角色来告诉模型自己需要什么类型的数据.
通用角色
| Name | value | Type | Description |
|---|---|---|---|
| Qt::DisplayRole | 0 | QString | 以文本方式呈现的最关键数据 |
| Qt::DecorationRole | 1 | QColor,QIcon,QPixmap | 以图标方式呈现的装饰数据 |
| Qt::EditRole | 2 | QString | 适合在编辑器中编辑的数据形式 |
| Qt::ToolTipRole | 3 | QString | 提示中显示的数据 |
| Qt::StatusTipRole | 4 | QString | 状态栏中显示的数据 |
| Qt::WhatsThisRole | 5 | QString | "这是什么"中显示的数据 |
| Qt::SizeHitRole | 13 | QSize | 大小提示 |
外观和元数据
| Name | value | Type | Description |
|---|---|---|---|
| Qt::FontRole | 6 | QFront | 字体 |
| Qt::TextAlignmentRole | 7 | Qt::AlignmentFlag | 对齐方式 |
| Qt::BackgroundRole | 8 | QBrush | 背景刷 |
| Qt::ForegroundRole | 9 | QBrush | 前景刷 |
| Qt::CheckStateRole | 10 | Qt::CheckState | 选中状态 |
| Qt:: InitialSortOrderRole | 14 | Qt::SortOrder | 标题视图初始排序顺序 |
辅助功能
| Name | value | Type | Description |
|---|---|---|---|
| Qt::AccessibleTextRole | 11 | QString | 用于辅助功能和插件扩展的文本(如屏幕阅读器) |
| Qt::AccessibleDescriptionRole | 12 | QString | 用于无障碍项目的描述 |
用户角色
| Name | value | Type | Description |
|---|---|---|---|
| Qt::UserRole | 0x0100 | 不定 | 用于应用程序的特定目的(自己定义用途).用户自己决定使用什么数据,如何处理.数据 |
如果程序需要,可以使用多个用户自定义角色,第一个为Qt::UserRole,第二个为Qt::UserRole+1,一次类推.具体存储何种数据都由应用程序开发者来决定.
