This file is indexed.

/usr/share/qt5/doc/qtquick/qtquick-demos-rssnews-example.html is in qtdeclarative5-doc-html 5.5.1-2ubuntu6.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- rssnews.qdoc -->
  <title>Qt Quick Demo - RSS News | Qt Quick 5.5</title>
  <link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
    <div class="main">
    <div class="main-rounded">
        <div class="navigationbar">
        <ul>
<li>Qt 5.5</li>
<li><a href="qtquick-index.html">Qt Quick</a></li>
<li>Qt Quick Demo - RSS News</li>
<li id="buildversion">Qt 5.5.1 Reference Documentation</li>
    </ul>
    </div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#running-the-example">Running the Example</a></li>
<li class="level1"><a href="#using-custom-types">Using Custom Types</a></li>
<li class="level1"><a href="#creating-the-main-window">Creating the Main Window</a></li>
<li class="level1"><a href="#creating-a-category-list">Creating a Category List</a></li>
<li class="level1"><a href="#creating-list-elements">Creating List Elements</a></li>
<li class="level1"><a href="#downloading-xml-data">Downloading XML Data</a></li>
<li class="level1"><a href="#providing-feedback-to-users">Providing Feedback to Users</a></li>
<li class="level1"><a href="#creating-scroll-bars">Creating Scroll Bars</a></li>
<li class="level1"><a href="#creating-footers">Creating Footers</a></li>
<li class="level1"><a href="#creating-buttons">Creating Buttons</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">Qt Quick Demo - RSS News</h1>
<span class="subtitle"></span>
<!-- $$$demos/rssnews-description -->
<div class="descr"> <a name="details"></a>
<p class="centerAlign"><img src="images/qtquick-demo-rssnews-small.png" alt="" /></p><p><i>RSS News</i> demonstrates the following <a href="qtquick-index.html">Qt Quick</a> features:</p>
<ul>
<li>Using custom types to create screens and screen controls.</li>
<li>Using list models and list elements to represent data.</li>
<li>Using XML list models to download XML data.</li>
<li>Using list views to display data.</li>
<li>Using the Component type to create a footer for the news item list view.</li>
<li>Using the <a href="qtquick-imageelements-example.html#image">Image</a> type to create a button for closing the app.</li>
</ul>
<a name="running-the-example"></a>
<h2 id="running-the-example">Running the Example</h2>
<p>To run the example from Qt Creator, open the <b>Welcome</b> mode and select the example from <b>Examples</b>. For more information, visit Building and Running an Example.</p>
<a name="using-custom-types"></a>
<h2 id="using-custom-types">Using Custom Types</h2>
<p>In the RSS News app, we use the following custom types that are each defined in a separate .qml file:</p>
<ul>
<li><code>BusyIndicator.qml</code></li>
<li><code>CategoryDelegate.qml</code></li>
<li><code>NewsDelegate.qml</code></li>
<li><code>RssFeeds.qml</code></li>
<li><code>ScrollBar.qml</code></li>
</ul>
<p>To use the custom types, we add an import statement to the main QML file, rssnews.qml that imports the folder called <code>content</code> where the types are located:</p>
<pre class="qml">import &quot;./content&quot;</pre>
<a name="creating-the-main-window"></a>
<h2 id="creating-the-main-window">Creating the Main Window</h2>
<p>In rssnews.qml, we use a <a href="qml-qtquick-rectangle.html">Rectangle</a> type with custom properties to create the app main window:</p>
<pre class="qml"><span class="type"><a href="qml-qtquick-rectangle.html">Rectangle</a></span> {
    <span class="name">id</span>: <span class="name">window</span>

    <span class="name">width</span>: <span class="number">800</span>
    <span class="name">height</span>: <span class="number">480</span>

    property <span class="type">string</span> <span class="name">currentFeed</span>: <span class="name">rssFeeds</span>.<span class="name">get</span>(<span class="number">0</span>).<span class="name">feed</span>
    property <span class="type">bool</span> <span class="name">loading</span>: <span class="name">feedModel</span>.<span class="name">status</span> <span class="operator">===</span> <span class="name">XmlListModel</span>.<span class="name">Loading</span>
    property <span class="type">bool</span> <span class="name">isPortrait</span>: <span class="name">Screen</span>.<span class="name">primaryOrientation</span> <span class="operator">===</span> <span class="name">Qt</span>.<span class="name">PortraitOrientation</span></pre>
<p>We will use the custom properties later for loading XML data and for adjusting the screen layout depending on its orientation.</p>
<a name="creating-a-category-list"></a>
<h2 id="creating-a-category-list">Creating a Category List</h2>
<p>In rssnews.qml, we use the RssFeeds custom type that we specify in RssFeeds.qml to create a list of feed categories:</p>
<pre class="qml">    <span class="type">RssFeeds</span> { <span class="name">id</span>: <span class="name">rssFeeds</span> }</pre>
<p>In RssFeeds.qml, we use a <a href="qtquick-modelviewsdata-modelview.html#listmodel">ListModel</a> type with a ListElement type to create a category list where list elements represent feed categories:</p>
<pre class="qml"><span class="type">ListModel</span> {
    <span class="type">ListElement</span> { <span class="name">name</span>: <span class="string">&quot;Top Stories&quot;</span>; <span class="name">feed</span>: <span class="string">&quot;news.yahoo.com/rss/topstories&quot;</span>; <span class="name">image</span>: <span class="string">&quot;images/TopStories.jpg&quot;</span> }
    <span class="type">ListElement</span> { <span class="name">name</span>: <span class="string">&quot;World&quot;</span>; <span class="name">feed</span>: <span class="string">&quot;news.yahoo.com/rss/world&quot;</span>; <span class="name">image</span>: <span class="string">&quot;images/World.jpg&quot;</span> }
    <span class="type">ListElement</span> { <span class="name">name</span>: <span class="string">&quot;Europe&quot;</span>; <span class="name">feed</span>: <span class="string">&quot;news.yahoo.com/rss/europe&quot;</span>; <span class="name">image</span>: <span class="string">&quot;images/Europe.jpg&quot;</span> }
    <span class="type">ListElement</span> { <span class="name">name</span>: <span class="string">&quot;Asia&quot;</span>; <span class="name">feed</span>: <span class="string">&quot;news.yahoo.com/rss/asia&quot;</span>; <span class="name">image</span>: <span class="string">&quot;images/Asia.jpg&quot;</span> }
    <span class="type">ListElement</span> { <span class="name">name</span>: <span class="string">&quot;U.S. National&quot;</span>; <span class="name">feed</span>: <span class="string">&quot;news.yahoo.com/rss/us&quot;</span>; <span class="name">image</span>: <span class="string">&quot;images/USNational.jpg&quot;</span>  }
    <span class="type">ListElement</span> { <span class="name">name</span>: <span class="string">&quot;Politics&quot;</span>; <span class="name">feed</span>: <span class="string">&quot;news.yahoo.com/rss/politics&quot;</span>; <span class="name">image</span>: <span class="string">&quot;images/Politics.jpg&quot;</span> }
    <span class="type">ListElement</span> { <span class="name">name</span>: <span class="string">&quot;Business&quot;</span>; <span class="name">feed</span>: <span class="string">&quot;news.yahoo.com/rss/business&quot;</span>; <span class="name">image</span>: <span class="string">&quot;images/Business.jpg&quot;</span> }
    <span class="type">ListElement</span> { <span class="name">name</span>: <span class="string">&quot;Technology&quot;</span>; <span class="name">feed</span>: <span class="string">&quot;news.yahoo.com/rss/tech&quot;</span>; <span class="name">image</span>: <span class="string">&quot;images/Technology.jpg&quot;</span> }
    <span class="type">ListElement</span> { <span class="name">name</span>: <span class="string">&quot;Entertainment&quot;</span>; <span class="name">feed</span>: <span class="string">&quot;news.yahoo.com/rss/entertainment&quot;</span>; <span class="name">image</span>: <span class="string">&quot;images/Entertainment.jpg&quot;</span> }
    <span class="type">ListElement</span> { <span class="name">name</span>: <span class="string">&quot;Health&quot;</span>; <span class="name">feed</span>: <span class="string">&quot;news.yahoo.com/rss/health&quot;</span>; <span class="name">image</span>: <span class="string">&quot;images/Health.jpg&quot;</span> }
    <span class="type">ListElement</span> { <span class="name">name</span>: <span class="string">&quot;Science&quot;</span>; <span class="name">feed</span>: <span class="string">&quot;news.yahoo.com/rss/science&quot;</span>; <span class="name">image</span>: <span class="string">&quot;images/Science.jpg&quot;</span> }
    <span class="type">ListElement</span> { <span class="name">name</span>: <span class="string">&quot;Sports&quot;</span>; <span class="name">feed</span>: <span class="string">&quot;news.yahoo.com/rss/sports&quot;</span>; <span class="name">image</span>: <span class="string">&quot;images/Sports.jpg&quot;</span> }
}</pre>
<p>List elements are defined like other QML types except that they contain a collection of <i>role</i> definitions instead of properties. Roles both define how the data is accessed and include the data itself.</p>
<p>For each list element, we use the <code>name</code> role to specify the category name, the <code>feed</code> role to specify the URL to load the data from, and the <code>image</code> role to display an image for the category.</p>
<p>In rssnews.qml, we use a <a href="qml-qtquick-listview.html">ListView</a> type to display the category list:</p>
<pre class="qml">    <span class="type"><a href="qml-qtquick-listview.html">ListView</a></span> {
        <span class="name">id</span>: <span class="name">categories</span>
        property <span class="type">int</span> <span class="name">itemWidth</span>: <span class="number">190</span>

        <span class="name">width</span>: <span class="name">isPortrait</span> ? <span class="name">parent</span>.<span class="name">width</span> : <span class="name">itemWidth</span>
        <span class="name">height</span>: <span class="name">isPortrait</span> ? <span class="name">itemWidth</span> : <span class="name">parent</span>.<span class="name">height</span>
        <span class="name">orientation</span>: <span class="name">isPortrait</span> ? <span class="name">ListView</span>.<span class="name">Horizontal</span> : <span class="name">ListView</span>.<span class="name">Vertical</span>
        <span class="name">anchors</span>.top: <span class="name">parent</span>.<span class="name">top</span>
        <span class="name">model</span>: <span class="name">rssFeeds</span>
        <span class="name">delegate</span>: <span class="name">CategoryDelegate</span> { <span class="name">itemSize</span>: <span class="name">categories</span>.<span class="name">itemWidth</span> }
        <span class="name">spacing</span>: <span class="number">3</span>
    }</pre>
<p>To lay out the category list horizontally at the top of the window in portrait orientation and vertically on the left side in landscape orientation, we use the <code>orientation</code> property. Based on the orientation, we bind either the width or the height of the list to a fixed value (<code>itemWidth</code>).</p>
<p>We use the <code>anchors.top</code> property to position the list view at the top of the screen in both orientations.</p>
<p>We use the <code>model</code> property to load XML data from the <code>rssFeeds</code> model, and <code>CategoryDelegate</code> as the delegate to instantiate each item in the list.</p>
<a name="creating-list-elements"></a>
<h2 id="creating-list-elements">Creating List Elements</h2>
<p>In CategoryDelegate.qml, we use the <a href="qml-qtquick-rectangle.html">Rectangle</a> type with custom properties to create list elements:</p>
<pre class="qml"><span class="type"><a href="qml-qtquick-rectangle.html">Rectangle</a></span> {
    <span class="name">id</span>: <span class="name">delegate</span>

    property <span class="type">bool</span> <span class="name">selected</span>: <span class="name">ListView</span>.<span class="name">isCurrentItem</span></pre>
<p>We set the <code>selected</code> property to the <code>ListView.isCurrentItem</code> attached property to specify that <code>selected</code> is <code>true</code> if <code>delegate</code> is the current item.</p>
<p>We use the <a href="qtquick-imageelements-example.html#image">Image</a> type <code>source</code> property to display the image, centered in the delegate, specified for the list element by the <code>image</code> role in the <code>rssFeeds</code> list model:</p>
<pre class="qml">    <span class="type"><a href="qml-qtquick-image.html">Image</a></span> {
        <span class="name">anchors</span>.centerIn: <span class="name">parent</span>
        <span class="name">source</span>: <span class="name">image</span>
    }</pre>
<p>We use a <a href="qml-qtquick-text.html">Text</a> type to add titles to list elements:</p>
<pre class="qml">    <span class="type"><a href="qml-qtquick-text.html">Text</a></span> {
        <span class="name">id</span>: <span class="name">titleText</span>

        <span class="type">anchors</span> {
            <span class="name">left</span>: <span class="name">parent</span>.<span class="name">left</span>; <span class="name">leftMargin</span>: <span class="number">20</span>
            <span class="name">right</span>: <span class="name">parent</span>.<span class="name">right</span>; <span class="name">rightMargin</span>: <span class="number">20</span>
            <span class="name">top</span>: <span class="name">parent</span>.<span class="name">top</span>; <span class="name">topMargin</span>: <span class="number">20</span>
        }

        <span class="type">font</span> { <span class="name">pixelSize</span>: <span class="number">18</span>; <span class="name">bold</span>: <span class="number">true</span> }
        <span class="name">text</span>: <span class="name">name</span>
        <span class="name">color</span>: <span class="name">selected</span> ? <span class="string">&quot;#ffffff&quot;</span> : <span class="string">&quot;#ebebdd&quot;</span>
        <span class="name">scale</span>: <span class="name">selected</span> ? <span class="number">1.15</span> : <span class="number">1.0</span>
        Behavior on <span class="name">color</span> { <span class="type"><a href="qml-qtquick-coloranimation.html">ColorAnimation</a></span> { <span class="name">duration</span>: <span class="number">150</span> } }
        Behavior on <span class="name">scale</span> { <span class="type"><a href="qml-qtquick-propertyanimation.html">PropertyAnimation</a></span> { <span class="name">duration</span>: <span class="number">300</span> } }</pre>
<p>We use the <code>anchors</code> property to position the title at the top of the list element, with a 20-pixel margin. We use <code>font</code> properties to adjust font size and text formatting.</p>
<p>We use the <code>color</code> property to brighten the text and to scale it slightly larger when the list item is the current item. By applying a <a href="qml-qtquick-behavior.html">Behavior</a> to the property, we animate the actions of selecting and deselecting list items.</p>
<p>We use a <a href="qml-qtquick-mousearea.html">MouseArea</a> type to download XML data when users tap a category list element:</p>
<pre class="qml">    <span class="type"><a href="qml-qtquick-mousearea.html">MouseArea</a></span> {
        <span class="name">anchors</span>.fill: <span class="name">delegate</span>
        <span class="name">onClicked</span>: {
            <span class="name">delegate</span>.<span class="name">ListView</span>.<span class="name">view</span>.<span class="name">currentIndex</span> <span class="operator">=</span> <span class="name">index</span>
            <span class="keyword">if</span> (<span class="name">window</span>.<span class="name">currentFeed</span> <span class="operator">==</span> <span class="name">feed</span>)
                <span class="name">feedModel</span>.<span class="name">reload</span>()
            <span class="keyword">else</span>
                <span class="name">window</span>.<span class="name">currentFeed</span> <span class="operator">=</span> <span class="name">feed</span>
        }
    }</pre>
<p>The <code>anchors.fill</code> property is set to <code>delegate</code> to enable users to tap anywhere within the list element.</p>
<p>We use the <code>onClicked</code> signal handler to load the XML data for the category list. If the tapped category is already current, the <code>reload()</code> function is called to reload the data.</p>
<a name="downloading-xml-data"></a>
<h2 id="downloading-xml-data">Downloading XML Data</h2>
<p>In rssnews.qml, we use an <a href="qtquick-modelviewsdata-modelview.html#xmllistmodel">XmlListModel</a> type as a data source for <a href="qml-qtquick-listview.html">ListView</a> elements to display news items in the selected category:</p>
<pre class="qml">    <span class="type"><a href="qml-qtquick-xmllistmodel-xmllistmodel.html">XmlListModel</a></span> {
        <span class="name">id</span>: <span class="name">feedModel</span>

        <span class="name">source</span>: <span class="string">&quot;http://&quot;</span> <span class="operator">+</span> <span class="name">window</span>.<span class="name">currentFeed</span>
        <span class="name">query</span>: <span class="string">&quot;/rss/channel/item[child::media:content]&quot;</span>
        <span class="name">namespaceDeclarations</span>: <span class="string">&quot;declare namespace media = 'http://search.yahoo.com/mrss/';&quot;</span></pre>
<p>We use the <code>source</code> property and the <code>window.currentFeed</code> custom property to fetch news items for the selected category.</p>
<p>The <code>query</code> property specifies that the <a href="qtquick-modelviewsdata-modelview.html#xmllistmodel">XmlListModel</a> generates a model item for each <code>&lt;item&gt;</code> in the XML document.</p>
<p>We use the <a href="qml-qtquick-xmllistmodel-xmlrole.html">XmlRole</a> type to specify the model item attributes. Each model item has the <code>title</code>, <code>description</code>, <code>image</code>, <code>link</code>, and <code>pubDate</code> attributes that match the values of the corresponding <code>&lt;item&gt;</code> in the XML document:</p>
<pre class="qml">        <span class="type"><a href="qml-qtquick-xmllistmodel-xmlrole.html">XmlRole</a></span> { <span class="name">name</span>: <span class="string">&quot;title&quot;</span>; <span class="name">query</span>: <span class="string">&quot;title/string()&quot;</span> }
        <span class="comment">// Remove any links from the description</span>
        <span class="type"><a href="qml-qtquick-xmllistmodel-xmlrole.html">XmlRole</a></span> { <span class="name">name</span>: <span class="string">&quot;description&quot;</span>; <span class="name">query</span>: <span class="string">&quot;fn:replace(description/string(), '\&amp;lt;a href=.*\/a\&amp;gt;', '')&quot;</span> }
        <span class="type"><a href="qml-qtquick-xmllistmodel-xmlrole.html">XmlRole</a></span> { <span class="name">name</span>: <span class="string">&quot;image&quot;</span>; <span class="name">query</span>: <span class="string">&quot;media:content/@url/string()&quot;</span> }
        <span class="type"><a href="qml-qtquick-xmllistmodel-xmlrole.html">XmlRole</a></span> { <span class="name">name</span>: <span class="string">&quot;link&quot;</span>; <span class="name">query</span>: <span class="string">&quot;link/string()&quot;</span> }
        <span class="type"><a href="qml-qtquick-xmllistmodel-xmlrole.html">XmlRole</a></span> { <span class="name">name</span>: <span class="string">&quot;pubDate&quot;</span>; <span class="name">query</span>: <span class="string">&quot;pubDate/string()&quot;</span> }
    }</pre>
<p>We use the <code>feedModel</code> model in a <a href="qml-qtquick-listview.html">ListView</a> type to display the data:</p>
<pre class="qml">    <span class="type"><a href="qml-qtquick-listview.html">ListView</a></span> {
        <span class="name">id</span>: <span class="name">list</span>

        <span class="name">anchors</span>.left: <span class="name">isPortrait</span> ? <span class="name">window</span>.<span class="name">left</span> : <span class="name">categories</span>.<span class="name">right</span>
        <span class="name">anchors</span>.right: <span class="name">closeButton</span>.<span class="name">left</span>
        <span class="name">anchors</span>.top: <span class="name">isPortrait</span> ? <span class="name">categories</span>.<span class="name">bottom</span> : <span class="name">window</span>.<span class="name">top</span>
        <span class="name">anchors</span>.bottom: <span class="name">window</span>.<span class="name">bottom</span>
        <span class="name">anchors</span>.leftMargin: <span class="number">30</span>
        <span class="name">anchors</span>.rightMargin: <span class="number">4</span>
        <span class="name">clip</span>: <span class="name">isPortrait</span>
        <span class="name">model</span>: <span class="name">feedModel</span>
        <span class="name">footer</span>: <span class="name">footerText</span>
        <span class="name">delegate</span>: <span class="name">NewsDelegate</span> {}
    }</pre>
<p>To list the news items below the category list in portrait orientation and to its right in landscape orientation, we use the <code>isPortrait</code> custom property to anchor the top of the news items list to the left of <code>window</code> and bottom of <code>categories</code> in portrait orientation and to the right of <code>categories</code> and bottom of <code>window</code> in landscape orientation.</p>
<p>We use the <code>anchors.bottom</code> property to anchor the bottom of the list view to the bottom of the window in both orientations.</p>
<p>In portrait orientation, we clip the painting of the news items to the bounding rectangle of the list view to avoid graphical artifacts when news items are scrolled over other items. In landscape, this is not required, because the list spans the entire screen vertically.</p>
<p>We use the <code>model</code> property to load XML data from the <code>feedModel</code> model, and use <code>NewsDelegate</code> as the delegate to instantiate each item in the list.</p>
<p>In NewsDelegate.qml, we use a <a href="qtquick-positioning-layouts.html#column">Column</a> type to lay out the XML data:</p>
<pre class="qml"><span class="type"><a href="qml-qtquick-column.html">Column</a></span> {
    <span class="name">id</span>: <span class="name">delegate</span>
    <span class="name">width</span>: <span class="name">delegate</span>.<span class="name">ListView</span>.<span class="name">view</span>.<span class="name">width</span>
    <span class="name">spacing</span>: <span class="number">8</span></pre>
<p>Within the column, we use a <a href="qtquick-positioning-layouts.html#row">Row</a> and another column to position images and title text:</p>
<pre class="qml">    <span class="type"><a href="qml-qtquick-row.html">Row</a></span> {
        <span class="name">width</span>: <span class="name">parent</span>.<span class="name">width</span>
        <span class="name">spacing</span>: <span class="number">8</span>

        <span class="type"><a href="qml-qtquick-column.html">Column</a></span> {
            <span class="type"><a href="qml-qtquick-item.html">Item</a></span> {
                <span class="name">width</span>: <span class="number">4</span>
                <span class="name">height</span>: <span class="name">titleText</span>.<span class="name">font</span>.<span class="name">pixelSize</span> <span class="operator">/</span> <span class="number">4</span>
            }

            <span class="type"><a href="qml-qtquick-image.html">Image</a></span> {
                <span class="name">id</span>: <span class="name">titleImage</span>
                <span class="name">source</span>: <span class="name">image</span>
            }
        }

        <span class="type"><a href="qml-qtquick-text.html">Text</a></span> {
            <span class="name">id</span>: <span class="name">titleText</span>

            <span class="name">text</span>: <span class="name">title</span>
            <span class="name">width</span>: <span class="name">delegate</span>.<span class="name">width</span> <span class="operator">-</span> <span class="name">titleImage</span>.<span class="name">width</span>
            <span class="name">wrapMode</span>: <span class="name">Text</span>.<span class="name">WordWrap</span>
            <span class="name">font</span>.pixelSize: <span class="number">26</span>
            <span class="name">font</span>.bold: <span class="number">true</span>
        }
    }</pre>
<p>We generate a textual representation of how long ago the item was posted using the <code>timeSinceEvent()</code> JavaScript function:</p>
<pre class="qml">    <span class="type"><a href="qml-qtquick-text.html">Text</a></span> {
        <span class="name">width</span>: <span class="name">delegate</span>.<span class="name">width</span>
        <span class="name">font</span>.pixelSize: <span class="number">12</span>
        <span class="name">textFormat</span>: <span class="name">Text</span>.<span class="name">RichText</span>
        <span class="name">font</span>.italic: <span class="number">true</span>
        <span class="name">text</span>: <span class="name">timeSinceEvent</span>(<span class="name">pubDate</span>) <span class="operator">+</span> <span class="string">&quot; (&lt;a href=\&quot;&quot;</span> <span class="operator">+</span> <span class="name">link</span> <span class="operator">+</span> <span class="string">&quot;\&quot;&gt;Link&lt;/a&gt;)&quot;</span>
        <span class="name">onLinkActivated</span>: {
            <span class="name">Qt</span>.<span class="name">openUrlExternally</span>(<span class="name">link</span>)
        }
    }</pre>
<p>We use the <code>onLinkActivated</code> signal handler to open the URL in an external browser when users select the link.</p>
<a name="providing-feedback-to-users"></a>
<h2 id="providing-feedback-to-users">Providing Feedback to Users</h2>
<p>In CategoryDelegate.qml, we use the <code>BusyIndicator</code> custom type to indicate activity while the XML data is being loaded:</p>
<pre class="qml">    <span class="type">BusyIndicator</span> {
        <span class="name">scale</span>: <span class="number">0.8</span>
        <span class="name">visible</span>: <span class="name">delegate</span>.<span class="name">ListView</span>.<span class="name">isCurrentItem</span> <span class="operator">&amp;&amp;</span> <span class="name">window</span>.<span class="name">loading</span>
        <span class="name">anchors</span>.centerIn: <span class="name">parent</span>
    }</pre>
<p>We use the <code>scale</code> property to reduce the indicator size to <code>0.8</code>. We bind the <code>visible</code> property to the <code>isCurrentItem</code> attached property of the <code>delegate</code> list view and <code>loading</code> property of the main window to display the indicator image when a category list item is the current item and XML data is being loaded.</p>
<p>We define the <code>BusyIndicator</code> type in <code>BusyIndicator.qml</code>. We use an <a href="qtquick-imageelements-example.html#image">Image</a> type to display an image and apply a <a href="qml-qtquick-numberanimation.html">NumberAnimation</a> to its <code>rotation</code> property to rotate the image in an infinite loop:</p>
<pre class="qml"><span class="type"><a href="qml-qtquick-image.html">Image</a></span> {
    <span class="name">id</span>: <span class="name">container</span>

    <span class="name">source</span>: <span class="string">&quot;images/busy.png&quot;</span>;

    NumberAnimation on <span class="name">rotation</span> {
        <span class="name">running</span>: <span class="name">container</span>.<span class="name">visible</span>
        <span class="name">from</span>: <span class="number">0</span>; <span class="name">to</span>: <span class="number">360</span>;
        <span class="name">loops</span>: <span class="name">Animation</span>.<span class="name">Infinite</span>;
        <span class="name">duration</span>: <span class="number">1200</span>
    }
}</pre>
<p>In your apps, you can also use the BusyIndicator type from the Qt Quick Controls module.</p>
<a name="creating-scroll-bars"></a>
<h2 id="creating-scroll-bars">Creating Scroll Bars</h2>
<p>In rssnews.qml, we use our own custom <code>ScrollBar</code> type to create scroll bars in the category and news item list views. In your apps, you can also use the ScrollView type from the Qt Quick Controls module.</p>
<p>First, we create a scroll bar in the category list view. We bind the <code>orientation</code> property to the <code>isPortrait</code> property and to the <code>Horizontal</code> value of the <code>Qt::Orientation</code> enum type to display a horizontal scroll bar in portrait orientation and to the <code>Vertical</code> value to display a vertical scroll bar in landscape orientation:</p>
<pre class="qml">    <span class="type">ScrollBar</span> {
        <span class="name">id</span>: <span class="name">listScrollBar</span>

        <span class="name">orientation</span>: <span class="name">isPortrait</span> ? <span class="name">Qt</span>.<span class="name">Horizontal</span> : <span class="name">Qt</span>.<span class="name">Vertical</span>
        <span class="name">height</span>: <span class="name">isPortrait</span> ? <span class="number">8</span> : <span class="name">categories</span>.<span class="name">height</span>;
        <span class="name">width</span>: <span class="name">isPortrait</span> ? <span class="name">categories</span>.<span class="name">width</span> : <span class="number">8</span>
        <span class="name">scrollArea</span>: <span class="name">categories</span>;
        <span class="name">anchors</span>.right: <span class="name">categories</span>.<span class="name">right</span>
    }</pre>
<p>Same as with the <code>categories</code> list view, we adjust the width and height of the scroll bar based on the <code>isPortrait</code> property.</p>
<p>We use the <code>scrollArea</code> property to display the scroll bar in the <code>categories</code> list view.</p>
<p>We use the <code>anchors.right</code> property to anchor the scroll bar to the right side of the category list.</p>
<pre class="qml">    <span class="type">ScrollBar</span> {
        <span class="name">scrollArea</span>: <span class="name">list</span>
        <span class="name">width</span>: <span class="number">8</span>
        <span class="name">anchors</span>.right: <span class="name">window</span>.<span class="name">right</span>
        <span class="name">anchors</span>.top: <span class="name">isPortrait</span> ? <span class="name">categories</span>.<span class="name">bottom</span> : <span class="name">window</span>.<span class="name">top</span>
        <span class="name">anchors</span>.bottom: <span class="name">window</span>.<span class="name">bottom</span>
    }</pre>
<p>Second, we create another scroll bar in the news item list view. We want a vertical scroll bar to appear on the right side of the view regardless of screen orientation, so we can set the <code>width</code> property to <code>8</code> and bind the <code>anchors.right</code> property to the <code>window.right</code> property. We use the <code>anchors.top</code> property to anchor the scroll bar top to the bottom of the category list in portrait orientation and to the top of the news item list in landscape orientation. We use the <code>anchors.bottom</code> property to anchor the scroll bar bottom to the list view bottom in both orientations.</p>
<p>We define the <code>ScrollBar</code> type in <code>ScrollBar.qml</code>. We use an <a href="qml-qtquick-item.html">Item</a> type with custom properties to create a container for the scroll bar:</p>
<pre class="qml"><span class="type"><a href="qml-qtquick-item.html">Item</a></span> {
    <span class="name">id</span>: <span class="name">container</span>

    property <span class="type">variant</span> <span class="name">scrollArea</span>
    property <span class="type">int</span> <span class="name">orientation</span>: <span class="name">Qt</span>.<span class="name">Vertical</span>

    <span class="name">opacity</span>: <span class="number">0</span></pre>
<p>We use a <a href="qtquick-imageelements-example.html#borderimage">BorderImage</a> type to display the scroll bar thumb at the x and y position that we calculate by using the <code>position()</code> function:</p>
<pre class="qml">    <span class="type"><a href="qml-qtquick-borderimage.html">BorderImage</a></span> {
        <span class="name">source</span>: <span class="string">&quot;images/scrollbar.png&quot;</span>
        <span class="type">border</span> { <span class="name">left</span>: <span class="number">1</span>; <span class="name">right</span>: <span class="number">1</span>; <span class="name">top</span>: <span class="number">1</span>; <span class="name">bottom</span>: <span class="number">1</span> }
        <span class="name">x</span>: <span class="name">container</span>.<span class="name">orientation</span> <span class="operator">==</span> <span class="name">Qt</span>.<span class="name">Vertical</span> ? <span class="number">2</span> : <span class="name">position</span>()
        <span class="name">y</span>: <span class="name">container</span>.<span class="name">orientation</span> <span class="operator">==</span> <span class="name">Qt</span>.<span class="name">Vertical</span> ? <span class="name">position</span>() : <span class="number">2</span>
        <span class="name">width</span>: <span class="name">container</span>.<span class="name">orientation</span> <span class="operator">==</span> <span class="name">Qt</span>.<span class="name">Vertical</span> ? <span class="name">container</span>.<span class="name">width</span> <span class="operator">-</span> <span class="number">4</span> : <span class="name">size</span>()
        <span class="name">height</span>: <span class="name">container</span>.<span class="name">orientation</span> <span class="operator">==</span> <span class="name">Qt</span>.<span class="name">Vertical</span> ? <span class="name">size</span>() : <span class="name">container</span>.<span class="name">height</span> <span class="operator">-</span> <span class="number">4</span>
    }</pre>
<p>We use the <code>size</code> function to calculate the thumb width and height depending on the screen orientation.</p>
<p>We use <code>states</code> to make the scroll bar visible when the users move the scroll area:</p>
<pre class="qml">    <span class="name">states</span>: <span class="name">State</span> {
        <span class="name">name</span>: <span class="string">&quot;visible&quot;</span>
        <span class="name">when</span>: <span class="name">container</span>.<span class="name">orientation</span> <span class="operator">==</span> <span class="name">Qt</span>.<span class="name">Vertical</span> ?
                  <span class="name">scrollArea</span>.<span class="name">movingVertically</span> :
                  <span class="name">scrollArea</span>.<span class="name">movingHorizontally</span>
        <span class="type"><a href="qml-qtquick-propertychanges.html">PropertyChanges</a></span> { <span class="name">target</span>: <span class="name">container</span>; <span class="name">opacity</span>: <span class="number">1.0</span> }
    }</pre>
<p>We use <code>transitions</code> to apply a <a href="qml-qtquick-numberanimation.html">NumberAnimation</a> to the <code>&quot;opacity&quot;</code> property when the state changes from &quot;visible&quot; to the default state:</p>
<pre class="qml">    <span class="name">transitions</span>: <span class="name">Transition</span> {
        <span class="name">from</span>: <span class="string">&quot;visible&quot;</span>; <span class="name">to</span>: <span class="string">&quot;&quot;</span>
        <span class="type"><a href="qml-qtquick-numberanimation.html">NumberAnimation</a></span> { <span class="name">properties</span>: <span class="string">&quot;opacity&quot;</span>; <span class="name">duration</span>: <span class="number">600</span> }
    }
}</pre>
<a name="creating-footers"></a>
<h2 id="creating-footers">Creating Footers</h2>
<p>In rssnews.qml, we use a Component type with a <a href="qml-qtquick-rectangle.html">Rectangle</a> type to create a footer for the news list view:</p>
<pre class="qml">    <span class="type">Component</span> {
        <span class="name">id</span>: <span class="name">footerText</span>

        <span class="type"><a href="qml-qtquick-rectangle.html">Rectangle</a></span> {
            <span class="name">width</span>: <span class="name">parent</span>.<span class="name">width</span>
            <span class="name">height</span>: <span class="name">closeButton</span>.<span class="name">height</span>
            <span class="name">color</span>: <span class="string">&quot;lightgray&quot;</span>

            <span class="type"><a href="qml-qtquick-text.html">Text</a></span> {
                <span class="name">text</span>: <span class="string">&quot;RSS Feed from Yahoo News&quot;</span>
                <span class="name">anchors</span>.centerIn: <span class="name">parent</span>
                <span class="name">font</span>.pixelSize: <span class="number">14</span>
            }
        }
    }</pre>
<p>We bind the <code>width</code> of the footer to the width of the component and the <code>height</code> to the of close button to align them when no news items are displayed.</p>
<a name="creating-buttons"></a>
<h2 id="creating-buttons">Creating Buttons</h2>
<p>In rssnews.qml, we use an <a href="qtquick-imageelements-example.html#image">Image</a> type to create a simple push button that users can tap to close the app:</p>
<pre class="qml">    <span class="type"><a href="qml-qtquick-image.html">Image</a></span> {
        <span class="name">id</span>: <span class="name">closeButton</span>
        <span class="name">source</span>: <span class="string">&quot;content/images/btn_close.png&quot;</span>
        <span class="name">scale</span>: <span class="number">0.8</span>
        <span class="name">anchors</span>.top: <span class="name">parent</span>.<span class="name">top</span>
        <span class="name">anchors</span>.right: <span class="name">parent</span>.<span class="name">right</span>
        <span class="name">anchors</span>.margins: <span class="number">4</span>
        <span class="name">opacity</span>: (<span class="name">isPortrait</span> <span class="operator">&amp;&amp;</span> <span class="name">categories</span>.<span class="name">moving</span>) ? <span class="number">0.2</span> : <span class="number">1.0</span>
        Behavior on <span class="name">opacity</span> {
            <span class="type"><a href="qml-qtquick-numberanimation.html">NumberAnimation</a></span> { <span class="name">duration</span>: <span class="number">300</span>; <span class="name">easing</span>.type: <span class="name">Easing</span>.<span class="name">OutSine</span> }
        }

        <span class="type"><a href="qml-qtquick-mousearea.html">MouseArea</a></span> {
            <span class="name">anchors</span>.fill: <span class="name">parent</span>
            <span class="name">onClicked</span>: {
                <span class="name">Qt</span>.<span class="name">quit</span>()
            }
        }
    }</pre>
<p>We use <code>anchors</code> to position the close button in the top right corner of the news list view, with 4-pixel margins. Because the close button overlaps the category list in portrait orientation, we animate the <code>opacity</code> property to make the button almost fully transparent when users are scrolling the category list.</p>
<p>We use the <code>onClicked</code> signal handler within a <a href="qml-qtquick-mousearea.html">MouseArea</a> to call the <code>quit()</code> function when users select the close button.</p>
<p>Files:</p>
<ul>
<li><a href="qtquick-demos-rssnews-rssnews-qml.html">demos/rssnews/rssnews.qml</a></li>
<li><a href="qtquick-demos-rssnews-content-busyindicator-qml.html">demos/rssnews/content/BusyIndicator.qml</a></li>
<li><a href="qtquick-demos-rssnews-content-categorydelegate-qml.html">demos/rssnews/content/CategoryDelegate.qml</a></li>
<li><a href="qtquick-demos-rssnews-content-newsdelegate-qml.html">demos/rssnews/content/NewsDelegate.qml</a></li>
<li><a href="qtquick-demos-rssnews-content-rssfeeds-qml.html">demos/rssnews/content/RssFeeds.qml</a></li>
<li><a href="qtquick-demos-rssnews-content-scrollbar-qml.html">demos/rssnews/content/ScrollBar.qml</a></li>
<li><a href="qtquick-demos-rssnews-main-cpp.html">demos/rssnews/main.cpp</a></li>
<li><a href="qtquick-demos-rssnews-rssnews-pro.html">demos/rssnews/rssnews.pro</a></li>
<li><a href="qtquick-demos-rssnews-rssnews-qmlproject.html">demos/rssnews/rssnews.qmlproject</a></li>
<li><a href="qtquick-demos-rssnews-rssnews-qrc.html">demos/rssnews/rssnews.qrc</a></li>
</ul>
</div>
<p><b>See also </b>QML Applications.</p>
<!-- @@@demos/rssnews -->
        </div>
       </div>
   </div>
   </div>
</div>
<div class="footer">
   <p>
   <acronym title="Copyright">&copy;</acronym> 2015 The Qt Company Ltd.
   Documentation contributions included herein are the copyrights of
   their respective owners.<br>    The documentation provided herein is licensed under the terms of the    <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation    License version 1.3</a> as published by the Free Software Foundation.<br>    Qt and respective logos are trademarks of The Qt Company Ltd.     in Finland and/or other countries worldwide. All other trademarks are property
   of their respective owners. </p>
</div>
</body>
</html>