summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlbert Astals Cid <aacid@kde.org>2022-07-20 14:07:57 +0200
committerAlbert Astals Cid <aacid@kde.org>2022-07-27 10:51:08 +0200
commit434595865bdeeb4a822621be40b18dfa3179b9c0 (patch)
tree2d8dcaa11708fbe4abab351a41470ebace65b446
parent999654fec7660cd5a724df26a4bc9f54e117a1b1 (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.qdoc5
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