Каждый элемент в модели Qt имеет набор связанных с ним элементов данных, каждый из которых имеет свою роль. Роли используются представлением, чтобы указать модели, какой тип данных ей нужен. Пользовательские модели должны возвращать данные в этих типах.
Роли общего назначения
Константа
Значение
Описание
Qt::DisplayRole
0
Ключевые данные, которые будут отображаться в виде текста. (QString)
Qt::DecorationRole
1
Данные для отображения в виде значка. (QColor, QIcon or QPixmap)
Qt::EditRole
2
Данные в форме, удобной для редактирования в редакторе. (QString)
Qt::ToolTipRole
3
Данные, отображаемые во всплывающей подсказке элемента. (QString)
Qt::StatusTipRole
4
Данные, отображаемые в строке состояния. (QString)
Qt::WhatsThisRole
5
Данные, отображаемые для элемента для действия «Что это?». (QString)
Qt::SizeHintRole
13
Подсказка размера для элемента, которая будет передана представлению. (QSize)
Роли внешнего вида и метаданных
Константа
Значение
Описание
Qt::FontRole
6
Шрифт, используемый для элементов, визуализируемых с помощью делегата по умолчанию. (QFont)
Qt::TextAlignmentRole
7
Выравнивание текста для элементов, отображаемых с делегатом по умолчанию. (Qt::Alignment)
Qt::BackgroundRole
8
Фоновая кисть, используемая для элементов, отображаемых с делегатом по умолчанию. (QBrush)
Qt::BackgroundColorRole
BackgroundRole
Эта роль устарела. Вместо этого используйте фоновую роль.
Qt::ForegroundRole
9
Кисть переднего плана (обычно цвет текста), используемая для элементов, отображаемых с делегатом по умолчанию. (QBrush)
Qt::TextColorRole
ForegroundRole
Эта роль устарела. Вместо этого используйте ForegroundRole.
Qt::CheckStateRole
10
Эта роль используется для получения состояния элемента checked. (Qt::CheckState)
Qt::InitialSortOrderRole
14
Эта роль используется для получения исходного порядка сортировки раздела представления заголовка. (Qt::SortOrder).
Роли доступности
Константа
Значение
Описание
Qt::AccessibleTextRole
11
Текст, который будет использоваться расширениями специальных возможностей и подключаемыми модулями, такими как программы чтения с экрана. (QString)
Qt::AccessibleDescriptionRole
12
Описание предмета в целях доступности. (QString)
Роли пользовательские
Константа
Значение
Описание
Qt::UserRole
0x0100
Первая роль, которую можно использовать для конкретных целей приложения.