En esta página

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:

QHelpIndexModel

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.