Класс QStringListModel

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

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

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

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

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

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

• 1 свойство унаследовано от QObject
• 2 открытых слота унаследованы от QAbstractItemModel
• 1 открытый слот унаследован от QObject
• 18 сигналов унаследовано от QAbstractItemModel
• 2 сигнала унаследовано от QObject
• 11 статические открытые члены унаследованы от 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().