Класс QStringListModel

Класс QStringListModel предоставляет модель, которая предоставляет строки для представлений. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Открытые функции

Переопределённые открытые функции

• 4 открытых функций унаследовано от QAbstractListModel
• 40 открытых функций унаследовано от QAbstractItemModel
• 32 открытых функций унаследовано от QObject

Статические открытые члены

• 10 статических открытых членов унаследовано от QObject

Дополнительные унаследованные члены

• 1 свойство унаследовано от QObject
• 2 открытых слотов унаследовано от QAbstractItemModel
• 1 открытый слот унаследовано от QObject
• 18 сигналов унаследовано от QAbstractItemModel
• 2 сигнала унаследовано от QObject
• 19 защищённых функций унаследовано от QAbstractItemModel
• 9 защищённых функций унаследовано от QObject
• 1 защищённый слот унаследовано от QAbstractItemModel

Подробное описание

Класс QStringListModel предоставляет модель, которая предоставляет строки для представлений.

QStringListModel — это редактируемая модель, которая может использоваться в простых случаях, когда вам нужно отобразить несколько строк в виджете представления, например, QListView или QComboBox.

Модель предоставляет все стандартные функции редактируемой модели, представляя данные в списке строк как модель с одним столбцом и числом строк, равным числу элементов в списке.

Индексы модели, соответствующие элементам, получаются с помощью функции index(), а флаги элементов — с помощью flags(). Данные элементов считываются с помощью функции data() и записываются с помощью setData(). Число строк (и число элементов в списке строк) можно найти с помощью функции rowCount().

Модель может быть построена с существующим списком строк, или строки могут быть заданы позже с помощью удобной функции setStringList(). Строки также могут быть вставлены обычным способом с помощью функции insertRows() и удалены с помощью removeRows(). Содержимое списка строк можно получить с помощью удобной функции stringList().

Пример использования QStringListModel:

    QStringListModel *model = new QStringListModel();
    QStringList list;
    list << "a" << "b" << "c";
    model->setStringList(list);

См. также QAbstractListModel, QAbstractItemModel и Классы моделей.

Документация по функциям-членам

QStringListModel::QStringListModel(QObject *parent = nullptr)

Конструирует модель списка строк с указанным parent.

QStringListModel::QStringListModel(const QStringList &strings, QObject *parent = nullptr)

Конструирует модель списка строк, содержащую указанные strings с указанным parent.

[override virtual] QVariant QStringListModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const

Переопределено из QAbstractItemModel::data().

Возвращает данные для указанного role из элемента с заданным index.

Если представление запрашивает недопустимый индекс, возвращается недопустимый вариант.

См. также setData().

[override virtual] Qt::ItemFlags QStringListModel::flags(const QModelIndex &index) const

Переопределено из QAbstractListModel::flags().

Возвращает флаги для элемента с заданным index.

Действительные элементы включены, выбираемы, редактируемы, разрешено перетаскивание и разрешено выкладывание.

См. также QAbstractItemModel::flags().

[override virtual] bool QStringListModel::insertRows(int row, int count, const QModelIndex &parent = QModelIndex())

Переопределено из QAbstractItemModel::insertRows().

Вставляет count строк в модель, начиная с заданного row.

Индекс parent строк необязателен и используется только для согласованности с QAbstractItemModel. По умолчанию задаётся нулевой индекс, указывающий, что строки вставляются в верхний уровень модели.

См. также QAbstractItemModel::insertRows().

[override virtual] bool QStringListModel::removeRows(int row, int count, const QModelIndex &parent = QModelIndex())

Переопределено из QAbstractItemModel::removeRows().

Удаляет count строк из модели, начиная с заданного row.

Индекс parent строк необязателен и используется только для согласованности с QAbstractItemModel. По умолчанию задаётся нулевой индекс, указывающий, что строки удаляются в верхнем уровне модели.

См. также QAbstractItemModel::removeRows().

[override virtual] int QStringListModel::rowCount(const QModelIndex &parent = QModelIndex()) const

Переопределено из QAbstractItemModel::rowCount().

Возвращает количество строк в модели. Это значение соответствует количеству элементов во внутреннем списке строк модели.

Необязательный аргумент parent в большинстве моделей используется для указания родителя строк, количество которых требуется подсчитать. Поскольку это список, если указан допустимый родитель, результат всегда будет 0.

См. также insertRows(), removeRows() и QAbstractItemModel::rowCount().

[override virtual] bool QStringListModel::setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)

Переопределено из QAbstractItemModel::setData().

Устанавливает данные для указанного role в элементе с заданным index в модели на предоставленное значение value.

Если элемент изменён, генерируется сигнал dataChanged().

См. также Qt::ItemDataRole и data().

void QStringListModel::setStringList(const QStringList &strings)

Устанавливает внутренний список строк модели в strings. Модель уведомит все подключённые представления о том, что данные изменились.

См. также stringList() и dataChanged().

[override virtual] QModelIndex QStringListModel::sibling(int row, int column, const QModelIndex &idx) const

Переопределено из QAbstractListModel::sibling().

[override virtual] void QStringListModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)

Переопределено из QAbstractItemModel::sort().

QStringList QStringListModel::stringList() const

Возвращает список строк, используемый моделью для хранения данных.

См. также setStringList().

[override virtual] Qt::DropActions QStringListModel::supportedDropActions() const

Переопределено из QAbstractItemModel::supportedDropActions().