En esta página

QModelIndex Class

La clase QModelIndex se utiliza para localizar datos en un modelo de datos. Más información...

Encabezado: #include <QModelIndex>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Comparaciones de QModelIndex

CategoríaTipos comparables
strongQModelIndex

Funciones públicas

QModelIndex()
int column() const
const void *constInternalPointer() const
QVariant data(int role = Qt::DisplayRole) const
Qt::ItemFlags flags() const
quintptr internalId() const
void *internalPointer() const
bool isValid() const
const QAbstractItemModel *model() const
(since 6.0) void multiData(QModelRoleDataSpan roleDataSpan) const
QModelIndex parent() const
int row() const
QModelIndex sibling(int row, int column) const
QModelIndex siblingAtColumn(int column) const
QModelIndex siblingAtRow(int row) const
QModelIndexList
bool operator!=(const QModelIndex &lhs, const QModelIndex &rhs)
bool operator<(const QModelIndex &lhs, const QModelIndex &rhs)
bool operator==(const QModelIndex &lhs, const QModelIndex &rhs)

Descripción detallada

Esta clase se utiliza como índice en los modelos de elementos derivados de QAbstractItemModel. El índice es utilizado por las vistas de elementos, los delegados y los modelos de selección para localizar un elemento en el modelo.

El modelo crea nuevos objetos `QModelIndex` mediante la función ` QAbstractItemModel::createIndex()`. Se puede construir un índice de modelo no válido con el constructor de `QModelIndex`. Los índices no válidos se utilizan a menudo como índices principales al hacer referencia a elementos de nivel superior en un modelo.

Los índices de modelo hacen referencia a elementos de los modelos y contienen toda la información necesaria para especificar su ubicación en dichos modelos. Cada índice se encuentra en una fila y columna determinadas, y puede tener un índice padre; utilice row(), column() y parent() para obtener esta información. Cada elemento de nivel superior de un modelo está representado por un índice de modelo que no tiene un índice padre; en este caso, parent() devolverá un índice de modelo no válido, equivalente a un índice construido con la forma de argumento cero del constructor QModelIndex().

Para obtener un índice de modelo que haga referencia a un elemento existente en un modelo, llama a ` QAbstractItemModel::index()` con los valores de fila y columna requeridos, y el índice de modelo del padre. Al hacer referencia a elementos de nivel superior en un modelo, proporciona `QModelIndex()` como índice padre.

La función ` model()` devuelve el modelo al que hace referencia el índice como un ` QAbstractItemModel`. La función `child()` se utiliza para examinar los elementos contenidos bajo el índice en el modelo. La función ` sibling()` permite recorrer los elementos del modelo que se encuentran en el mismo nivel que el índice.

Nota: Los índicesde modelo deben utilizarse inmediatamente y, a continuación, descartarse. No debe dar por sentado que los índices seguirán siendo válidos tras llamar a funciones del modelo que modifiquen la estructura del mismo o eliminen elementos. Si necesita conservar un índice de modelo a lo largo del tiempo, utilice un ` QPersistentModelIndex`.

Véase también «Programación de modelos y vistas», « QPersistentModelIndex » y « QAbstractItemModel ».

Documentación de las funciones de miembro

[constexpr noexcept] QModelIndex::QModelIndex()

Crea un nuevo índice de modelo vacío. Este tipo de índice de modelo se utiliza para indicar que la posición en el modelo no es válida.

Véase también isValid() y QAbstractItemModel.

[constexpr noexcept] int QModelIndex::column() const

Devuelve la columna a la que hace referencia este índice del modelo.

[noexcept] const void *QModelIndex::constInternalPointer() const

Devuelve un puntero const void * que utiliza el modelo para asociar el índice con la estructura de datos interna.

Véase también QAbstractItemModel::createIndex().

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

Devuelve los datos del modelo « role » especificado para el elemento al que hace referencia el índice, o un objeto « QVariant » creado por defecto si el índice de este modelo es « invalid ».

Qt::ItemFlags QModelIndex::flags() const

Devuelve los indicadores del elemento al que hace referencia el índice.

[constexpr noexcept] quintptr QModelIndex::internalId() const

Devuelve un ` quintptr ` que utiliza el modelo para asociar el índice con la estructura de datos interna.

Véase también QAbstractItemModel::createIndex().

[noexcept] void *QModelIndex::internalPointer() const

Devuelve un puntero de tipo ` void ` * que utiliza el modelo para asociar el índice con la estructura de datos interna.

Véase también QAbstractItemModel::createIndex().

[constexpr noexcept] bool QModelIndex::isValid() const

Devuelve ` true ` si este índice de modelo es válido; en caso contrario, devuelve ` false`.

Un índice válido pertenece a un modelo y tiene números de fila y columna no negativos.

Véase también model(), row() y column().

[constexpr noexcept] const QAbstractItemModel *QModelIndex::model() const

Devuelve un puntero al modelo que contiene el elemento al que hace referencia este índice.

Se devuelve un puntero const al modelo porque las llamadas a funciones no const del modelo podrían invalidar el índice del modelo y, posiblemente, provocar un fallo en la aplicación.

[since 6.0] void QModelIndex::multiData(QModelRoleDataSpan roleDataSpan) const

Rellena el objeto ` roleDataSpan ` indicado con los datos del elemento al que hace referencia el índice.

Esta función se introdujo en Qt 6.0.

QModelIndex QModelIndex::parent() const

Devuelve el índice padre del modelo o QModelIndex() si no tiene ningún índice padre.

Véase también sibling() y model().

[constexpr noexcept] int QModelIndex::row() const

Devuelve la fila a la que hace referencia este índice del modelo.

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

Devuelve el elemento hermano situado en row y column. Si no hay ningún elemento hermano en esa posición, se devuelve un QModelIndex no válido.

Véanse también parent(), siblingAtColumn() y siblingAtRow().

QModelIndex QModelIndex::siblingAtColumn(int column) const

Devuelve el elemento hermano situado en ` column ` correspondiente a la fila actual. Si no hay ningún elemento hermano en esa posición, se devuelve un error ` QModelIndex `.

Véase también sibling() y siblingAtRow().

QModelIndex QModelIndex::siblingAtRow(int row) const

Devuelve el elemento hermano situado en row para la columna actual. Si no hay ningún elemento hermano en esta posición, se devuelve un QModelIndex no válido.

Véase también sibling() y siblingAtColumn().

Elementos no miembros relacionados

QModelIndexList

Sinónimo de QList<QModelIndex>.

[constexpr noexcept] bool operator!=(const QModelIndex &lhs, const QModelIndex &rhs)

Devuelve « true » si el índice del modelo « lhs » no hace referencia a la misma ubicación que el índice del modelo « rhs »; en caso contrario, devuelve « false ».

[constexpr noexcept] bool operator<(const QModelIndex &lhs, const QModelIndex &rhs)

Devuelve « true » si el índice del modelo « lhs » es menor que el índice del modelo « rhs »; en caso contrario, devuelve « false ».

El cálculo de «menor que» no resulta directamente útil para los desarrolladores, ya que no está definido cómo se comparan los índices con padres diferentes. Este operador solo existe para que la clase pueda utilizarse con QMap.

[constexpr noexcept] bool operator==(const QModelIndex &lhs, const QModelIndex &rhs)

Devuelve « true » si el índice del modelo « lhs » hace referencia a la misma ubicación que el índice del modelo « rhs »; en caso contrario, devuelve « false ».

Para la comparación con otro índice de modelo se utilizan el puntero de datos interno, la fila, la columna y los valores del modelo.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.