Doc: Various fixes to documentation, some based on changes in master.
[profile/ivi/qtdeclarative.git] / doc / src / declarative / whatsnew.qdoc
1 /****************************************************************************
2 **
3 ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
4 ** All rights reserved.
5 ** Contact: Nokia Corporation (qt-info@nokia.com)
6 **
7 ** This file is part of the documentation of the Qt Toolkit.
8 **
9 ** $QT_BEGIN_LICENSE:FDL$
10 ** No Commercial Usage
11 ** This file contains pre-release code and may not be distributed.
12 ** You may use this file in accordance with the terms and conditions
13 ** contained in the Technology Preview License Agreement accompanying
14 ** this package.
15 **
16 ** GNU Free Documentation License
17 ** Alternatively, this file may be used under the terms of the GNU Free
18 ** Documentation License version 1.3 as published by the Free Software
19 ** Foundation and appearing in the file included in the packaging of this
20 ** file.
21 **
22 ** If you have questions regarding the use of this file, please contact
23 ** Nokia at qt-info@nokia.com.
24 ** $QT_END_LICENSE$
25 **
26 ****************************************************************************/
27
28 /*!
29 \title What's New in Qt Quick
30 \page qtquick-whatsnew.html
31
32 \section1 Qt 4.7.4 includes QtQuick 1.1
33
34 QtQuick 1.1 is a minor feature update.  \e {import QtQuick 1.1} to use the new
35 features.
36
37 \section2 PinchArea
38
39 PinchArea provides support for the common two finger pinch gesture.
40
41 \section2 LayoutMirroring attached property
42
43 \l {LayoutMirroring}{Layout mirroring} is useful when you need to support both
44 left-to-right and right-to-left layout versions of your application that target
45 different language areas.
46
47 \section2 Anchors
48
49 Added the following property:
50 \list
51 \o \l {Item::}{anchors.mirrored}
52 \endlist
53
54 \section2 Text
55
56 Added the following properties:
57 \list
58 \o \l {Text::}{lineHeight}
59 \o \l {Text::}{lineHeightMode}
60 \o \l {Text::}{lineCount}
61 \o \l {Text::}{maximumLineCount}
62 \o \l {Text::}{truncated}
63 \o \l {Text::}{effectiveHorizontalAlignment}
64 \endlist
65
66 horizontalAlignment now accepts Text.AlignJustify alignment mode.
67
68 \section2 TextEdit
69
70 Added the following properties, methods and signal handlers:
71 \list
72 \o \l {TextEdit::}{canPaste}
73 \o \l {TextEdit::}{lineCount}
74 \o \l {TextEdit::}{inputMethodComposing}
75 \o \l {TextEdit::}{mouseSelectionMode}
76 \o \l {TextEdit::}{effectiveHorizontalAlignment}
77 \o \l {TextEdit::}{deselect()}
78 \o \l {TextEdit::}{isRightToLeft()}
79 \o \l {TextEdit::}{moveCursorSelection()} to enable selection by word
80 \o \l {TextEdit::}{onLinkActivated}
81 \endlist
82
83 \section2 TextInput
84
85 Added the following properties and methods:
86 \list
87 \o \l {TextInput::}{canPaste}
88 \o \l {TextInput::}{inputMethodComposing}
89 \o \l {TextInput::}{mouseSelectionMode}
90 \o \l {TextInput::}{effectiveHorizontalAlignment}
91 \o \l {TextInput::}{deselect()}
92 \o \l {TextInput::}{isRightToLeft()}
93 \o \l {TextInput::}{moveCursorSelection()} to enable selection by word
94 \endlist
95
96 \section2 Image, BorderImage and AnimatedImage
97
98 Added the following properties:
99 \list
100 \o \l{Image::}{cache}
101 \o \l{Image::}{mirror}
102 \endlist
103
104 \section2 Item
105
106 Added the following properties:
107 \list
108 \o \l{Item::}{implicitWidth} and \l{Item::}{implicitHeight}
109 \endlist
110
111 \section2 Flickable
112
113 Added the following methods:
114 \list
115 \o \l{Flickable::}{resizeContent()}
116 \o \l{Flickable::}{returnToBounds()}
117 \endlist
118
119 \section2 MouseArea
120
121 Added the following property:
122 \list
123 \o \l{MouseArea::}{preventStealing}
124 \endlist
125
126 \section2 ListView and GridView
127
128 Added the following properties and methods:
129 \list
130 \o \l{ListView::}{layoutDirection}
131 \o \l{ListView::}{effectiveLayoutDirection}
132 \o \l{ListView::}{positionViewAtBeginning()}
133 \o \l{ListView::}{positionViewAtEnd()}
134 \endlist
135
136 \section2 Flow, Grid and Row
137
138 Added the following properties:
139 \list
140 \o \l{Flow::}{layoutDirection}
141 \o \l{Flow::}{effectiveLayoutDirection}
142 \endlist
143
144 \section2 Repeater
145
146 Added the following methods and signal handlers:
147 \list
148 \o \l{Repeater::}{onItemAdded}
149 \o \l{Repeater::}{onItemRemoved}
150 \o \l{Repeater::}{itemAt()}
151 \endlist
152
153 \section2 Component
154
155 \list
156 \o The \l{Component::}{createObject()} method now accepts a map of initial
157 property values for the created object.
158 \endlist
159
160 \section2 Qt
161
162 \list
163 \o Added the \l {QML:Qt::application}{Qt.application} object to hold generic
164 global application properties.
165 \endlist
166
167 \section2 Other changes
168
169 \list
170 \o Functions can be \l{Property Binding#Property Binding}{assigned to properties from JavaScript}
171 to create property bindings.
172 \o QtQuick now supports Right to Left layout in positioners, views, anchors and text elements.
173 \endlist
174
175
176 \section1 Qt 4.7.1
177
178 \section2 QtQuick namespace
179
180 In prior Qt releases, all the Qt Quick elements were available in the \e Qt
181 namespace. Starting with Qt 4.7.1, the elements are also available in the
182 \e QtQuick namespace, which improves naming consistency, and allows the
183 development of Qt Quick to occur at a faster rate than Qt's usual minor release
184 schedule.
185
186 The change for developers is very simple - where you previously wrote
187 \e {import Qt 4.7}, just replace it with \e {import QtQuick 1.0}, like this:
188
189 \code
190 import QtQuick 1.0 
191
192 Text {
193     text: "Welcome to QtQuick 1.0!"
194 }
195 \endcode
196
197 \e {import Qt 4.7} continues to work so existing applications won't break even
198 if they aren't updated, but it is recommended that all import statements be
199 modified to the new form.
200 */