QStringListModel Class
La classe QStringListModel fournit un modèle qui alimente les vues en chaînes de caractères. Plus d'informations...
| En-tête : | #include <QStringListModel> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Hérite : | 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 les cas simples où vous devez afficher un certain nombre de chaînes dans un widget de vue, tel que QListView ou QComboBox.
Le modèle fournit toutes les fonctions standard d'un modèle modifiable, représentant les données de la liste de chaînes sous la forme d'un modèle avec une colonne et un nombre de lignes égal au nombre d'éléments de la liste.
Les index de modèle correspondant aux éléments sont obtenus avec la fonction index(), et les drapeaux des éléments sont obtenus avec flags(). Les données relatives aux éléments sont lues à l'aide de la fonction data() et écrites à l'aide de la fonction setData(). Le nombre de lignes (et le nombre d'éléments dans la liste de chaînes) peut être obtenu à l'aide de la fonction rowCount().
Le modèle peut être construit à 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 avec la fonction insertRows(), et supprimées avec 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, et Classes de modèles.
Documentation des fonctions membres
[explicit] QStringListModel::QStringListModel(QObject *parent = nullptr)
Construit un modèle de liste de chaînes avec la valeur donnée parent.
[explicit] QStringListModel::QStringListModel(const QStringList &strings, QObject *parent = nullptr)
Construit un modèle de liste de chaînes contenant l'adresse strings spécifiée avec l'adresse parent donnée.
[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 pour l'adresse role spécifiée, à partir de l'élément avec l'adresse index donnée.
Si la vue demande un index non valide, une variante non valide est renvoyée.
Voir aussi setData().
[override virtual] Qt::ItemFlags QStringListModel::flags(const QModelIndex &index) const
Réimplémente : QAbstractListModel::flags(const QModelIndex &index) const.
Renvoie les drapeaux de l'élément correspondant à l'adresse index.
Les éléments valides sont activés, sélectionnables, modifiables, activés par glisser-déposer et activés par déposer.
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 count lignes dans le modèle, en commençant par l'adresse row.
L'index parent des lignes est facultatif et n'est utilisé qu'à des fins de cohérence avec QAbstractItemModel. Par défaut, un index nul est spécifié, indiquant que les lignes sont insérées au niveau supérieur du modèle.
Renvoie true si l'insertion a réussi.
Voir aussi QAbstractItemModel::insertRows().
[override virtual] QMap<int, QVariant> QStringListModel::itemData(const QModelIndex &index) const
Réimplémente : QAbstractItemModel::itemData(const QModelIndex &index) const.
Voir également 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 count rangées du modèle, en commençant par la rangée donnée row.
L'index parent des lignes est facultatif et n'est utilisé qu'à des fins de cohérence avec QAbstractItemModel. Par défaut, un index nul est spécifié, indiquant que les lignes sont supprimées au niveau supérieur du modèle.
Renvoie true si la suppression des lignes a réussi.
Voir aussi 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 interne de chaînes 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 pour l'élément role spécifié avec l'élément index donné dans le modèle, à l'élément value fourni.
Le signal dataChanged() est émis si l'élément est modifié. Retourne true après avoir émis le signal dataChanged().
Voir aussi 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, c'est ce dernier qui aura la priorité
Voir aussi itemData().
void QStringListModel::setStringList(const QStringList &strings)
Définit la liste interne de chaînes du modèle à strings. Le modèle notifiera toutes les vues attachées que ses données sous-jacentes ont changé.
Voir aussi 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émente : QAbstractItemModel::sort(int column, Qt::SortOrder order).
QStringList QStringListModel::stringList() const
Renvoie la liste de chaînes 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.