qqmlpreviewobjectpatch_p.h

Go to the documentation of this file.

// Copyright (C) 2026 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
// Qt-Security score:significant reason:default
 
#ifndef QQMLPREVIEWOBJECTPATCH_P_H
#define QQMLPREVIEWOBJECTPATCH_P_H
 
//
//  W A R N I N G
//  -------------
//
// This file is not part of the Qt API.  It exists purely as an
// implementation detail.  This header file may change from version to
// version without notice, or even be removed.
//
// We mean it.
//
 
#include <private/qv4executablecompilationunit_p.h>
 
#include <QtCore/qobject.h>
 
#include <vector>
 
QT_BEGIN_NAMESPACE
 
namespace QQmlPreview {
 
enum class PatchResult: quint8 {
    Failed,         // The diff cannot be applied in place; the caller must do a full reload.
    Rebuilt,        // Component roots were rebuilt; left-over old expressions must be nulled.
    PatchedInPlace, // Trivial diff: objects kept; their old expressions must be translated.
};
 
PatchResult applyDiff(std::vector<QObject *> &objects,
                      const QQmlRefPointer<QV4::ExecutableCompilationUnit> &oldUnit,
                      const QQmlRefPointer<QV4::ExecutableCompilationUnit> &newUnit);
 
// Translate still-live expressions from oldUnit to the function at the same
// index in newUnit (or nullptr if there is no newUnit). Re-evaluate them if necessary.
void refreshBindings(const QQmlRefPointer<QV4::ExecutableCompilationUnit> &oldUnit,
                     const QQmlRefPointer<QV4::ExecutableCompilationUnit> &newUnit = {});
 
// Point every resolved type reference in the engine that names oldUnit at newUnit.
void redirectResolvedTypeReferences(
        QV4::ExecutionEngine *engine,
        const QQmlRefPointer<QV4::CompiledData::CompilationUnit> &oldUnit,
        const QQmlRefPointer<QV4::CompiledData::CompilationUnit> &newUnit);
 
} // namespace QQmlPreview
 
QT_END_NAMESPACE
 
#endif // QQMLPREVIEWOBJECTPATCH_P_H