En esta página

QPersistentModelIndex Class

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

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

Comparaciones de QPersistentModelIndex

CategoríaTipos comparables
fuerteQPersistentModelIndex
strongQModelIndex.

Funciones públicas

QPersistentModelIndex(const QModelIndex &index)
QPersistentModelIndex(const QPersistentModelIndex &other)
QPersistentModelIndex(QPersistentModelIndex &&other)
int column() const
QVariant data(int role = Qt::DisplayRole) const
Qt::ItemFlags flags() 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
void swap(QPersistentModelIndex &other)
operator QModelIndex() const
QPersistentModelIndex &operator=(QPersistentModelIndex &&other)
QPersistentModelIndex &operator=(const QModelIndex &other)
QPersistentModelIndex &operator=(const QPersistentModelIndex &other)
size_t qHash(const QPersistentModelIndex &key, size_t seed = 0)
bool operator!=(const QPersistentModelIndex &lhs, const QModelIndex &rhs)
bool operator!=(const QPersistentModelIndex &lhs, const QPersistentModelIndex &rhs)
bool operator<(const QPersistentModelIndex &lhs, const QPersistentModelIndex &rhs)
bool operator==(const QPersistentModelIndex &lhs, const QModelIndex &rhs)
bool operator==(const QPersistentModelIndex &lhs, const QPersistentModelIndex &rhs)

Descripción detallada

Un QPersistentModelIndex es un índice de modelo que una aplicación puede almacenar y utilizar posteriormente para acceder a la información de un modelo. A diferencia de la clase ` QModelIndex `, es seguro almacenar un `QPersistentModelIndex`, ya que el modelo garantizará que las referencias a los elementos sigan siendo válidas siempre que el modelo pueda acceder a ellos.

Es recomendable comprobar que los índices de modelo persistentes sean válidos antes de utilizarlos.

Nota: Nose puede almacenar un QPersistentModelIndex de un ` QStandardItemModel` en uno de los elementos del modelo.

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

Documentación de las funciones de miembro

QPersistentModelIndex::QPersistentModelIndex(const QModelIndex &index)

Crea un nuevo objeto `QPersistentModelIndex` que es una copia del modelo ` index`.

QPersistentModelIndex::QPersistentModelIndex(const QPersistentModelIndex &other)

Crea un nuevo `QPersistentModelIndex` que es una copia del índice del modelo persistente ` other `.

[noexcept] QPersistentModelIndex::QPersistentModelIndex(QPersistentModelIndex &&other)

Crea una instancia de `QPersistentModelIndex` mediante el operador `move`, de modo que apunte al mismo objeto al que apuntaba ` other `.

int QPersistentModelIndex::column() const

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

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

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

Véase también Qt::ItemDataRole y QAbstractItemModel::setData().

Qt::ItemFlags QPersistentModelIndex::flags() const

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

bool QPersistentModelIndex::isValid() const

Devuelve ` true ` si este índice de modelo persistente 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().

const QAbstractItemModel *QPersistentModelIndex::model() const

Devuelve el modelo al que pertenece el índice.

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

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

Esta función se introdujo en Qt 6.0.

Véase también Qt::ItemDataRole y QAbstractItemModel::setData().

QModelIndex QPersistentModelIndex::parent() const

Devuelve el objeto padre ` QModelIndex ` de este índice persistente, o un objeto no válido ` QModelIndex ` si no tiene padre.

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

int QPersistentModelIndex::row() const

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

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

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

Véase también parent().

[noexcept] void QPersistentModelIndex::swap(QPersistentModelIndex &other)

Sustituye este índice de modelo persistente por other. Esta operación es muy rápida y nunca falla.

QPersistentModelIndex::operator QModelIndex() const

Operador de conversión que devuelve un ` QModelIndex`.

[noexcept] QPersistentModelIndex &QPersistentModelIndex::operator=(QPersistentModelIndex &&other)

Asigna « other » a esta instancia de « QPersistentModelIndex ». .

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

Establece el índice del modelo persistente para que haga referencia al mismo elemento del modelo que el índice del modelo « other ».

QPersistentModelIndex &QPersistentModelIndex::operator=(const QPersistentModelIndex &other)

Establece el índice del modelo persistente para que haga referencia al mismo elemento de un modelo que el índice del modelo persistente « other ».

Elementos no miembros relacionados

[noexcept] size_t qHash(const QPersistentModelIndex &key, size_t seed = 0)

Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.

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

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

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

Devuelve ` true ` si el índice del modelo persistente ` lhs ` no es igual al índice del modelo persistente ` rhs `; en caso contrario, devuelve ` false`.

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

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

Los valores internos del puntero de datos, la fila, la columna y el modelo del índice del modelo persistente se utilizan al compararlo con otro índice de modelo persistente.

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

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

Los valores internos del puntero de datos, la fila, la columna y el modelo del índice del modelo persistente se utilizan al compararlo con otro índice de modelo.

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

Devuelve ` true ` si el índice del modelo persistente ` lhs ` es igual al índice del modelo persistente ` rhs `; en caso contrario, devuelve ` false`.

Al comparar con otro índice de modelo persistente, se utilizan el puntero de datos interno, la fila, la columna y los valores del modelo del índice de modelo persistente.

© 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.