Класс QModelIndex

Класс QModelIndex используется для определения местоположения данных в модели данных. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Открытые функции

Связанные внешние члены

Подробное описание

Класс QModelIndex используется для определения местоположения данных в модели данных.

Этот класс используется в качестве индекса в моделях элементов, производных от QAbstractItemModel. Индекс используется представлениями элементов, делегатами и моделями выделения для определения местоположения элемента в модели.

Новые объекты QModelIndex создаются моделью с помощью функции QAbstractItemModel::createIndex(). Недействительный индекс модели может быть создан с помощью конструктора QModelIndex. Недействительные индексы часто используются в качестве родительских индексов при ссылке на элементы верхнего уровня в модели.

Индексы модели ссылаются на элементы в моделях и содержат всю необходимую информацию для определения их местоположения в этих моделях. Каждый индекс находится в определенной строке и столбце и может иметь родительский индекс; используйте row(), column() и parent() для получения этой информации. Каждый элемент верхнего уровня в модели представлен индексом модели, у которого нет родительского индекса; в этом случае parent() вернет недействительный индекс модели, эквивалентный индексу, созданному с помощью нулевого аргумента формы конструктора QModelIndex().

Для получения индекса модели, который ссылается на существующий элемент в модели, вызовите QAbstractItemModel::index() с необходимыми значениями строки и столбца, а также индексом родителя. При ссылке на элементы верхнего уровня в модели передайте QModelIndex() в качестве родительского индекса.

Функция model() возвращает модель, на которую ссылается индекс, как QAbstractItemModel. Функция child() используется для проверки элементов, находящихся под индексом в модели. Функция sibling() позволяет проходить по элементам модели на одном уровне с индексом.

Примечание: Индексы модели следует использовать немедленно, а затем удалять. Не следует полагаться на то, что индексы останутся действительными после вызова функций модели, которые изменяют структуру модели или удаляют элементы. Если вам нужно сохранить индекс модели со временем, используйте QPersistentModelIndex.

См. также Программирование моделей/представлений, QPersistentModelIndex и QAbstractItemModel.

Документация по функциям-членам

QModelIndex::QModelIndex()

Создает новый пустой индекс модели. Этот тип индекса модели используется для указания того, что позиция в модели недействительна.

См. также isValid() и QAbstractItemModel.

int QModelIndex::column() const

Возвращает столбец, на который указывает этот индекс модели.

QVariant QModelIndex::data(int role = Qt::DisplayRole) const

Возвращает данные для данного role для элемента, на который указывает индекс.

Qt::ItemFlags QModelIndex::flags() const

Возвращает флаги для элемента, на который указывает индекс.

Эта функция была введена в Qt 4.2.

quintptr QModelIndex::internalId() const

Возвращает quintptr используемый моделью для сопоставления индекса со внутренней структурой данных.

См. также QAbstractItemModel::createIndex().

void *QModelIndex::internalPointer() const

Возвращает void * указатель, используемый моделью для сопоставления индекса со внутренней структурой данных.

См. также QAbstractItemModel::createIndex().

bool QModelIndex::isValid() const

Возвращает true если этот индекс модели действителен; в противном случае возвращает false.

Действительный индекс принадлежит модели и имеет неотрицательные значения строки и столбца.

См. также model(), row() и column().

const QAbstractItemModel *QModelIndex::model() const

Возвращает указатель на модель, содержащую элемент, на который ссылается этот индекс.

Возвращается постоянный указатель на модель, потому что вызовы функций модели, не являющихся постоянными, могут привести к недействительности индекса модели и, возможно, к сбою приложения.

QModelIndex QModelIndex::parent() const

Возвращает родителя индекса модели или QModelIndex() если у него нет родителя.

См. также sibling() и model().

int QModelIndex::row() const

Возвращает строку, на которую указывает этот индекс модели.

QModelIndex QModelIndex::sibling(int row, int column) const

Возвращает брата/сестру по позиции row и column. Если брата/сестры по этой позиции нет, возвращается недействительный QModelIndex.

См. также parent(), siblingAtColumn() и siblingAtRow().

QModelIndex QModelIndex::siblingAtColumn(int column) const

Возвращает брата/сестру по столбцу column для текущей строки. Если брата/сестры по этой позиции нет, возвращается недействительный QModelIndex.

Эта функция была введена в Qt 5.11.

См. также sibling() и siblingAtRow().

QModelIndex QModelIndex::siblingAtRow(int row) const

Возвращает брата/сестру по строке row для текущего столбца. Если брата/сестры по этой позиции нет, возвращается недействительный QModelIndex.

Эта функция была введена в Qt 5.11.

См. также sibling() и siblingAtColumn().

bool QModelIndex::operator!=(const QModelIndex &other) const

Возвращает true, если этот индекс модели не ссылается на то же место, что и индекс модели other; в противном случае возвращает false.

bool QModelIndex::operator<(const QModelIndex &other) const

Возвращает true, если этот индекс модели меньше, чем индекс модели other; в противном случае возвращает false.

Вычисление «меньше чем» не является непосредственно полезным для разработчиков — способ сравнения индексов с разными родителями не определен. Этот оператор существует только для того, чтобы класс можно было использовать с QMap.

Эта функция была добавлена в Qt 4.1.

bool QModelIndex::operator==(const QModelIndex &other) const

Возвращает true, если этот индекс модели ссылается на то же место, что и индекс модели other; в противном случае возвращает false.

При сравнении с другим индексом модели используются внутренний указатель на данные, строка, столбец и значения модели.