aboutsummaryrefslogtreecommitdiffstats
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* Document toys examplesAlan Alpert2012-01-205-0/+71
| | | | | Change-Id: I376c4169ffff19e06b55e578e57101a476500b04 Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Doc: Improve Qt.locale docs.Martin Jones2012-01-201-4/+45
| | | | | Change-Id: I3ef5c4a0bedbaa346b001852bba8e9ff9347e9e0 Reviewed-by: Andrew den Exter <andrew.den-exter@nokia.com>
* Doc: fix QML Examples linkMartin Jones2012-01-171-1/+1
| | | | | Change-Id: Id4637a7953f05ee9eac712116f68218a0c8b9ff9 Reviewed-by: Bea Lam <bea.lam@nokia.com>
* Update copyright year in Nokia copyright headers.Jason McDonald2012-01-1728-28/+28
| | | | | | | | Update copyright headers from before 2011, and a couple of new ones that were merged after the previous change to copyright headers. Change-Id: Ia76e08e2734afa4ef3f1207dbcda5ff3bc81b366 Reviewed-by: Rohan McGovern <rohan.mcgovern@nokia.com>
* Console API: Add console.infoKai Koehne2012-01-161-1/+1
| | | | | | | | Add console.info for the sake of completeness. It's mapped to qDebug(), just like console.log, console.debug, print. Change-Id: Ife1cfbfe810d4e5e9175343778dff734a56f4a80 Reviewed-by: Aurindam Jana <aurindam.jana@nokia.com>
* Adapt to QInputPanel::inputDirection() APIPekka Vuorela2012-01-122-2/+2
| | | | | | | Information moved from QGuiApplication into QInputPanel. Change-Id: Idd80609f4b67bffae7222a1fa27918724ebf60f6 Reviewed-by: Joona Petrell <joona.t.petrell@nokia.com>
* Update copyright year in license headers.Jason McDonald2012-01-05459-457/+457
| | | | | Change-Id: I0a8d99909cac867dce72da70b1bbcb649989a51b Reviewed-by: Rohan McGovern <rohan.mcgovern@nokia.com>
* Document new Path elements.Michael Brasser2012-01-0513-0/+285
| | | | | Change-Id: Ic1e2aa7da63a7d9e12357a609fc52b3913f14f28 Reviewed-by: Bea Lam <bea.lam@nokia.com>
* Document qmlRegisterRevision()Martin Jones2012-01-052-9/+47
| | | | | | | Task-number: QTBUG-22688 Change-Id: I8a6610951dc8320d9872e971ac2d1d86508b8faf Reviewed-by: Michael Brasser <michael.brasser@nokia.com>
* Add accessibility to qmlFrederik Gladhorn2012-01-022-0/+6
| | | | | | | | | | | | | | | This consists of two parts: An attached property for QML items and a plugin for the accessibility framework. The attached property simply takes care of some properties (name, role) that are needed in order to expose semantics of the application to assistive tools. The plugin exposes the hierarchy of QML items to the accessibility framework. Change-Id: I32f5603d0d9549b01b3645b205b710b9801762f7 Reviewed-by: Jan-Arve Sæther <jan-arve.saether@nokia.com>
* Add wrapMode and verticalAlignment properties to TextInput.Andrew den Exter2011-12-201-0/+3
| | | | | | | | | | | | Wrap mode provides an alternative to horizontal scrolling when the width of the text exceeds the width of the TextInput. With auto scroll wrapping introdoces an implicit verticalAlignment so support setting it explicitly as well. Task-number: QTBUG-22305 Task-number: QTBUG-16203 Change-Id: I1bd3a5335edb3ac48df3d5ccd8ae7274caa91883 Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Update the performance-tips documentationChris Adams2011-12-201-49/+645
| | | | | | | | | | | Improvements to the JavaScript integration in QML means that developers must be aware of some different performance related concerns. This commit also adds some performance tips for other elements and use-cases in QML. Change-Id: Ia72f8c7ab275d3ff879fa195d59ecab102ca1f86 Reviewed-by: Alan Alpert <alan.alpert@nokia.com> Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Console APIs: Update documentation in QDeclarativeAurindam Jana2011-12-161-8/+41
| | | | | | | Change-Id: Ieb3887f128987c009d39071dd20e68f9e4fe6bc7 Reviewed-by: Kai Koehne <kai.koehne@nokia.com> Reviewed-by: Peter Yard <peter.yard@nokia.com> Reviewed-by: Jerome Pasion <jerome.pasion@nokia.com>
* Make PlainText the default textFormat of a TextEdit.Andrew den Exter2011-12-161-0/+3
| | | | | | | | | | | With AutoText as the default it's easy to assume that a TextEdit accepts plain text or rich text only which can lead to unexpected behaviour when user supplied text is does not have the expected formatting and implicitly changes the text format. Task-number: QTBUG-23109 Change-Id: I08900fb23545672fd0e181058633bafeb826a746 Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Add a tutorial describing how to re-arrange items in a ListView.Andrew den Exter2011-12-142-1/+255
| | | | | | | | This example describes both how to use drag and drop to re-order items and how to use VisualDataGroup to sort a view using model data. Change-Id: I034963ea87c8ab0c30555536ac28495a396c0577 Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Update whatsnew doc with JavaScript improvementsChris Adams2011-12-081-1/+8
| | | | | | | | | | Several JavaScript integration improvements were made recently: - sequence support - "var" properties - improved scarce resource support Change-Id: Id9f47d14c961397d970e306eac2bec5d3e55cab3 Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Move snippets to separate test in the examples testcaseAlan Alpert2011-12-071-0/+3
| | | | | | | | | This test filters out warning messages, so as to not clutter the logs. Also altered an example so that v8 doesn't spit out a warning message. Change-Id: I89ab9f1c12bee6cea88e06ce5bf98f2f69a13559 Reviewed-by: Aaron Kennedy <aaron.kennedy@nokia.com>
* Ensure that scarce resources work with var propertiesChris Adams2011-12-0611-136/+624
| | | | | | | | | | Now that we have a new property type which stores JavaScript handles, we need to ensure that scarce resources can be used with them. Task-number: QMLNG-18 Task-number: QTBUG-21843 Change-Id: I4a920ae39e7d33cf5e33362e5e0ee21c74cb35e3 Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Document function limitation of var propertiesChris Adams2011-12-061-2/+7
| | | | | | | | | | | Functions cannot be assigned to var properties due to the fact that such an assignment signifies a binding assignment. This limitation needs to be documented. One workaround is to assign an array which contains a function element to a var property, and this commit also adds a unit test to ensure this works. Change-Id: I02363b88233282106ac6d26f14df1988155057b9 Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Say hello to QtQuick moduleKent Hansen2011-12-021-0/+52
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This change moves the QtQuick 2 types and C++ API (including SceneGraph) to a new module (AKA library), QtQuick. 99% of this change is moving files from src/declarative to src/quick, and from tests/auto/declarative to tests/auto/qtquick2. The loading of QtQuick 2 ("import QtQuick 2.0") is now delegated to a plugin, src/imports/qtquick2, just like it's done for QtQuick 1. All tools, examples, and tests that use QtQuick C++ API have gotten "QT += quick" or "QT += quick-private" added to their .pro file. A few additional internal QtDeclarative classes had to be exported (via Q_DECLARATIVE_PRIVATE_EXPORT) since they're needed by the QtQuick 2 implementation. The old header locations (e.g. QtDeclarative/qquickitem.h) will still be supported for some time, but will produce compile-time warnings. (To avoid the QtQuick implementation using the compatibility headers (since QtDeclarative's includepath comes first), a few include statements were modified, e.g. from "#include <qsgnode.h>" to "#include <QtQuick/qsgnode.h>".) There's a change in qtbase that automatically adds QtQuick to the module list if QtDeclarative is used. Together with the compatibility headers, this should help reduce the migration pain for existing projects. In theory, simply getting an existing QtDeclarative-based project to compile and link shouldn't require any changes for now -- but porting to the new scheme is of course recommended, and will eventually become mandatory. Task-number: QTBUG-22889 Reviewed-by: Lars Knoll <lars.knoll@nokia.com> Change-Id: Ia52be9373172ba2f37e7623231ecb060316c96a7 Reviewed-by: Kent Hansen <kent.hansen@nokia.com> Reviewed-by: Sergio Ahumada <sergio.ahumada@nokia.com>
* Move XmlListModel to seperate pluginCharles Yin2011-12-012-0/+5
| | | | | | | | | | | | | XmlListModel is the only feature inside QtDeclarative which depends on the QtXmlPatterns module, move this item to a separate plugin can reduce the unnecessary dependency in most use cases. To use the new XmlListModel, an additional "import QtQuick.xmllistmodel 2.0" is needed. Task-number:QTBUG-22158 Change-Id: I9e19eb6cbba46cd40fb7ffcdbd741f346779a54d Reviewed-by: Yunqiao Yin <charles.yin@nokia.com>
* Add indexed deleter to sequence wrapper, implement length setterChris Adams2011-11-291-1/+22
| | | | | | | | | | | | | | | | | | Previously, elements could not be deleted from sequences directly without reassignment. This commit adds an indexed deleter which allows elements to be deleted by specifying an index. A deleted element will be replaced with a default-constructed element in the sequence (slight departure from ECMA262r3 which specifies that it should be replaced with Undefined). This commit also implements the length property setter according to the requirements on Array [[Put]] by ECMA262r3 which allows removal of elements from a sequence (required for proper behaviour of Array.prototype methods such as splice() and pop()). Task-number: QTBUG-22808 Change-Id: I62511b3edc2ec35f92d2a2bd719278e129c98547 Reviewed-by: Michael Brasser <michael.brasser@nokia.com>
* Explain the implications of QML versions a little moreAlan Alpert2011-11-281-2/+5
| | | | | Change-Id: I2b1667333a18daebba5224e210f219721096bc91 Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Qt.locale() and JS locale type extension.Martin Jones2011-11-225-5/+269
| | | | | | | Task-number: QTBUG-17129 Change-Id: I69cbbe858735b750b4e37ce489f2fa1ad5d8b5d3 Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Doc: cleanup list of QtQuick2 elementsMartin Jones2011-11-211-21/+6
| | | | | Change-Id: Ic07521e31870f5ecd544834c0839034578c62dcf Reviewed-by: Michael Brasser <michael.brasser@nokia.com>
* Stabilize testAlan Alpert2011-11-171-0/+4
| | | | | | | | | | Test failed in DST when JS and QDateTime DST methods conflict. The time in ms since epoch is still correct though, so test data is now within ranges where they do not conflict (only happens with historical data). Task-number: QTBUG-22408 Change-Id: I884e28b4681cc10fb25e777d2eabe20d8ac0bce4 Reviewed-by: Michael Brasser <michael.brasser@nokia.com>
* Add \inqmlmodule tags to the generic QtQuick module docsAlan Alpert2011-11-1699-0/+118
| | | | | Change-Id: If40907e44a0e54f8a9caaea2103eb3e5c9e541d3 Reviewed-by: Martin Smith <martin.smith@nokia.com>
* Add propagateComposedEvents property to MouseAreaAlan Alpert2011-11-151-2/+3
| | | | | | | | | While necessary, advanced event propagation isn't the common use case. Now needs to be explicitly enabled. Task-number: QTBUG-21081 Change-Id: Ibd8b4974934116dbfa32cc5e72037fd9b11015b4 Reviewed-by: Michael Brasser <michael.brasser@nokia.com>
* Get tst_examples passing againAlan Alpert2011-11-14151-152/+152
| | | | | | | | | | | | | | Shared QDeclarativeEngine sidesteps GC slowdown issue. New approach also verifies that the root object successfully loaded, this picks up all the cases where it did not successfully load before. Most of these were because they weren't importing QtQuick 2.0, import statements have been updated. One was because it does not create a QQuickItem root, it has been manually excluded. This required adding per file exclusions to the current directory exclusions. Change-Id: I809f0f20acc319aef58ba2e30e672e32f640686d Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Add console.time / console.timeEnd APIKai Koehne2011-11-092-1/+15
| | | | | | | | | Implement console.time() / console.timeEnd() as also provided by FireBug / Safari. Task-number: QTBUG-22347 Change-Id: I94fcadbb0c54fdf60dc2559e3ae63d613e29630b Reviewed-by: Michael Brasser <michael.brasser@nokia.com>
* Add missing doc snippet.Michael Brasser2011-11-091-0/+67
| | | | | Change-Id: I039888fd0203ef23f1c9cc229d7d354d8c908ca0 Reviewed-by: Yunqiao Yin <charles.yin@nokia.com>
* Fix documentation for property varChris Adams2011-11-041-8/+9
| | | | | | | | | Previously, it was not clear that a binding which accesses a property of a JavaScript Objects assigned to a var property would not be re-evaluated if the value of the property changed. Change-Id: I72d990e05104bc452fc516511a14716b2913ff9a Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Fix module API provider registration function documentationChris Adams2011-11-042-0/+128
| | | | | | | | | | Previously, the documentation was not able to be linked correctly by qdoc3. This commit moves the documentation to the correct file and ensures that the links work correctly. It also fixes a typo in the QQuickLoader documentation. Change-Id: Id675954dd3009fafe6e0cfeb81342c947302ffcb Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Add support for more sequence typesChris Adams2011-11-021-0/+30
| | | | | | | | | | | | | | | | | | | | | | | This commit adds support for more sequence types by adding a sequence wrapper. This class enables conversion between v8::Array and C++ sequences of various types (currently just QList<int>, QList<qreal>, QList<bool>, QList<QString>, QList<QUrl> and QStringList), but more types can be added later if required). When a JavaScript object is created from such a sequence, its prototype object is set to the v8::Array prototype object. The indexed setter, indexed getter, length and toString methods are implemented directly or in terms of the underlying sequence resource. Note that currently, sequences of ValueTypes are NOT supported, due to the fact that operations like: someObj.someValueTypeSequence[i].x = 5; would not behave as required. Task-number: QTBUG-20826 Task-number: QTBUG-21770 Change-Id: I36deb448fb0e87a32084a900e70a2604ff369309 Reviewed-by: Chris Adams <christopher.adams@nokia.com>
* Add performance guideline page for the particle systemAlan Alpert2011-11-011-5/+30
| | | | | | Change-Id: I1c49dc574921b1edbd2d0874bc5b4e806ce42416 Reviewed-by: Martin Jones <martin.jones@nokia.com> Reviewed-by: Alan Alpert <alan.alpert@nokia.com>
* Rename Qt Quick-specific classes to QQuick*Kent Hansen2011-10-215-20/+20
| | | | | | | | | | | | | | | | | | | | | | The QSG (SceneGraph) prefix is too generic for Qt Quick(2)-specific classes. All the classes and files in the declarative/items directory have been renamed. In particular, for classes that are currently public, the renaming is as follows: QSGView --> QQuickView QSGCanvas --> QQuickCanvas QSGItem --> QQuickItem QSGPaintedItem --> QQuickPaintedItem The header files have been renamed accordingly (e.g. qsgview.h --> qquickview.h). Change-Id: Iac937fff81db20bb639486a793c3aeb5230b038c Reviewed-by: Kent Hansen <kent.hansen@nokia.com>
* Cannot flick to the end of a horizontal ListView with LayoutMirroringMartin Jones2011-10-171-2/+3
| | | | | | | | | | | | | | | Forward port of fix for QTBUG-21756. minXExtent calculated the offset due to highlight range incorrectly (reversed) when mirroring enabled. Also us same algorithm for fixup() in GridView and ListView uses. For QtQuick 2, this change also reverses the beginning and end highlight range, as it should be, i.e. the preferredHighlightBegin is from the right side in RightToLeft mode. Also added snapping tests. Task-number: QTBUG-21756 Change-Id: Ica0ba4ab5db0ce9c77f2da75e9f8293550bd37d1 Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Improvements to text layouting in QMLYann Bodson2011-10-121-2/+5
| | | | | | | | | | | | | | | Allow more control over the text layouting process in QML. Give access to every text line through a hook, this gives the opportunity to position and resize a line as it is being laid out. It is then possible to lay out the text in columns or around other objects. Task-number: QTBUG-21367 Change-Id: I56dc0c1c4b575dc06360c135098024d0324d3656 Reviewed-on: http://codereview.qt-project.org/5351 Reviewed-by: Yann Bodson <yann.bodson@nokia.com> Sanity-Review: Yann Bodson <yann.bodson@nokia.com>
* Add DropArea item and Drag attached property.Andrew den Exter2011-10-101-0/+75
| | | | | | | | | | | | | | | | | | | Refactors drag API to improve compatibility with traditional drag and drop by reusing events and adding drop actions. Event sending is removed from MouseArea, instead the Drag object can be attached to the item that is dragged and it will send drag events when the position of that item is changed or when its active property changes. The DragTarget item is renamed to DropArea and can now communicate supported and suggested actions. Task-number: QTBUG-19747 Change-Id: I46cb77e68cf1ff32bbcbf0945facb593c9c2243c Reviewed-on: http://codereview.qt-project.org/4638 Sanity-Review: Qt Sanity Bot <qt_sanity_bot@ovi.com> Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Add JavaScript "var" property type to QMLChris Adams2011-10-062-2/+60
| | | | | | | | | | | This commit adds a new syntax which allows "var" type properties which can have JavaScript objects (as well as other basic types) assigned to them. Such JavaScript objects cannot be bound to. Task-number: QMLNG-18 Change-Id: If7f5045f4669e0d5c1b8d0891ed765128d0bc1c6 Reviewed-on: http://codereview.qt-project.org/1466 Reviewed-by: Aaron Kennedy <aaron.kennedy@nokia.com>
* Add support for filtering VisualDataModels.Andrew den Exter2011-10-061-0/+81
| | | | | | | | | | | | | | | | | Add a VisualDataGroup element which items within a VisualDataModel can be assigned to. Setting the group property of a VisualDataModel or one of its parts models will filter the items visible within a view to just items belonging to that group. By default all items belong to an 'items' group. The VisualDataModel attached object includes properties indicating whether a item is a member of a group and its index in the group. Task-number: QTBUG-21513 QTBUG-21515 Change-Id: If3df6a359a888a6f79923775d2f78076d5e7d2cf Reviewed-on: http://codereview.qt-project.org/4115 Reviewed-by: Qt Sanity Bot <qt_sanity_bot@ovi.com> Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Doc: Adding qtdeclarative documentation configuration files.Jerome Pasion2011-10-054-0/+802
| | | | | | | | | | | | | We need a modularized Qt Quick documentation package that only contains Qt Quick 2. Add a make target for the documentation. Copied Qt 5's offline style as a starting CSS template. Change-Id: I2298f23c7695ebbe38f43b89626431a2e8059a9a Reviewed-on: http://codereview.qt-project.org/5891 Reviewed-by: Qt Sanity Bot <qt_sanity_bot@ovi.com> Reviewed-by: Alan Alpert <alan.alpert@nokia.com>
* Couple more performance tips.Martin Jones2011-10-054-28/+22
| | | | | | Change-Id: Id0f5db95addd6ecc6c2816ba8dbfae58fa8e231f Reviewed-on: http://codereview.qt-project.org/6001 Reviewed-by: Martin Jones <martin.jones@nokia.com>
* Doc: Moving doc/src/declarative/pics/* to doc/src/images.Jerome Pasion2011-10-0482-0/+0
| | | | | | | | | | | | | Consolidates all the declarative pictures into one directory. -kept contents of doc/src/qtquick1/pics. -qdocconf file only looks at doc/src/images and therefore qdoc3 does not find images outside of that directory. Change-Id: I9da431f54c93d8b397accc1124a273758466994b Reviewed-on: http://codereview.qt-project.org/5921 Reviewed-by: Qt Sanity Bot <qt_sanity_bot@ovi.com> Reviewed-by: Alan Alpert <alan.alpert@nokia.com> Reviewed-by: Bea Lam <bea.lam@nokia.com>
* Doc: Converting the overviews' \e commands to \i commands.Jerome Pasion2011-10-0432-147/+147
| | | | | | | | | | | \e commands are deprecated and are only supported through an alias. We should use the official command and not the deprecated command. Change-Id: Icf88b9cda673f436dd855f22960112d0a37c74eb Reviewed-on: http://codereview.qt-project.org/5918 Reviewed-by: Qt Sanity Bot <qt_sanity_bot@ovi.com> Reviewed-by: Bea Lam <bea.lam@nokia.com> Reviewed-by: Alan Alpert <alan.alpert@nokia.com>
* Text format AutoText should use StyledText instead of RichText.Yann Bodson2011-09-301-0/+2
| | | | | | | | Task-number: QTBUG-21723 Change-Id: Ife213be95985ad1022e2f60241e69ecd9f467caf Reviewed-on: http://codereview.qt-project.org/5825 Reviewed-by: Qt Sanity Bot <qt_sanity_bot@ovi.com> Reviewed-by: Yann Bodson <yann.bodson@nokia.com>
* Separate the QtQuick 1 and 2 whatsnew docs.Martin Jones2011-09-294-218/+8
| | | | | | | Change-Id: Ifb2d2604dff3a19ba03f5e8d82cd0dd8b6d8744a Reviewed-on: http://codereview.qt-project.org/5688 Reviewed-by: Qt Sanity Bot <qt_sanity_bot@ovi.com> Reviewed-by: Casper van Donderen <casper.vandonderen@nokia.com>
* Support margins in Flickable.Martin Jones2011-09-261-0/+1
| | | | | | | | | | | It is sometimes desireable to leave a margin/add decoration around the content of a Flickable. This adds topMargin, leftMargin, bottomMargin rightMargin, xOrigin and yOrigin properties to Flickable. Task-number: QTBUG-21362 Change-Id: Ia24ea4c63e7a8de683b68100baac782c6f3a66bb Reviewed-on: http://codereview.qt-project.org/5445 Reviewed-by: Bea Lam <bea.lam@nokia.com>
* Doc: Added a simple introduction to Qt and fixed links.David Boddie2011-09-232-2/+2
| | | | | | | | Change-Id: I941bde15897e3ae51756d0ae4d3d011a7a3c4511 Reviewed-on: http://codereview.qt-project.org/1976 Reviewed-by: Qt Sanity Bot <qt_sanity_bot@ovi.com> Reviewed-by: Toby Tomkins <toby.tomkins@nokia.com> Reviewed-by: Peter Yard <peter.yard@nokia.com>
* Additional ListView section header placement optionsMartin Jones2011-09-221-0/+4
| | | | | | | | | | | | | | | | | | Add a section.labelPositioning property which can be a combination of: - ViewSection.InlineLabels - section labels are shown inline between the item delegates separating sections (default). - ViewSection.CurrentLabelAtStart - the current section label sticks to the start of the view as it is moved. - ViewSection.NextLabelAtEnd - the next section label (beyond all visible sections) sticks to the end of the view as it is moved. Task-number: QTBUG-12880 Change-Id: I4601828337412bd3a83769c9b8df3f6d4d7474b8 Reviewed-on: http://codereview.qt-project.org/5192 Reviewed-by: Qt Sanity Bot <qt_sanity_bot@ovi.com> Reviewed-by: Bea Lam <bea.lam@nokia.com>