En esta página

QModelRoleDataSpan Class

La clase `QModelRoleDataSpan` proporciona un intervalo sobre los objetos ` QModelRoleData `. Más información...

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

Funciones públicas

QModelRoleDataSpan()
QModelRoleDataSpan(Container &c)
QModelRoleDataSpan(QModelRoleData &modelRoleData)
QModelRoleDataSpan(QModelRoleData *modelRoleData, qsizetype len)
QModelRoleData *begin() const
QModelRoleData *data() const
QVariant *dataForRole(int role) const
QModelRoleData *end() const
qsizetype length() const
qsizetype size() const
QModelRoleData &operator[](qsizetype index) const

Descripción detallada

Un QModelRoleDataSpan se utiliza como abstracción de una matriz de objetos de tipo « QModelRoleData ».

Al igual que una vista, QModelRoleDataSpan proporciona un objeto pequeño (puntero y tamaño) que puede pasarse a funciones que necesiten examinar el contenido de la matriz. Un QModelRoleDataSpan puede construirse a partir de cualquier secuencia similar a una matriz (matrices simples, QVector, std::vector, QVarLengthArray, etc.). Además, no es propietario de la secuencia, por lo que esta debe mantenerse activa más tiempo que cualquier objeto QModelRoleDataSpan que haga referencia a ella.

A diferencia de una vista, QModelRoleDataSpan es un intervalo, por lo que permite modificar los elementos subyacentes.

El principal caso de uso de QModelRoleDataSpan es permitir que un modelo devuelva los datos correspondientes a diferentes roles en una sola llamada.

Para extraer un elemento de un modelo, una vista (a través de sus delegados) suele solicitar varios roles para el mismo índice llamando a ` data() ` tantas veces como sea necesario:

QVariant text = model->data(index, Qt::DisplayRole);
QVariant decoration = model->data(index, Qt::DecorationRole);
QVariant checkState = model->data(index, Qt::CheckStateRole);
// etc.

QModelRoleDataSpan permite a una vista solicitar los mismos datos mediante una sola llamada a la función.

Esto se consigue haciendo que la vista prepare una matriz adecuada de objetos ` QModelRoleData `, cada uno inicializado con el rol que se debe recuperar. A continuación, la matriz se envuelve en un objeto `QModelRoleDataSpan`, que luego se pasa a la función ` multiData() ` del modelo.

std::array<QModelRoleData, 3> roleData = { {
    QModelRoleData(Qt::DisplayRole),
    QModelRoleData(Qt::DecorationRole),
    QModelRoleData(Qt::CheckStateRole)
} };

// Usually, this is not necessary: A QModelRoleDataSpan
// will be built automatically for you when passing an array-like
// container to multiData().
QModelRoleDataSpan span(roleData);

model->multiData(index, span);

// Use roleData[0].data(), roleData[1].data(), etc.

Se recomienda que las vistas almacenen el array de objetos ` QModelRoleData ` (y, posiblemente, el `span` correspondiente) y lo reutilicen en llamadas posteriores al modelo. Esto permite reducir las asignaciones de memoria relacionadas con la creación y devolución de objetos ` QVariant `.

Por último, dado un objeto `QModelRoleDataSpan`, la responsabilidad del modelo es rellenar los datos correspondientes a cada rol del span. La forma de hacerlo depende de la clase de modelo concreta. A continuación se muestra un esbozo de una posible implementación que itera sobre el span y utiliza ` setData() ` en cada elemento:

void MyModel::multiData(const QModelIndex &index, QModelRoleDataSpan roleDataSpan) const
{
    for (QModelRoleData &roleData : roleDataSpan) {
        int role = roleData.role();

        // ... obtain the data for index and role ...

        roleData.setData(result);
    }
}

Véase también Programación Modelo/Vista y QAbstractItemModel::multiData().

Documentación de funciones miembro

[constexpr noexcept] QModelRoleDataSpan::QModelRoleDataSpan()

Crea un objeto QModelRoleDataSpan vacío. Su método ` data()` se establecerá en ` nullptr`, y su longitud, en cero.

[constexpr noexcept(...)] template <typename Container> requires if_compatible_container<Container> QModelRoleDataSpan::QModelRoleDataSpan(Container &c)

Crea un objeto `QModelRoleDataSpan` que abarca el contenedor ` c`, el cual puede ser cualquier contenedor contiguo de objetos ` QModelRoleData `. Por ejemplo, puede ser un ` QVector<QModelRoleData>`, un ` std::array<QModelRoleData, 10> `, etc.

Nota: El contenedor debe mantenerse activo mientras este objeto no haya sido destruido.

Nota: Esta función es «noexcept» cuando ` noexcept(std::data(c)) && noexcept(std::size(c)) ` es ` true`.

[constexpr noexcept] QModelRoleDataSpan::QModelRoleDataSpan(QModelRoleData &modelRoleData)

Crea un objeto `QModelRoleDataSpan` que abarca ` modelRoleData`, considerado como una matriz de un elemento.

[constexpr] QModelRoleDataSpan::QModelRoleDataSpan(QModelRoleData *modelRoleData, qsizetype len)

Crea un objeto `QModelRoleDataSpan` que abarca el array, comenzando en ` modelRoleData ` y con una longitud de ` len`.

Nota: El array debe mantenerse activo mientras este objeto no haya sido destruido.

[constexpr noexcept] QModelRoleData *QModelRoleDataSpan::begin() const

Devuelve un puntero al inicio del fragmento representado por este objeto.

[constexpr noexcept] QModelRoleData *QModelRoleDataSpan::data() const

Devuelve un puntero al principio del fragmento representado por este objeto.

[constexpr] QVariant *QModelRoleDataSpan::dataForRole(int role) const

Devuelve los datos asociados al primer QModelRoleData del span cuyo rol sea igual a role. Si no existe dicho objeto QModelRoleData, el comportamiento es indefinido.

Nota: Evita llamar a esta función desde el modelo, ya que un modelo no puede saber de antemano qué roles hay en un QModelRoleDataSpan determinado. En cambio, esta función es adecuada para vistas y delegados, que tienen control sobre los roles del span.

Véase también QModelRoleData::data().

[constexpr noexcept] QModelRoleData *QModelRoleDataSpan::end() const

Devuelve un puntero al elemento imaginario situado justo después del final del intervalo representado por este objeto.

[constexpr noexcept] qsizetype QModelRoleDataSpan::length() const

Devuelve la longitud del tramo representado por este objeto.

[constexpr noexcept] qsizetype QModelRoleDataSpan::size() const

Devuelve la longitud del tramo representado por este objeto.

[constexpr] QModelRoleData &QModelRoleDataSpan::operator[](qsizetype index) const

Devuelve una referencia modificable al « QModelRoleData » situado en la posición « index » dentro del «span».

Nota: index debe ser un índice válido para este span (0 <= index < size()).

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