Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-138886

Improve "once-off assignment" wording in QML PropertyChanges documentation

XMLWordPrintable

    • All
    • ca56649ae (dev), 5210e391e (6.10)
    • framework-content 17

      The description for QtQuick::PropertyChanges::explicit in qquickpropertychanges.cpp begins with:

      "If explicit is set to true, any potential bindings will be interpreted as once-off assignments that occur when the state is entered."

      (see https://doc.qt.io/qt-6/qml-qtquick-propertychanges.html#explicit-prop).

      "once-off" is the British equivalent to the American term: "one-off". Being American, I found this confusing and looked into its use. "once-off" appears only twice in Qt source: in qquickpropertychanges.cpp and an in-code comment in a qfontmetrics benchmark.

      I think the sentence can be reworded to improve comprehension. For example:

      "If explicit is set to true, property values are assigned once when the state is entered rather than creating bindings that update automatically."

        For Gerrit Dashboard: QTBUG-138886
        # Subject Branch Project Status CR V

            jerome.pasion Jerome Pasion
            stan.m Stanley Morris
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved:

                There are no open Gerrit changes