Мне трудно подтвердить правила владения объектами элементов, вставленных в QQmlPropertyList, когда он настроен как часть компонента QML, определенного на C++ с помощью
Q_CLASSINFO("DefaultProperty", "values")
DTech задал нечто подобное в: QQmlListProperty - QList с возможностью записи нарушает правила управления памятью QML?, но его беспокоили последствия удаления компонентов, определенных в QML. Меня больше беспокоят требования жизненного цикла объектов, вставленных в список в целом.
Теперь из того, что я понимаю:
Если дочерние элементы созданы и вставлены из QML, их родители будут установлены автоматически, а объекты будут управляться QmlEngine. (родитель должен быть уже определен при добавлении)
Если я вставляю что-то со стороны C++, мне нужно самому управлять временем жизни. (родительский элемент будет nullptr при добавлении)
Документы QT предупреждают о «нарушении правил управления памятью QML». в http://doc.qt.io/qt-5/qqmllistproperty.html но я не могу найти ничего, что действительно говорит об этом в ясной и лаконичной форме.
В настоящее время я реализовал оболочку вокруг вектора, очень похожего на http://doc.qt.io/qt-5/qtqml-referenceexamples-properties-example.html
Однако я добавил два правила:
- Добавление проверяет, имеет ли добавляемый объект родителя nullptr и, если да, становится владельцем.
- При очистке, если какой-либо объект принадлежит текущему родительскому элементу списка, выполняется 'deleteLater' для объекта и устанавливается его родитель в nullptr
Я предполагаю, что, поскольку мы устанавливаем родителя при добавлении объектов с родителями nullptr, QT автоматически удалит принадлежащие QObjects, когда родитель выйдет за пределы области видимости.
Есть ли еще правила, которые мне не хватает и о которых нужно знать?
Код для моей реализации на тот случай, если приведенное выше требует небольшого пояснения:
template <typename T>
class QmlListFacade {
private:
std::vector<T *> _storage;
static void append(QQmlListProperty<T> *list, T *newValue) {
// take ownership of the object if none are currently defined
auto obj = static_cast<QObject *>(newValue);
if( obj->parent() == nullptr) {
obj->setParent(list->object);
}
auto internalList = reinterpret_cast<QmlListFacade *>(list->data);
internalList->_storage.push_back(newValue);
}
static int count(QQmlListProperty<T> *list) {
return reinterpret_cast<QmlListFacade *>(list->data)->_storage.size();
}
static T *get(QQmlListProperty<T> *list, int index) {
return reinterpret_cast<QmlListFacade *>(list->data)->_storage[index];
}
static void clear(QQmlListProperty<T> *list) {
auto internalList = reinterpret_cast<QmlListFacade *>(list->data);
for( auto item :internalList->_storage){
// only delete if we are the owners.
auto obj = static_cast<QObject *>(item);
if( obj->parent() == list->object){
obj->setParent(nullptr);
obj->deleteLater();
}
}
return internalList->_storage.clear();
}
public:
QmlListFacade() = default;
QQmlListProperty<T> values(QObject *parent) {
return QQmlListProperty<T>(parent, this, &QmlListFacade::append, &QmlListFacade::count, &QmlListFacade::get,
&QmlListFacade::clear);
}
};