Initial import from the monolithic Qt.
[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 features.
35
36 \section2 PinchArea
37
38 PinchArea provides support for the common two finger pinch gesture.
39
40 \section2 LayoutMirroring attached property
41
42 \l {LayoutMirroring}{Layout mirroring} is useful when you need to support both left-to-right and right-to-left layout versions of your application that target different language areas.
43
44 \section2 Anchors
45
46 Added the following property:
47 \list
48 \o \l {Item::}{anchors.mirrored}
49 \endlist
50
51 \section2 Text
52
53 Added the following properties:
54 \list
55 \o \l {Text::}{lineHeight}
56 \o \l {Text::}{lineHeightMode}
57 \o \l {Text::}{lineCount}
58 \o \l {Text::}{maximumLineCount}
59 \o \l {Text::}{truncated}
60 \o \l {Text::}{effectiveHorizontalAlignment}
61 \endlist
62
63 horizontalAlignment now accepts Text.AlignJustify alignment mode.
64
65 \section2 TextEdit
66
67 Added the following properties, methods and signal handlers:
68 \list
69 \o \l {TextEdit::}{canPaste}
70 \o \l {TextEdit::}{lineCount}
71 \o \l {TextEdit::}{inputMethodComposing}
72 \o \l {TextEdit::}{mouseSelectionMode}
73 \o \l {TextEdit::}{effectiveHorizontalAlignment}
74 \o \l {TextEdit::}{deselect()}
75 \o \l {TextEdit::}{isRightToLeft()}
76 \o \l {TextEdit::}{moveCursorSelection()} to enable selection by word
77 \o \l {TextEdit::}{onLinkActivated}
78 \endlist
79
80 \section2 TextInput
81
82 Added the following properties and methods:
83 \list
84 \o \l {TextInput::}{canPaste}
85 \o \l {TextInput::}{inputMethodComposing}
86 \o \l {TextInput::}{mouseSelectionMode}
87 \o \l {TextInput::}{effectiveHorizontalAlignment}
88 \o \l {TextInput::}{deselect()}
89 \o \l {TextInput::}{isRightToLeft()}
90 \o \l {TextInput::}{moveCursorSelection()} to enable selection by word
91 \endlist
92
93 \section2 Image, BorderImage and AnimatedImage
94
95 Added the following properties:
96 \list
97 \o \l{Image::}{cache}
98 \o \l{Image::}{mirror}
99 \endlist
100
101 \section2 Item
102
103 Added the following properties:
104 \list
105 \o \l{Item::}{implicitWidth} and \l{Item::}{implicitHeight}
106 \endlist
107
108 \section2 Flickable
109
110 Added the following methods:
111 \list
112 \o \l{Flickable::}{resizeContent()}
113 \o \l{Flickable::}{returnToBounds()}
114 \endlist
115
116 \section2 MouseArea
117
118 Added the following property:
119 \list
120 \o \l{MouseArea::}{preventStealing}
121 \endlist
122
123 \section2 ListView and GridView
124
125 Added the following properties and methods:
126 \list
127 \o \l{ListView::}{layoutDirection}
128 \o \l{ListView::}{effectiveLayoutDirection}
129 \o \l{ListView::}{positionViewAtBeginning()}
130 \o \l{ListView::}{positionViewAtEnd()}
131 \endlist
132
133 \section2 Flow, Grid and Row
134
135 Added the following properties:
136 \list
137 \o \l{Flow::}{layoutDirection}
138 \o \l{Flow::}{effectiveLayoutDirection}
139 \endlist
140
141 \section2 Repeater
142
143 Added the following methods and signal handlers:
144 \list
145 \o \l{Repeater::}{onItemAdded}
146 \o \l{Repeater::}{onItemRemoved}
147 \o \l{Repeater::}{itemAt()}
148 \endlist
149
150 \section2 Component
151
152 \list
153 \o The \l{Component::}{createObject()} method now accepts a map of initial property values for
154 the created object.
155 \endlist
156
157 \section2 Qt
158
159 \list
160 \o Added the \l {QML:Qt::application}{Qt.application} object to hold generic global application
161 properties.
162 \endlist
163
164 \section2 Other changes
165
166 \list
167 \o Functions can be \l{Binding Properties from JavaScript}{assigned to properties from JavaScript}
168 to create property bindings.
169 \o QtQuick now supports Right to Left layout in positioners, views, anchors and text elements.
170 \endlist
171
172
173 \section1 Qt 4.7.1
174
175 \section2 QtQuick namespace
176
177 In prior Qt releases, all the Qt Quick elements were available in the \e Qt namespace.  
178 Starting with Qt 4.7.1, the elements are also available in the \e QtQuick namespace, 
179 which improves naming consistency, and allows the development of Qt Quick to occur at 
180 a faster rate than Qt's usual minor release schedule.
181
182 The change for developers is very simple - where you previously wrote \e {import Qt 4.7},
183 just replace it with \e {import QtQuick 1.0}, like this:
184
185 \code
186 import QtQuick 1.0 
187
188 Text {
189     text: "Welcome to QtQuick 1.0!"
190 }
191 \endcode
192
193 \e {import Qt 4.7} continues to work so existing applications wont break even if they 
194 aren't updated, but it is recommended that all import statements be modified to the new 
195 form.
196 */