QStringListModel Class
La clase QStringListModel proporciona un modelo que suministra cadenas de caracteres a las vistas. Más información...
| Encabezado: | #include <QStringListModel> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredado de: | QAbstractListModel |
| Heredado por: |
Funciones públicas
| QStringListModel(QObject *parent = nullptr) | |
| QStringListModel(const QStringList &strings, QObject *parent = nullptr) | |
| void | setStringList(const QStringList &strings) |
| QStringList | stringList() const |
Funciones públicas reimplementadas
(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 |
Descripción detallada
QStringListModel es un modelo editable que se puede utilizar en casos sencillos en los que sea necesario mostrar varias cadenas de caracteres en un widget de vista, como un QListView o un QComboBox.
El modelo ofrece todas las funciones estándar de un modelo editable, representando los datos de la lista de cadenas como un modelo con una columna y un número de filas igual al número de elementos de la lista.
Los índices del modelo correspondientes a los elementos se obtienen con la función ` index()`, y los indicadores de los elementos se obtienen con ` flags()`. Los datos de los elementos se leen con la función ` data()` y se escriben con ` setData()`. El número de filas (y el número de elementos de la lista de cadenas) se puede obtener con la función ` rowCount()`.
El modelo se puede crear a partir de una lista de cadenas ya existente, o bien las cadenas se pueden establecer posteriormente mediante la función de conveniencia setStringList(). Las cadenas también se pueden insertar de la forma habitual con la función insertRows(), y eliminarse con removeRows(). El contenido de la lista de cadenas se puede recuperar con la función de conveniencia stringList().
Un ejemplo de uso de QStringListModel:
QStringListModel *model = new QStringListModel();
QStringList list;
list << "a" << "b" << "c";
model->setStringList(list);Véase también « QAbstractListModel» , « QAbstractItemModel », « QRangeModel » y «Clases de modelo».
Documentación de las funciones miembro
[explicit] QStringListModel::QStringListModel(QObject *parent = nullptr)
Crea un modelo de lista de cadenas con el parent proporcionado.
[explicit] QStringListModel::QStringListModel(const QStringList &strings, QObject *parent = nullptr)
Crea un modelo de lista de cadenas que contiene el « strings » especificado con el « parent » indicado.
[override virtual, since 6.0] bool QStringListModel::clearItemData(const QModelIndex &index)
Reimplementa: ` QAbstractItemModel::clearItemData(const QModelIndex &index)`.
Esta función se introdujo en Qt 6.0.
[override virtual] QVariant QStringListModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const
Reimplementa: ` QAbstractItemModel::data(const QModelIndex &index, int role) const`.
Devuelve los datos correspondientes a la « role » especificada, a partir del elemento con el « index » indicado.
Si la vista solicita un índice no válido, se devuelve una variante no válida.
Véase también setData().
[override virtual] Qt::ItemFlags QStringListModel::flags(const QModelIndex &index) const
Reimplementa: QAbstractListModel::flags(const QModelIndex &index) const.
Devuelve los indicadores del elemento con el index dado.
Los elementos válidos son: «enabled», «selectable», «editable», «drag enabled» y «drop enabled».
Véase también QAbstractItemModel::flags().
[override virtual] bool QStringListModel::insertRows(int row, int count, const QModelIndex &parent = QModelIndex())
Reimplementa: QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent).
Inserta filas de tipo « count » en el modelo, comenzando por el índice « row » especificado.
El índice parent de las filas es opcional y solo se utiliza para mantener la coherencia con QAbstractItemModel. Por defecto, se especifica un índice nulo, lo que indica que las filas se insertan en el nivel superior del modelo.
Devuelve ` true ` si la inserción se ha realizado correctamente.
Véase también ` QAbstractItemModel::insertRows()`.
[override virtual] QMap<int, QVariant> QStringListModel::itemData(const QModelIndex &index) const
Reimplementa: ` QAbstractItemModel::itemData(const QModelIndex &index) const`.
Véase también setItemData().
[override virtual] bool QStringListModel::moveRows(const QModelIndex &sourceParent, int sourceRow, int count, const QModelIndex &destinationParent, int destinationChild)
Reimplementa: 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())
Reimplementa: QAbstractItemModel::removeRows(int row, int count, const QModelIndex &parent).
Elimina filas de count del modelo, comenzando por el row especificado.
El índice parent de las filas es opcional y solo se utiliza para mantener la coherencia con QAbstractItemModel. Por defecto, se especifica un índice nulo, lo que indica que las filas se eliminan en el nivel superior del modelo.
Devuelve ` true ` si la eliminación de las filas se ha realizado correctamente.
Véase también QAbstractItemModel::removeRows().
[override virtual] int QStringListModel::rowCount(const QModelIndex &parent = QModelIndex()) const
Reimplementa: ` QAbstractItemModel::rowCount(const QModelIndex &parent) const`.
Devuelve el número de filas del modelo. Este valor se corresponde con el número de elementos de la lista interna de cadenas del modelo.
El argumento opcional ` parent ` se utiliza, en la mayoría de los modelos, para especificar el elemento padre de las filas que se van a contar. Dado que se trata de una lista, si se especifica un elemento padre válido, el resultado siempre será 0.
Véase también insertRows(), removeRows() y QAbstractItemModel::rowCount().
[override virtual] bool QStringListModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)
Reimplementa: ` QAbstractItemModel::setData` (const QModelIndex &index, const QVariant &value, int role).
Establece los datos del « role » especificado en el elemento con el « index » dado en el modelo, en el « value » proporcionado.
Se emite la señal dataChanged() si se modifica el elemento. Devuelve true tras emitir la señal dataChanged().
Véase también Qt::ItemDataRole y data().
[override virtual] bool QStringListModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles)
Reimplementa: QAbstractItemModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles).
Si roles contiene tanto Qt::DisplayRole como Qt::EditRole, tendrá prioridad este último
Véase también itemData().
void QStringListModel::setStringList(const QStringList &strings)
Establece la lista interna de cadenas del modelo en strings. El modelo notificará a cualquier vista asociada que sus datos subyacentes han cambiado.
Véase también stringList() y dataChanged().
[override virtual] QModelIndex QStringListModel::sibling(int row, int column, const QModelIndex &idx) const
Reimplementa: ` QAbstractListModel::sibling` (int row, int column, const QModelIndex &idx) const.
[override virtual] void QStringListModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)
Reimplementa: ` QAbstractItemModel::sort` (`int column`, `Qt::SortOrder order`).
QStringList QStringListModel::stringList() const
Devuelve la lista de cadenas que utiliza el modelo para almacenar datos.
Véase también setStringList().
[override virtual] Qt::DropActions QStringListModel::supportedDropActions() const
Reimplementa: 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.