summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMartin Jones <martin.jones@nokia.com>2009-10-23 03:54:37 (GMT)
committerMartin Jones <martin.jones@nokia.com>2009-10-23 03:54:37 (GMT)
commit0e8c19cd03512c33c0936dc59a64b248756c9e05 (patch)
tree407235e55fdff05a52377c4a51c31e7e49bf0a9a
parent0c412288e68aeccf9d17012b3fee944e99330e25 (diff)
downloadQt-0e8c19cd03512c33c0936dc59a64b248756c9e05.zip
Qt-0e8c19cd03512c33c0936dc59a64b248756c9e05.tar.gz
Qt-0e8c19cd03512c33c0936dc59a64b248756c9e05.tar.bz2
Doc.
-rw-r--r--doc/src/declarative/qmlintro.qdoc57
1 files changed, 57 insertions, 0 deletions
diff --git a/doc/src/declarative/qmlintro.qdoc b/doc/src/declarative/qmlintro.qdoc
index 767cdd0..f84d614 100644
--- a/doc/src/declarative/qmlintro.qdoc
+++ b/doc/src/declarative/qmlintro.qdoc
@@ -265,9 +265,66 @@ because \c changes is the default property of the \c State type.
\section2 Dot Properties
+
+
\section2 Attached Properties
\target attached-properties
+Some objects attach properties to another object. Attached Properties
+are of the form \e {Type.property} where \e Type is the type of the
+element that attaches \e property.
+
+For example:
+\code
+Component {
+ id: myDelegate
+ Text {
+ text: "Hello"
+ color: ListView.isCurrentItem ? "red" : "blue"
+ }
+}
+ListView {
+ delegate: myDelegate
+}
+\endcode
+
+The \l ListView element attaches the \e ListView.isCurrentItem property
+to each delegate it creates.
+
+Another example of attached properties is the \l Keys element which
+attaches properties for handling key presses to
+any visual Item, for example:
+
+\code
+Item {
+ focus: true
+ Keys.onSelectPressed: print("Selected")
+}
+\endcode
+
\section2 Signal Handlers
+Signal handlers allow actions to be taken in reponse to an event. For instance,
+the \l MouseRegion element has signal handlers to handle mouse press, release
+and click:
+
+\code
+MouseRegion {
+ onPressed: print("mouse button pressed")
+}
+\endcode
+
+All signal handlers begin with \e "on".
+
+Some signal handlers include an optional parameter, for example
+the MouseRegion onPressed signal handler has a \e mouse parameter:
+
+\code
+MouseRegion {
+ acceptedButtons: Qt.LeftButton | Qt.RightButton
+ onPressed: if (mouse.button == Qt.RightButton) print("Right mouse button pressed")
+}
+\endcode
+
+
*/