Класс 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.

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