Spec-Zone.ru › Qt 5.14

Использование C++ моделей с Qt Quick Views

Данные, предоставляемые пользовательской C++ моделью

Модели могут быть определены в C++ и затем предоставлены для QML. Это полезно для экспонирования существующих C++ моделей данных или сложных наборов данных в QML.

Класс модели C++ может быть определен как QStringList, QVariantList, QObjectList или QAbstractItemModel. Первые три полезны для экспонирования более простых наборов данных, в то время как QAbstractItemModel предоставляет более гибкое решение для более сложных моделей.

Вот видео-учебник, который проведет вас через весь процесс экспонирования C++ модели в QML:

Модель на основе QStringList

Модель может быть простым QStringList, который предоставляет содержимое списка через роль modelData.

Вот ListView с делегатом, который ссылается на значение элемента модели, используя роль modelData: 

ListView {
    width: 100; height: 100

    model: myModel
    delegate: Rectangle {
        height: 25
        width: 100
        Text { text: modelData }
    }
}

Приложение Qt может загрузить этот QML-документ и установить значение myModel в QStringList:

    QStringList dataList;
    dataList.append("Item 1");
    dataList.append("Item 2");
    dataList.append("Item 3");
    dataList.append("Item 4");

    QQuickView view;
    QQmlContext *ctxt = view.rootContext();
    ctxt->setContextProperty("myModel", QVariant::fromValue(dataList));

Полный исходный код этого примера доступен в examples/quick/models/stringlistmodel в каталоге установки Qt.

Примечание: Вид не может узнать, что содержимое QStringList изменилось. Если QStringList изменится, необходимо будет сбросить модель, снова вызвав QQmlContext::setContextProperty().

Модель на основе QVariantList

Модель может быть одиночным QVariantList, который предоставляет содержимое списка через роль modelData.

API работает так же, как и с QStringList, как показано в предыдущем разделе.

Примечание: Вид не может узнать, что содержимое QVariantList изменилось. Если QVariantList изменится, необходимо будет сбросить модель.

Модель на основе QObjectList

Список значений QObject* также может использоваться в качестве модели. QList<QObject*> предоставляет свойства объектов в списке в виде ролей.

Следующее приложение создаёт класс DataObject, со значениями Q_PROPERTY, которые будут доступны как именованные роли, когда QList<DataObject*> экспонируется в QML:

class DataObject : public QObject
{
    Q_OBJECT

    Q_PROPERTY(QString name READ name WRITE setName NOTIFY nameChanged)
    Q_PROPERTY(QString color READ color WRITE setColor NOTIFY colorChanged)
    ...
};

int main(int argc, char ** argv)
{
    QGuiApplication app(argc, argv);

    QList<QObject*> dataList;
    dataList.append(new DataObject("Item 1", "red"));
    dataList.append(new DataObject("Item 2", "green"));
    dataList.append(new DataObject("Item 3", "blue"));
    dataList.append(new DataObject("Item 4", "yellow"));

    QQuickView view;
    view.setResizeMode(QQuickView::SizeRootObjectToView);
    QQmlContext *ctxt = view.rootContext();
    ctxt->setContextProperty("myModel", QVariant::fromValue(dataList));
    ...

QObject* доступен как свойство modelData. Для удобства, свойства объекта также доступны непосредственно в контексте делегата. Здесь, view.qml ссылается на свойства DataModel в делегате ListView:

ListView {
    width: 100; height: 100

    model: myModel
    delegate: Rectangle {
        height: 25
        width: 100
        color: model.modelData.color
        Text { text: name }
    }
}

Обратите внимание на использование свойства color с квалификатором. Свойства объекта не дублируются в объекте model, так как они легко доступны через объект modelData.

Полный исходный код этого примера доступен в examples/quick/models/objectlistmodel в каталоге установки Qt.

Примечание: Вид не может узнать, что содержимое QList изменилось. Если QList изменится, необходимо будет сбросить модель, снова вызвав QQmlContext::setContextProperty().

Подкласс QAbstractItemModel

Модель может быть определена путём наследования от QAbstractItemModel. Это лучший подход, если у вас более сложная модель, которую нельзя поддерживать другими способами. QAbstractItemModel также может автоматически уведомлять QML-вид, когда данные модели изменяются.

Роли подкласса QAbstractItemModel могут быть экспонированы в QML путём переопределения QAbstractItemModel::roleNames().

Вот приложение с подклассом QAbstractListModel с именем AnimalModel, который экспонирует роли type и sizes. Оно переопределяет QAbstractItemModel::roleNames() для экспонирования имён ролей, так чтобы к ним можно было получить доступ через QML:

class Animal
{
public:
    Animal(const QString &type, const QString &size);
    ...
};

class AnimalModel : public QAbstractListModel
{
    Q_OBJECT
public:
    enum AnimalRoles {
        TypeRole = Qt::UserRole + 1,
        SizeRole
    };

    AnimalModel(QObject *parent = 0);
    ...
};

QHash<int, QByteArray> AnimalModel::roleNames() const {
    QHash<int, QByteArray> roles;
    roles[TypeRole] = "type";
    roles[SizeRole] = "size";
    return roles;
}

int main(int argc, char ** argv)
{
    QGuiApplication app(argc, argv);

    AnimalModel model;
    model.addAnimal(Animal("Wolf", "Medium"));
    model.addAnimal(Animal("Polar bear", "Large"));
    model.addAnimal(Animal("Quoll", "Small"));

    QQuickView view;
    view.setResizeMode(QQuickView::SizeRootObjectToView);
    QQmlContext *ctxt = view.rootContext();
    ctxt->setContextProperty("myModel", &model);
    ...

Эта модель отображается делегатом ListView, который получает доступ к ролям type и size:

ListView {
    width: 200; height: 250

    model: myModel
    delegate: Text { text: "Animal: " + type + ", " + size }
}

QML-виды автоматически обновляются, когда модель изменяется. Помните, что модель должна следовать стандартным правилам изменения моделей и уведомлять вид о изменениях, используя QAbstractItemModel::dataChanged(), QAbstractItemModel::beginInsertRows() и так далее. Подробнее см. в справочнике по наследованию модели.

Полный исходный код этого примера доступен в examples/quick/models/abstractitemmodel в каталоге установки Qt.

QAbstractItemModel представляет иерархию таблиц, но текущие QML-виды могут отображать только данные списков. Для отображения дочерних списков иерархической модели используйте QML-тип DelegateModel, который предоставляет следующие свойства и функции для использования со списовыми моделями типа QAbstractItemModel:

  • Свойство роли hasModelChildren для определения, имеет ли узел дочерние узлы.
  • DelegateModel::rootIndex позволяет указать корневой узел.
  • DelegateModel::modelIndex() возвращает QModelIndex, который можно назначить свойству DelegateModel::rootIndex
  • DelegateModel::parentModelIndex() возвращает QModelIndex, который можно назначить свойству DelegateModel::rootIndex

SQL-модели

Qt предоставляет C++ классы, которые поддерживают SQL-модели данных. Эти классы работают прозрачно с базовыми данными SQL, уменьшая необходимость выполнения SQL-запросов для основных SQL-операций, таких как создание, вставка или обновление. Подробнее о этих классах см. Использование классов SQL-моделей.

Хотя C++ классы предоставляют полные наборы функций для работы с данными SQL, они не предоставляют доступ к данным QML. Поэтому необходимо реализовать пользовательскую C++ модель данных, как подкласс одного из этих классов, и экспонировать её в QML как тип или свойство контекста.

Модель данных только для чтения

Пользовательская модель должна переопределить следующие методы, чтобы обеспечить доступ только для чтения к данным из QML:

  • roleNames() для экспонирования имён ролей в QML-фронтенд. Например, следующая версия возвращает имена полей выбранной таблицы в качестве имён ролей:
     QHash<int, QByteArray> SqlQueryModel::roleNames() const
 {
    QHash<int, QByteArray> roles;
    // record() returns an empty QSqlRecord
    for (int i = 0; i < this->record().count(); i ++) {
        roles.insert(Qt::UserRole + i + 1, record().fieldName(i).toUtf8());
    }
    return roles;
}
  • data() для экспонирования данных SQL в QML-фронтенд. Например, следующая реализация возвращает данные для заданного индекса модели:
    QVariant SqlQueryModel::data(const QModelIndex &index, int role) const
{
    QVariant value;

    if (index.isValid()) {
        if (role < Qt::UserRole) {
            value = QSqlQueryModel::data(index, role);
        } else {
            int columnIdx = role - Qt::UserRole - 1;
            QModelIndex modelIndex = this->index(index.row(), columnIdx);
            value = QSqlQueryModel::data(modelIndex, Qt::DisplayRole);
        }
    }
    return value;
}

Класс QSqlQueryModel достаточно хорош для реализации пользовательской модели только для чтения, представляющей данные в базе данных SQL. Пример чат-туториала хорошо демонстрирует это, реализуя пользовательскую модель для извлечения контактных данных из базы данных SQLite.

Редактируемая модель данных

QSqlTableModel реализует setData(), как описано ниже.

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

Новые данные в модель можно также вставить, вызвав QSqlTableModel::insertRecord(). В следующем фрагменте примера QSqlRecord заполняется деталями книги и добавляется в модель:

...
QSqlRecord newRecord = record();
newRecord.setValue("author", "John Grisham");
newRecord.setValue("booktitle", "The Litigators");
insertRecord(rowCount(), newRecord);
...

Экспонирование C++ моделей данных в QML

В приведенных выше примерах используется QQmlContext::setContextProperty() для непосредственного задания значений модели в QML-компонентах. Альтернатива — зарегистрировать класс C++ модели как QML-тип (либо прямо из C++ точки входа, либо в функции инициализации QML C++ плагина, как показано ниже). Это позволит создавать классы модели напрямую в QML:

C++ 
class MyModelPlugin : public QQmlExtensionPlugin
{
    Q_OBJECT
    Q_PLUGIN_METADATA(IID "org.qt-project.QmlExtension.MyModel" FILE "mymodel.json")
public:
    void registerTypes(const char *uri)
    {
        qmlRegisterType<MyModel>(uri, 1, 0,
                "MyModel");
    }
}
QML 
MyModel {
    id: myModel
    ListElement { someProperty: "some value" }
}
ListView {
    width: 200; height: 250
    model: myModel
    delegate: Text { text: someProperty }
}

Подробнее о написании QML C++ плагинов см. Создание QML расширений с помощью C++.

Изменение данных модели

Помимо roleNames() и data(), редактируемые модели должны переопределить метод setData для сохранения изменений в существующих данных модели. Следующая версия метода проверяет, является ли заданный индекс модели валидным и равна ли роль role значению Qt::EditRole:

bool EditableModel::setData(const QModelIndex &index, const QVariant &value, int role)
{
    if (index.isValid() && role == Qt::EditRole) {
        // Set data in model here. It can also be a good idea to check whether
        // the new value actually differs from the current value
        if (m_entries[index.row()] != value.toString()) {
            m_entries[index.row()] = value.toString();
            emit dataChanged(index, index, { Qt::EditRole, Qt::DisplayRole });
            return true;
        }
    }
    return false;
}

Примечание: Важно испустить сигнал dataChanged() после сохранения изменений.

В отличие от C++ визуализаций элементов, таких как QListView или QTableView, метод setData() должен быть явным образом вызван из QML-делегатов, когда это уместно. Это делается путём простого назначения нового значения соответствующему свойству модели.

ListView {
    anchors.fill: parent
    model: EditableModel {}
    delegate: TextField {
        width: ListView.view.width
        text: model.edit
        onAccepted: model.edit = text
    }
}

Примечание: Роль edit равна Qt::EditRole. См. roleNames() для встроенных имён ролей. Однако, реальные модели обычно регистрируют пользовательские роли.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qtquick-modelviewsdata-cppmodels.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API