include/QtCore/qbindingstorage.h

0001 // Copyright (C) 2021 The Qt Company Ltd.
0002 // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
0003
0004 #ifndef QBINDINGSTORAGE_H
0005 #define QBINDINGSTORAGE_H
0006
0007 #include <QtCore/qglobal.h>
0008 #include <QtCore/qnamespace.h>
0009
0010 QT_BEGIN_NAMESPACE
0011
0012 template <typename Class, typename T, auto Offset, auto Setter, auto Signal, auto Getter>
0013 class QObjectCompatProperty;
0014 struct QPropertyDelayedNotifications;
0015 class QUntypedPropertyData;
0016
0017 namespace QtPrivate {
0018
0019 class QPropertyBindingData;
0020 struct BindingEvaluationState;
0021 struct CompatPropertySafePoint;
0022 }
0023
0024 struct QBindingStatus
0025 {
0026     QtPrivate::BindingEvaluationState *currentlyEvaluatingBinding = nullptr;
0027     QtPrivate::CompatPropertySafePoint *currentCompatProperty = nullptr;
0028     Qt::HANDLE threadId = nullptr;
0029     QPropertyDelayedNotifications *groupUpdateData = nullptr;
0030 };
0031
0032 namespace QtPrivate {
0033 struct QBindingStatusAccessToken;
0034 Q_AUTOTEST_EXPORT QBindingStatus *getBindingStatus(QBindingStatusAccessToken);
0035 Q_AUTOTEST_EXPORT void setBindingStatus(QBindingStatus *, QBindingStatusAccessToken);
0036 }
0037
0038
0039 struct QBindingStorageData;
0040 class Q_CORE_EXPORT QBindingStorage
0041 {
0042     mutable QBindingStorageData *d = nullptr;
0043     QBindingStatus *bindingStatus = nullptr;
0044
0045     template<typename Class, typename T, auto Offset, auto Setter, auto Signal, auto Getter>
0046     friend class QObjectCompatProperty;
0047     friend class QObjectPrivate;
0048     friend class QtPrivate::QPropertyBindingData;
0049 public:
0050     QBindingStorage();
0051     ~QBindingStorage();
0052
0053     bool isEmpty() { return !d; }
0054     bool isValid() const noexcept { return bindingStatus; }
0055
0056     const QBindingStatus *status(QtPrivate::QBindingStatusAccessToken) const;
0057
0058     void registerDependency(const QUntypedPropertyData *data) const
0059     {
0060         if (!bindingStatus || !bindingStatus->currentlyEvaluatingBinding)
0061             return;
0062         registerDependency_helper(data);
0063     }
0064     QtPrivate::QPropertyBindingData *bindingData(const QUntypedPropertyData *data) const
0065     {
0066         if (!d)
0067             return nullptr;
0068         return bindingData_helper(data);
0069     }
0070
0071 #if QT_CORE_REMOVED_SINCE(6, 2)
0072     void maybeUpdateBindingAndRegister(const QUntypedPropertyData *data) const { registerDependency(data); }
0073 #endif
0074
0075     QtPrivate::QPropertyBindingData *bindingData(QUntypedPropertyData *data, bool create)
0076     {
0077         if (!d && !create)
0078             return nullptr;
0079         return bindingData_helper(data, create);
0080     }
0081 private:
0082     void reinitAfterThreadMove();
0083     void clear();
0084     void registerDependency_helper(const QUntypedPropertyData *data) const;
0085 #if QT_CORE_REMOVED_SINCE(6, 2)
0086     // ### Unused, but keep for BC
0087     void maybeUpdateBindingAndRegister_helper(const QUntypedPropertyData *data) const;
0088 #endif
0089     QtPrivate::QPropertyBindingData *bindingData_helper(const QUntypedPropertyData *data) const;
0090     QtPrivate::QPropertyBindingData *bindingData_helper(QUntypedPropertyData *data, bool create);
0091 };
0092
0093 QT_END_NAMESPACE
0094
0095 #endif // QBINDINGSTORAGE_H