QModelRoleDataSpan Class

Descripción Detallada

Un QModelRoleDataSpan se utiliza como una abstracción sobre un array de objetos QModelRoleData.

Al igual que una vista, QModelRoleDataSpan proporciona un pequeño objeto (puntero y tamaño) que puede pasarse a funciones que necesitan examinar el contenido del array. Un QModelRoleDataSpan puede construirse a partir de cualquier secuencia de tipo array (arrays planos, QVector, std::vector, QVarLengthArray, etc.). Además, no es propietaria de la secuencia, que por tanto debe mantenerse viva más tiempo que cualquier objeto QModelRoleDataSpan que haga referencia a ella.

A diferencia de una vista, QModelRoleDataSpan es un span, por lo que permite modificaciones en los elementos subyacentes.

El principal caso de uso de QModelRoleDataSpan es hacer posible 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) generalmente solicitará múltiples 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 utilizando 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 debe obtenerse. La matriz se envuelve en un objeto QModelRoleDataSpan, que 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 a las vistas que almacenen la matriz de objetos QModelRoleData (y, posiblemente, el span correspondiente) y la 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 en el span. La forma de hacerlo depende de la clase concreta del modelo. Aquí hay un boceto de una posible implementación que itera sobre el span y usa 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);
    }
}