// Copyright (C) 2016 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only #include "qqmlobjectmodel_p.h" #include #include #include #include #include #include #include #include #include #include #include QT_BEGIN_NAMESPACE class QQmlObjectModelPrivate : public QObjectPrivate { Q_DECLARE_PUBLIC(QQmlObjectModel) public: class Item { public: Item(QObject *i = nullptr) : m_item(i) {} void addRef() { ++m_ref; } bool deref() { return --m_ref == 0; } int refCount() const { return m_ref; } QObject *item() const { return m_item.data(); } private: QPointer m_item; int m_ref = 0; }; QQmlObjectModelPrivate() : QObjectPrivate(), moveId(0) {} static QQmlObjectModelPrivate *get(QQmlObjectModel *q) { return q->d_func(); } static void children_append(QQmlListProperty *prop, QObject *item) { qsizetype index = static_cast(prop->data)->children.size(); static_cast(prop->data)->insert(index, item); } static qsizetype children_count(QQmlListProperty *prop) { return static_cast(prop->data)->children.size(); } static QObject *children_at(QQmlListProperty *prop, qsizetype index) { return static_cast(prop->data)->children.at(index).item(); } static void children_clear(QQmlListProperty *prop) { static_cast(prop->data)->clear(); } static void children_replace(QQmlListProperty *prop, qsizetype index, QObject *item) { static_cast(prop->data)->replace(index, item); } static void children_removeLast(QQmlListProperty *prop) { auto data = static_cast(prop->data); data->remove(data->children.size() - 1, 1); } void markNewChild(QQmlObjectModel *q, QObject *item) { if (QJSEngine *engine = qjsEngine(q)) { QV4::WriteBarrier::markCustom(engine->handle(), [&](QV4::MarkStack *markStack) { QV4::QObjectWrapper::markWrapper(item, markStack); }); } } void insert(int index, QObject *item) { Q_Q(QQmlObjectModel); children.insert(index, Item(item)); markNewChild(q, item); for (int i = index, end = children.size(); i < end; ++i) setIndex(i); QQmlChangeSet changeSet; changeSet.insert(index, 1); emit q->modelUpdated(changeSet, false); emit q->countChanged(); emit q->childrenChanged(); } void replace(int index, QObject *item) { Q_Q(QQmlObjectModel); clearIndex(index); children.replace(index, Item(item)); markNewChild(q, item); setIndex(index); QQmlChangeSet changeSet; changeSet.change(index, 1); emit q->modelUpdated(changeSet, false); emit q->childrenChanged(); } void move(int from, int to, int n) { Q_Q(QQmlObjectModel); if (from > to) { // Only move forwards - flip if backwards moving int tfrom = from; int tto = to; from = tto; to = tto+n; n = tfrom-tto; } QVarLengthArray store; for (int i = 0; i < to - from; ++i) store.append(std::move(children[from + n + i])); for (int i = 0; i < n; ++i) store.append(std::move(children[from + i])); for (int i = 0, end = store.count(); i < end; ++i) { children[from + i] = std::move(store[i]); setIndex(from + i); } QQmlChangeSet changeSet; changeSet.move(from, to, n, ++moveId); emit q->modelUpdated(changeSet, false); emit q->childrenChanged(); } void remove(int index, int n) { Q_Q(QQmlObjectModel); for (int i = index; i < index + n; ++i) clearIndex(i); children.erase(children.begin() + index, children.begin() + index + n); for (int i = index, end = children.size(); i < end; ++i) setIndex(i); QQmlChangeSet changeSet; changeSet.remove(index, n); emit q->modelUpdated(changeSet, false); emit q->countChanged(); emit q->childrenChanged(); } void clear() { Q_Q(QQmlObjectModel); const auto copy = children; for (const Item &child : copy) emit q->destroyingItem(child.item()); remove(0, children.size()); } int indexOf(QObject *item) const { for (int i = 0; i < children.size(); ++i) if (children.at(i).item() == item) return i; return -1; } void markChildren(QV4::MarkStack *markStack) const { for (const Item &child : children) QV4::QObjectWrapper::markWrapper(child.item(), markStack); } quint64 _q_createJSWrapper(QQmlV4ExecutionEnginePtr engine); private: void setIndex(int child, int index) { if (auto *attached = static_cast( qmlAttachedPropertiesObject(children.at(child).item()))) { attached->setIndex(index); } } void setIndex(int child) { setIndex(child, child); } void clearIndex(int child) { setIndex(child, -1); } uint moveId; QList children; }; namespace QV4 { namespace Heap { struct QQmlObjectModelWrapper : public QObjectWrapper { static void markObjects(Base *that, MarkStack *markStack) { Q_ASSERT(QV4::Value::fromHeapObject(that).as()); QObject *object = static_cast(that)->object(); if (!object) return; Q_ASSERT(qobject_cast(object)); QQmlObjectModelPrivate::get(static_cast(object)) ->markChildren(markStack); QObjectWrapper::markObjects(that, markStack); } }; } // namespace Heap struct QQmlObjectModelWrapper : public QObjectWrapper { V4_OBJECT2(QQmlObjectModelWrapper, QObjectWrapper) }; } // namspace QV4 DEFINE_OBJECT_VTABLE(QV4::QQmlObjectModelWrapper); quint64 QQmlObjectModelPrivate::_q_createJSWrapper(QQmlV4ExecutionEnginePtr engine) { return (engine->memoryManager->allocate( q_func()))->asReturnedValue(); } /*! \qmltype ObjectModel \nativetype QQmlObjectModel \inqmlmodule QtQml.Models \ingroup qtquick-models \brief Defines a set of items to be used as a model. An ObjectModel contains the visual items to be used in a view. When an ObjectModel is used in a view, the view does not require a delegate since the ObjectModel already contains the visual delegate (items). An item can determine its index within the model via the \l{ObjectModel::index}{index} attached property. The example below places three colored rectangles in a ListView. \code import QtQuick 2.0 import QtQml.Models 2.1 Rectangle { ObjectModel { id: itemModel Rectangle { height: 30; width: 80; color: "red" } Rectangle { height: 30; width: 80; color: "green" } Rectangle { height: 30; width: 80; color: "blue" } } ListView { anchors.fill: parent model: itemModel } } \endcode \image objectmodel.png \sa {Qt Quick Examples - Views} */ QQmlObjectModel::QQmlObjectModel(QObject *parent) : QQmlInstanceModel(*(new QQmlObjectModelPrivate), parent) { } QQmlObjectModel::~QQmlObjectModel() = default; /*! \qmlattachedproperty int QtQml.Models::ObjectModel::index This attached property holds the index of this delegate's item within the model. It is attached to each instance of the delegate. */ QQmlListProperty QQmlObjectModel::children() { Q_D(QQmlObjectModel); return QQmlListProperty(this, d, QQmlObjectModelPrivate::children_append, QQmlObjectModelPrivate::children_count, QQmlObjectModelPrivate::children_at, QQmlObjectModelPrivate::children_clear, QQmlObjectModelPrivate::children_replace, QQmlObjectModelPrivate::children_removeLast); } /*! \qmlproperty int QtQml.Models::ObjectModel::count The number of items in the model. This property is readonly. */ int QQmlObjectModel::count() const { Q_D(const QQmlObjectModel); return d->children.size(); } bool QQmlObjectModel::isValid() const { return true; } QObject *QQmlObjectModel::object(int index, QQmlIncubator::IncubationMode) { Q_D(QQmlObjectModel); QQmlObjectModelPrivate::Item &item = d->children[index]; item.addRef(); QObject *obj = item.item(); if (item.refCount() == 1) { emit initItem(index, obj); emit createdItem(index, obj); } return obj; } QQmlInstanceModel::ReleaseFlags QQmlObjectModel::release(QObject *item, ReusableFlag) { Q_D(QQmlObjectModel); int idx = d->indexOf(item); if (idx >= 0) { if (!d->children[idx].deref()) return QQmlInstanceModel::Referenced; } return {}; } QVariant QQmlObjectModel::variantValue(int index, const QString &role) { Q_D(QQmlObjectModel); if (index < 0 || index >= d->children.size()) return QString(); if (QObject *item = d->children.at(index).item()) return item->property(role.toUtf8().constData()); return QString(); } QQmlIncubator::Status QQmlObjectModel::incubationStatus(int) { return QQmlIncubator::Ready; } int QQmlObjectModel::indexOf(QObject *item, QObject *) const { Q_D(const QQmlObjectModel); return d->indexOf(item); } QQmlObjectModelAttached *QQmlObjectModel::qmlAttachedProperties(QObject *obj) { return new QQmlObjectModelAttached(obj); } /*! \qmlmethod object QtQml.Models::ObjectModel::get(int index) \since 5.6 Returns the item at \a index in the model. This allows the item to be accessed or modified from JavaScript: \code Component.onCompleted: { objectModel.append(objectComponent.createObject()) console.log(objectModel.get(0).objectName); objectModel.get(0).objectName = "first"; } \endcode The \a index must be an element in the list. \sa append() */ QObject *QQmlObjectModel::get(int index) const { Q_D(const QQmlObjectModel); if (index < 0 || index >= d->children.size()) return nullptr; return d->children.at(index).item(); } /*! \qmlmethod QtQml.Models::ObjectModel::append(object item) \since 5.6 Appends a new \a item to the end of the model. \code objectModel.append(objectComponent.createObject()) \endcode \sa insert(), remove() */ void QQmlObjectModel::append(QObject *object) { Q_D(QQmlObjectModel); d->insert(count(), object); } /*! \qmlmethod QtQml.Models::ObjectModel::insert(int index, object item) \since 5.6 Inserts a new \a item to the model at position \a index. \code objectModel.insert(2, objectComponent.createObject()) \endcode The \a index must be to an existing item in the list, or one past the end of the list (equivalent to append). \sa append(), remove() */ void QQmlObjectModel::insert(int index, QObject *object) { Q_D(QQmlObjectModel); if (index < 0 || index > count()) { qmlWarning(this) << tr("insert: index %1 out of range").arg(index); return; } d->insert(index, object); } /*! \qmlmethod QtQml.Models::ObjectModel::move(int from, int to, int n = 1) \since 5.6 Moves \a n items \a from one position \a to another. The from and to ranges must exist; for example, to move the first 3 items to the end of the model: \code objectModel.move(0, objectModel.count - 3, 3) \endcode \sa append() */ void QQmlObjectModel::move(int from, int to, int n) { Q_D(QQmlObjectModel); if (n <= 0 || from == to) return; if (from < 0 || to < 0 || from + n > count() || to + n > count()) { qmlWarning(this) << tr("move: out of range"); return; } d->move(from, to, n); } /*! \qmlmethod QtQml.Models::ObjectModel::remove(int index, int n = 1) \since 5.6 Removes \a n items at \a index from the model. \sa clear() */ void QQmlObjectModel::remove(int index, int n) { Q_D(QQmlObjectModel); if (index < 0 || n <= 0 || index + n > count()) { qmlWarning(this) << tr("remove: indices [%1 - %2] out of range [0 - %3]").arg(index).arg(index+n).arg(count()); return; } d->remove(index, n); } /*! \qmlmethod QtQml.Models::ObjectModel::clear() \since 5.6 Clears all items from the model. \sa append(), remove() */ void QQmlObjectModel::clear() { Q_D(QQmlObjectModel); d->clear(); } bool QQmlInstanceModel::setRequiredProperty(int index, const QString &name, const QVariant &value) { Q_UNUSED(index); Q_UNUSED(name); Q_UNUSED(value); // The view should not call this function, unless // it's actually handled in a subclass. Q_UNREACHABLE_RETURN(false); } QT_END_NAMESPACE #include "moc_qqmlobjectmodel_p.cpp"