diff options
author | Mitch Curtis <mitch.curtis@qt.io> | 2023-06-01 17:56:24 +0800 |
---|---|---|
committer | Qt Cherry-pick Bot <cherrypick_bot@qt-project.org> | 2023-06-13 03:48:27 +0000 |
commit | 433a1872f26a1f1fbb873b62d0527f3418c3a4c6 (patch) | |
tree | 8a0e1bf8c3dafaba6b676a9c18a3c0d51b4f2c22 | |
parent | 822002d7c22a7dc80b9976aa1ba41769d017c69c (diff) |
Doc: explain issues with revisions
Due to how Qt Quick Controls are implemented, new properties that are
added may clash with any user-defined properties of the same name.
Fixes: QTBUG-80788
Change-Id: Ic13dce06c880a0eac5b321f4ef4fae38d29994d5
Reviewed-by: Ulf Hermann <ulf.hermann@qt.io>
(cherry picked from commit 9cef433dbd730abd81eb6d96169519f2f84a7ea0)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
-rw-r--r-- | src/quickcontrols/doc/src/qtquickcontrols-index.qdoc | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/src/quickcontrols/doc/src/qtquickcontrols-index.qdoc b/src/quickcontrols/doc/src/qtquickcontrols-index.qdoc index ae16f75078..3aa6010914 100644 --- a/src/quickcontrols/doc/src/qtquickcontrols-index.qdoc +++ b/src/quickcontrols/doc/src/qtquickcontrols-index.qdoc @@ -105,6 +105,31 @@ \li ... \endtable + \section2 Revisions + + Due to how Qt Quick Controls are implemented, new properties that are added + may clash with any user-defined properties of the same name. For example, + the following snippet will result in an error: + + \qml + import QtQuick.Controls 2.13 + + ApplicationWindow { + // ... + + ComboBox { + anchors.centerIn: parent + + // As currentValue was added in 2.14, the versioned import above + // should cause this property to be used, but instead an error is produced: + // "Cannot override FINAL property" + property int currentValue: 0 + } + } + \endqml + + These properties should be renamed to avoid the conflict. + \section1 Module Evolution Qt Quick Controls was originally written with touch interfaces as the |