О типах ролей в моделях Qt :: Cетевой уголок Majestio

О типах ролей в моделях Qt


Каждый элемент в модели 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 Первая роль, которую можно использовать для конкретных целей приложения.


Ссылка на документацию: Qt5 / Qt6

Рейтинг: 0/5 - 0 голосов