QModelRoleDataSpan Class

Description détaillée

Un QModelRoleDataSpan est utilisé comme abstraction sur un tableau d'objets QModelRoleData.

Comme une vue, le QModelRoleDataSpan fournit un petit objet (pointeur et taille) qui peut être transmis aux fonctions qui ont besoin d'examiner le contenu du tableau. Un QModelRoleDataSpan peut être construit à partir de n'importe quelle séquence de type tableau (tableaux simples, QVector, std::vector, QVarLengthArray, et ainsi de suite). En outre, il ne possède pas la séquence, qui doit donc être maintenue en vie plus longtemps que les objets QModelRoleDataSpan qui la référencent.

Contrairement à une vue, QModelRoleDataSpan est une portée, ce qui permet de modifier les éléments sous-jacents.

Le principal cas d'utilisation de QModelRoleDataSpan est de permettre à un modèle de renvoyer les données correspondant à différents rôles en un seul appel.

Pour dessiner un élément à partir d'un modèle, une vue (par l'intermédiaire de ses délégués) demandera généralement plusieurs rôles pour le même index en appelant data() autant de fois que nécessaire :

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

QModelRoleDataSpan permet à une vue de demander les mêmes données en utilisant un seul appel de fonction.

Pour ce faire, la vue doit préparer un tableau approprié d'objets QModelRoleData, chacun étant initialisé avec le rôle à récupérer. Le tableau est ensuite enveloppé dans un objet QModelRoleDataSpan, qui est ensuite transmis à la fonction multiData() d'un modèle.

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.

Les vues sont encouragées à stocker le tableau d'objets QModelRoleData (et, éventuellement, le span correspondant) et à le réutiliser dans les appels ultérieurs au modèle. Cela permet de réduire les allocations de mémoire liées à la création et au renvoi des objets QVariant.

Enfin, étant donné un objet QModelRoleDataSpan, la responsabilité du modèle est de remplir les données correspondant à chaque rôle dans le span. La manière de procéder dépend de la classe de modèle concrète. Voici une esquisse d'une implémentation possible qui itère sur la portée et utilise setData() sur chaque élément :

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);
    }
}