From 434595865bdeeb4a822621be40b18dfa3179b9c0 Mon Sep 17 00:00:00 2001 From: Albert Astals Cid Date: Wed, 20 Jul 2022 14:07:57 +0200 Subject: [PATCH] Doc: be more explicit about when a MEMBER property NOTIFY signal is emitted automatically Change-Id: Ied5eb0c218d11872fbf590d735a88a11b5cd1c3e Reviewed-by: Ulf Hermann Reviewed-by: Giuseppe D'Angelo --- src/corelib/doc/src/objectmodel/properties.qdoc | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/src/corelib/doc/src/objectmodel/properties.qdoc b/src/corelib/doc/src/objectmodel/properties.qdoc index 7ca3e25b004..eef2df70282 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