aboutsummaryrefslogtreecommitdiffstats
path: root/examples/quick/demos/stocqt/doc/src/stocqt.qdoc
diff options
context:
space:
mode:
Diffstat (limited to 'examples/quick/demos/stocqt/doc/src/stocqt.qdoc')
-rw-r--r--examples/quick/demos/stocqt/doc/src/stocqt.qdoc49
1 files changed, 47 insertions, 2 deletions
diff --git a/examples/quick/demos/stocqt/doc/src/stocqt.qdoc b/examples/quick/demos/stocqt/doc/src/stocqt.qdoc
index 5f090e84f9..5e5ba3caf5 100644
--- a/examples/quick/demos/stocqt/doc/src/stocqt.qdoc
+++ b/examples/quick/demos/stocqt/doc/src/stocqt.qdoc
@@ -32,8 +32,53 @@
\brief A configurable stock chart for the NASDAQ-100.
\image qtquick-demo-stocqt.png
- \e{StocQt} demonstrates various QML and \l{Qt Quick} features such as
- displaying custom components and downloading data from the internet.
+ The \e{StocQt} application presents a trend chart for the first stock in
+ the list of NASDAQ-100 stocks maintained by it. It allows the user to
+ choose another stock from the list, and fetches the required data for
+ the selected stock by sending an \c XMLHttpRequest to
+ http://finance.yahoo.com.
+
+ The application uses several custom types such as Button, CheckBox,
+ StockChart, StockInfo, StockView, and so on. These types are used to
+ present the stock data in a readable form and also let the user customize
+ the trend chart. For example, the user can choose to view the yearly,
+ monthly, or daily trends in the stock price.
+
+ The application uses the ObjectModel type to access the two visual data
+ models that it depends on.
+
+ \quotefromfile demos/stocqt/stocqt.qml
+ \skipto ListView
+ \printuntil id
+ \dots 8
+ \skipto model
+ \printuntil StockView
+ \printuntil }
+ \printuntil }
+ \printuntil }
+
+ The StockListView model is a static data model listing the
+ NASDAQ-100 stocks with basic information such as stockId, name, value,
+ change, and so on. This data model is used by the application if the
+ user wants to choose another stock from the list.
+
+ StockView is a complex data model that presents a trend chart for the
+ selected stock. It uses another custom type, StockChart, which presents
+ the graphical trend of the stock price using a Canvas. This data model
+ is used for most of the time during the lifetime of the application.
+
+ \quotefromfile demos/stocqt/content/StockChart.qml
+ \skipto Rectangle
+ \printuntil height
+ \dots
+ \skipto Canvas
+ \printuntil id
+ \dots 8
+ \skipto onPaint
+ \printuntil /^\}$/
+
+ To understand the application better, browse through its code using
+ Qt Creator.
\include examples-run.qdocinc