TreeModel QML Type
Encapsule un modèle d'arbre simple. Plus d'informations...
| Import Statement: | import Qt.labs.qmlmodels |
| Since: | Qt 6.10 |
Propriétés
- columnCount : int
- rows : object
Méthodes
- appendRow(object treeRow)
- appendRow(QModelIndex parent, object treeRow)
- clear()
- variant data(QModelIndex index, string role)
- object getRow(const QModelIndex &rowIndex)
- QModelIndex index(list<int> treeIndex, int column)
- QModelIndex index(int row, int column, object parent)
- removeRow(QModelIndex rowIndex)
- bool setData(QModelIndex index, variant value, string role)
- setRow(QModelIndex rowIndex, object treeRow)
Description détaillée
Le type TreeModel stocke des objets JavaScript/JSON en tant que données pour un modèle d'arbre qui peut être utilisé avec TreeView. Il est destiné à prendre en charge des modèles très simples sans nécessiter la création d'une sous-classe personnalisée de QAbstractItemModel en C++.
import QtQuick import QtQuick.Controls import Qt.labs.qmlmodels ApplicationWindow { visible: true width: 500 height: 500 TreeView { id: treeView anchors.fill: parent selectionModel: ItemSelectionModel {} model: TreeModel { id: treeModel TableModelColumn { display: "checked" } TableModelColumn { display: "size" } TableModelColumn { display: "type" } TableModelColumn { display: "name" } TableModelColumn { display: "lastModified" } rows: [{ checked: false, size: "—", type: "folder", name: "Documents", lastModified: "2025-07-01", rows: [{ checked: true, size: "24 KB", type: "file", name: "Resume.pdf", lastModified: "2025-06-20", }, { checked: false, size: "2 MB", type: "folder", name: "Reports", lastModified: "2025-06-10", rows: [{ checked: true, size: "850 KB", type: "file", name: "Q2_Report.docx", lastModified: "2025-06-15", }, { checked: false, size: "1.2 MB", type: "file", name: "Q3_Plan.xlsx", lastModified: "2025-06-18", }] }] }, { checked: false, size: "—", type: "folder", name: "Pictures", lastModified: "2025-05-30", rows: [{ checked: true, size: "3.5 MB", type: "file", name: "Vacation.jpg", lastModified: "2025-05-15", }, { checked: false, size: "2.1 MB", type: "file", name: "Family.png", lastModified: "2025-05-20", }] } ] } delegate: TreeViewDelegate {} } }
Les données initiales du modèle sont définies à l'aide de la propriété rows ou en appelant appendRow(). Chaque colonne du modèle est spécifiée en déclarant une instance de TableModelColumn, où l'ordre de chaque instance détermine l'index de la colonne. Une fois que le signal Component::completed() du modèle a été émis, les colonnes et les rôles ont été établis et sont fixés pour toute la durée de vie du modèle.
Structures de données de ligne prises en charge
Chaque ligne représente un nœud dans l'arbre. Chaque nœud possède le même type de colonnes. Le TreeModel est conçu pour fonctionner avec des données JavaScript/JSON, de sorte que chaque ligne est une liste de simples paires clé-valeur :
{
checked: false,
size: "—",
type: "folder",
name: "Pictures",
lastModified: "2025-05-30",
rows: [{
checked: true,
size: "3.5 MB",
type: "file",
name: "Vacation.jpg",
lastModified: "2025-05-15",
}, {
checked: false,
size: "2.1 MB",
type: "file",
name: "Family.png",
lastModified: "2025-05-20",
}]
}Un nœud peut avoir des nœuds enfants qui seront stockés dans un tableau associé à la clé "rows". La clé "rows" est réservée à cet effet : seule la liste des nœuds enfants doit être associée à cette clé.
Le modèle est manipulé via QModelIndices. Pour accéder à une ligne/nœud spécifique, la fonction getRow() peut être utilisée. Il est également possible d'accéder directement aux données JavaScript du modèle via la propriété rows, mais il n'est pas possible de modifier les données du modèle de cette manière.
Pour ajouter de nouvelles lignes, utilisez appendRow(). Pour modifier des lignes existantes, utilisez setRow(), removeRow() et clear().
Propriété Documentation
columnCount : int |
rows : object |
Cette propriété contient les données du modèle sous la forme d'un tableau de lignes.
Voir aussi getRow(), setRow(), appendRow(), clear() et columnCount.
Documentation de la méthode
appendRow(QModelIndex parent, object treeRow) |
Ajoute un nouveau treeRow à parent, avec les valeurs (cellules) de treeRow.
treeModel.appendRow(index, { checked: false, size: "-", type: "folder", name: "Orders", lastModified: "2025-07-02", rows: [ { checked: true, size: "38 KB", type: "file", name: "monitors.xlsx", lastModified: "2025-07-02" }, { checked: true, size: "54 KB", type: "file", name: "notebooks.xlsx", lastModified: "2025-07-02" } ] });
Si parent n'est pas valide, treeRow est ajouté au nœud racine.
clear() |
Supprime toutes les lignes du modèle.
Voir aussi removeRow().
object getRow(const QModelIndex &rowIndex) |
Renvoie un objet QModelIndex référençant les données treeIndex et column, qui peut être transmis à la fonction data() pour obtenir les données de cette cellule, ou à setData() pour modifier le contenu de cette cellule.
Le premier paramètre treeIndex représente un chemin de numéros de ligne allant de la racine à la ligne souhaitée et est utilisé pour la navigation à l'intérieur de l'arbre. La meilleure façon de l'expliquer est de le faire à l'aide d'un exemple.
|
Avec cette surcharge, il est possible d'obtenir un QModelIndex pour un nœud sans avoir un QModelIndex pour son nœud parent.
Si aucun nœud n'est trouvé par la liste spécifiée, un index de modèle non valide est renvoyé. Veuillez noter qu'un index de modèle non valide fait référence à la racine du nœud.
Voir également QModelIndex et les classes correspondantes dans QML et data().
Renvoie un objet QModelIndex référençant les objets row et column d'un parent donné, qui peut être transmis à la fonction data() pour obtenir les données de cette cellule, ou à setData() pour modifier le contenu de cette cellule.
Voir également QModelIndex et les classes associées dans QML et data().
removeRow(QModelIndex rowIndex) |
Supprime du modèle le TreeRow référencé par rowIndex.
treeModel.removeTreeRow(rowIndex)Voir également clear().
setRow(QModelIndex rowIndex, object treeRow) |
Remplace le TreeRow à rowIndex dans le modèle par treeRow. Une ligne avec des lignes enfants sera rejetée.
Toutes les colonnes/cellules doivent être présentes dans treeRow, et dans le bon ordre. Les lignes enfants de la ligne ne sont pas affectées.
treeModel.setRow(rowIndex, { checked: true, size: "-", type: "folder", name: "Subtitles", lastModified: "2025-07-07", iconColor: "blue" });
Voir également appendRow().
© 2025 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.