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."

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

            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