From a343544b0fcb245cf0a0edbbce153611a6342374 Mon Sep 17 00:00:00 2001 From: Alan Alpert Date: Wed, 24 Feb 2010 15:41:59 +0100 Subject: Explain the onPropertyChanged pattern in the docs. --- src/declarative/graphicsitems/qdeclarativeitem.cpp | 11 +++++++++++ 1 file changed, 11 insertions(+) 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 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 */ -- cgit v0.12