QStringListModel Class
La classe QStringListModel fournit un modèle qui transmet des chaînes de caractères aux vues. En savoir plus...
| En-tête : | #include <QStringListModel> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Hérite de : | QAbstractListModel |
| Hérité par : |
Fonctions publiques
| QStringListModel(QObject *parent = nullptr) | |
| QStringListModel(const QStringList &strings, QObject *parent = nullptr) | |
| void | setStringList(const QStringList &strings) |
| QStringList | stringList() const |
Fonctions publiques réimplémentées
(since 6.0) virtual bool | clearItemData(const QModelIndex &index) override |
| virtual QVariant | data(const QModelIndex &index, int role = Qt::DisplayRole) const override |
| virtual Qt::ItemFlags | flags(const QModelIndex &index) const override |
| virtual bool | insertRows(int row, int count, const QModelIndex &parent = QModelIndex()) override |
| virtual QMap<int, QVariant> | itemData(const QModelIndex &index) const override |
| virtual bool | moveRows(const QModelIndex &sourceParent, int sourceRow, int count, const QModelIndex &destinationParent, int destinationChild) override |
| virtual bool | removeRows(int row, int count, const QModelIndex &parent = QModelIndex()) override |
| virtual int | rowCount(const QModelIndex &parent = QModelIndex()) const override |
| virtual bool | setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override |
| virtual bool | setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles) override |
| virtual QModelIndex | sibling(int row, int column, const QModelIndex &idx) const override |
| virtual void | sort(int column, Qt::SortOrder order = Qt::AscendingOrder) override |
| virtual Qt::DropActions | supportedDropActions() const override |
Description détaillée
QStringListModel est un modèle modifiable qui peut être utilisé dans des cas simples où vous devez afficher un certain nombre de chaînes de caractères dans un widget de vue, tel qu’un QListView ou un QComboBox.
Ce modèle offre toutes les fonctions standard d’un modèle modifiable, en représentant les données de la liste de chaînes sous la forme d’un modèle comportant une colonne et un nombre de lignes égal au nombre d’éléments de la liste.
Les index du modèle correspondant aux éléments sont obtenus à l’aide de la fonction ` index()`, et les indicateurs d’élément sont obtenus à l’aide de ` flags()`. Les données des éléments sont lues à l’aide de la fonction ` data()` et écrites à l’aide de ` setData()`. Le nombre de lignes (et le nombre d’éléments de la liste de chaînes de caractères) peut être déterminé à l’aide de la fonction ` rowCount()`.
Le modèle peut être créé à partir d’une liste de chaînes existante, ou les chaînes peuvent être définies ultérieurement à l’aide de la fonction de commodité setStringList(). Les chaînes peuvent également être insérées de la manière habituelle à l’aide de la fonction insertRows(), et supprimées à l’aide de removeRows(). Le contenu de la liste de chaînes peut être récupéré à l’aide de la fonction de commodité stringList().
Exemple d'utilisation de QStringListModel :
QStringListModel *model = new QStringListModel();
QStringList list;
list << "a" << "b" << "c";
model->setStringList(list);Voir également QAbstractListModel, QAbstractItemModel, QRangeModel et Classes de modèles.
Documentation des fonctions membres
[explicit] QStringListModel::QStringListModel(QObject *parent = nullptr)
Crée un modèle de liste de chaînes à partir de l'parent on fournie.
[explicit] QStringListModel::QStringListModel(const QStringList &strings, QObject *parent = nullptr)
Crée un modèle de liste de chaînes contenant l'strings ion spécifiée avec l'parent ion fournie.
[override virtual, since 6.0] bool QStringListModel::clearItemData(const QModelIndex &index)
Réimplémente : QAbstractItemModel::clearItemData(const QModelIndex &index).
Cette fonction a été introduite dans Qt 6.0.
[override virtual] QVariant QStringListModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const
Réimplémente : ` QAbstractItemModel::data(const QModelIndex &index, int role) const`.
Renvoie les données correspondant à l'role spécifié, à partir de l'élément dont l'index est donné.
Si la vue demande un index non valide, une variante non valide est renvoyée.
Voir également setData().
[override virtual] Qt::ItemFlags QStringListModel::flags(const QModelIndex &index) const
Réimplémente : QAbstractListModel::flags(const QModelIndex &index) const.
Renvoie les indicateurs associés à l'élément dont l'index est spécifié.
Les éléments valides sont : « enabled », « selectable », « editable », « drag enabled » et « drop enabled ».
Voir également QAbstractItemModel::flags().
[override virtual] bool QStringListModel::insertRows(int row, int count, const QModelIndex &parent = QModelIndex())
Réimplémente : QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent).
Insère des lignes de type ` count ` dans le modèle, en commençant par l'row` spécifié.
L'index parent des lignes est facultatif et n'est utilisé que pour des raisons de cohérence avec QAbstractItemModel. Par défaut, un index nul est spécifié, ce qui indique que les lignes sont insérées au niveau supérieur du modèle.
Renvoie ` true ` si l’insertion a réussi.
Voir également QAbstractItemModel::insertRows().
[override virtual] QMap<int, QVariant> QStringListModel::itemData(const QModelIndex &index) const
Réimplémente : QAbstractItemModel::itemData(const QModelIndex &index) const.
Voir aussi setItemData().
[override virtual] bool QStringListModel::moveRows(const QModelIndex &sourceParent, int sourceRow, int count, const QModelIndex &destinationParent, int destinationChild)
Réimplémente : QAbstractItemModel::moveRows(const QModelIndex &sourceParent, int sourceRow, int count, const QModelIndex &destinationParent, int destinationChild).
[override virtual] bool QStringListModel::removeRows(int row, int count, const QModelIndex &parent = QModelIndex())
Réimplémente : QAbstractItemModel::removeRows(int row, int count, const QModelIndex &parent).
Supprime les lignes count du modèle, en commençant par l'row donné.
L'index parent des lignes est facultatif et n'est utilisé que pour des raisons de cohérence avec QAbstractItemModel. Par défaut, un index nul est spécifié, ce qui indique que les lignes sont supprimées au niveau supérieur du modèle.
Renvoie ` true ` si la suppression des lignes a réussi.
Voir également QAbstractItemModel::removeRows().
[override virtual] int QStringListModel::rowCount(const QModelIndex &parent = QModelIndex()) const
Réimplémente : ` QAbstractItemModel::rowCount(const QModelIndex &parent) const`.
Renvoie le nombre de lignes du modèle. Cette valeur correspond au nombre d’éléments de la liste de chaînes interne du modèle.
L'argument facultatif ` parent ` est utilisé dans la plupart des modèles pour spécifier le parent des lignes à compter. Comme il s'agit d'une liste si un parent valide est spécifié, le résultat sera toujours 0.
Voir également insertRows(), removeRows() et QAbstractItemModel::rowCount().
[override virtual] bool QStringListModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)
Réimplémente : QAbstractItemModel::setData(const QModelIndex &index, const QVariant &value, int role).
Définit les données de l’ role spécifié dans l’élément, dont l’ index est donné dans le modèle, sur la value fournie.
Le signal dataChanged() est émis si l’élément est modifié. Renvoie true après avoir émis le signal dataChanged().
Voir également Qt::ItemDataRole et data().
[override virtual] bool QStringListModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles)
Réimplémente : QAbstractItemModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles).
Si roles contient à la fois Qt::DisplayRole et Qt::EditRole, ce dernier aura la priorité
Voir également itemData().
void QStringListModel::setStringList(const QStringList &strings)
Définit la liste de chaînes interne du modèle sur strings. Le modèle informera toutes les vues associées que ses données sous-jacentes ont changé.
Voir également stringList() et dataChanged().
[override virtual] QModelIndex QStringListModel::sibling(int row, int column, const QModelIndex &idx) const
Réimplémente : QAbstractListModel::sibling(int row, int column, const QModelIndex &idx) const.
[override virtual] void QStringListModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)
Réimplémentation de : QAbstractItemModel::sort(int column, Qt::SortOrder order).
QStringList QStringListModel::stringList() const
Renvoie la liste de chaînes de caractères utilisée par le modèle pour stocker les données.
Voir aussi setStringList().
[override virtual] Qt::DropActions QStringListModel::supportedDropActions() const
Réimplémente : QAbstractItemModel::supportedDropActions() const.
© 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.