diff options
author | Albert Astals Cid <aacid@kde.org> | 2022-07-20 14:07:57 +0200 |
---|---|---|
committer | Albert Astals Cid <aacid@kde.org> | 2022-07-27 10:51:08 +0200 |
commit | 434595865bdeeb4a822621be40b18dfa3179b9c0 (patch) | |
tree | 2d8dcaa11708fbe4abab351a41470ebace65b446 | |
parent | 999654fec7660cd5a724df26a4bc9f54e117a1b1 (diff) |
Doc: be more explicit about when a MEMBER property NOTIFY signal is emitted automatically
Change-Id: Ied5eb0c218d11872fbf590d735a88a11b5cd1c3e
Reviewed-by: Ulf Hermann <ulf.hermann@qt.io>
Reviewed-by: Giuseppe D'Angelo <giuseppe.dangelo@kdab.com>
-rw-r--r-- | src/corelib/doc/src/objectmodel/properties.qdoc | 5 |
1 files changed, 3 insertions, 2 deletions
diff --git a/src/corelib/doc/src/objectmodel/properties.qdoc b/src/corelib/doc/src/objectmodel/properties.qdoc index 7ca3e25b00..eef2df7028 100644 --- a/src/corelib/doc/src/objectmodel/properties.qdoc +++ b/src/corelib/doc/src/objectmodel/properties.qdoc @@ -82,8 +82,9 @@ which must be of the same type as the property. The parameter will take the new value of the property. The \c NOTIFY signal should only be emitted when the property has really been changed, to avoid bindings being unnecessarily - re-evaluated in QML, for example. Qt emits automatically that signal when - needed for MEMBER properties that do not have an explicit setter. + re-evaluated in QML, for example. The signal is emitted automatically when + the property is changed via the Qt API (QObject::setProperty, + QMetaProperty, etc.), but not when the MEMBER is changed directly. \li A \c REVISION number or \c REVISION() macro is optional. If included, it defines the property and its notifier signal to be used in a particular |