summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorAlan Alpert <alan.alpert@nokia.com>2010-02-24 14:41:59 (GMT)
committerAlan Alpert <alan.alpert@nokia.com>2010-02-24 14:41:59 (GMT)
commita343544b0fcb245cf0a0edbbce153611a6342374 (patch)
tree660c7c9ee269c9d685398a865590422336e9b95e /src
parent9872dce1dcb74216cad30301502d1c77de2356ad (diff)
downloadQt-a343544b0fcb245cf0a0edbbce153611a6342374.zip
Qt-a343544b0fcb245cf0a0edbbce153611a6342374.tar.gz
Qt-a343544b0fcb245cf0a0edbbce153611a6342374.tar.bz2
Explain the onPropertyChanged pattern in the docs.
Diffstat (limited to 'src')
-rw-r--r--src/declarative/graphicsitems/qdeclarativeitem.cpp11
1 files changed, 11 insertions, 0 deletions
diff --git a/src/declarative/graphicsitems/qdeclarativeitem.cpp b/src/declarative/graphicsitems/qdeclarativeitem.cpp
index d492dbd..c282808 100644
--- a/src/declarative/graphicsitems/qdeclarativeitem.cpp
+++ b/src/declarative/graphicsitems/qdeclarativeitem.cpp
@@ -1172,6 +1172,17 @@ QDeclarativeKeysAttached *QDeclarativeKeysAttached::qmlAttachedProperties(QObjec
See the \l {Keys}{Keys} attached property for detailed documentation.
+ \section 1 Property Change Signals
+
+ Most properties on Item and Item derivatives have a signal
+ emitted when they change. By convention, the signals are
+ named <propertyName>Changed, e.g. xChanged will be emitted when an item's
+ x property changes. Note that these also have signal handers e.g.
+ the onXChanged signal handler will be called when an item's x property
+ changes. For many properties in Item or Item derivatives this can be used
+ to add a touch of imperative logic to your application (when absolutely
+ necessary).
+
\ingroup group_coreitems
*/