Класс QStringListModel

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

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

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

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

• 4 открытых функций, унаследованных от QAbstractListModel
• 39 открытых функций, унаследованных от QAbstractItemModel
• 31 открытых функций, унаследованных от 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 = Q_NULLPTR)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[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().

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

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

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

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

QStringList QStringListModel::stringList() const

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

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

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

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