Remove QSGEngine
[profile/ivi/qtdeclarative.git] / src / quick / items / qquickitem.cpp
1 /****************************************************************************
2 **
3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
4 ** Contact: http://www.qt-project.org/
5 **
6 ** This file is part of the QtQml module of the Qt Toolkit.
7 **
8 ** $QT_BEGIN_LICENSE:LGPL$
9 ** GNU Lesser General Public License Usage
10 ** This file may be used under the terms of the GNU Lesser General Public
11 ** License version 2.1 as published by the Free Software Foundation and
12 ** appearing in the file LICENSE.LGPL included in the packaging of this
13 ** file. Please review the following information to ensure the GNU Lesser
14 ** General Public License version 2.1 requirements will be met:
15 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
16 **
17 ** In addition, as a special exception, Nokia gives you certain additional
18 ** rights. These rights are described in the Nokia Qt LGPL Exception
19 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
20 **
21 ** GNU General Public License Usage
22 ** Alternatively, this file may be used under the terms of the GNU General
23 ** Public License version 3.0 as published by the Free Software Foundation
24 ** and appearing in the file LICENSE.GPL included in the packaging of this
25 ** file. Please review the following information to ensure the GNU General
26 ** Public License version 3.0 requirements will be met:
27 ** http://www.gnu.org/copyleft/gpl.html.
28 **
29 ** Other Usage
30 ** Alternatively, this file may be used in accordance with the terms and
31 ** conditions contained in a signed written agreement between you and Nokia.
32 **
33 **
34 **
35 **
36 **
37 **
38 ** $QT_END_LICENSE$
39 **
40 ****************************************************************************/
41
42 #include "qquickitem.h"
43
44 #include "qquickcanvas.h"
45 #include <QtQml/qjsengine.h>
46 #include "qquickcanvas_p.h"
47
48 #include "qquickevents_p_p.h"
49 #include "qquickscreen_p.h"
50
51 #include <QtQml/qqmlengine.h>
52 #include <QtQml/qqmlcomponent.h>
53 #include <QtQml/qqmlinfo.h>
54 #include <QtGui/qpen.h>
55 #include <QtGui/qguiapplication.h>
56 #include <QtGui/private/qguiapplication_p.h>
57 #include <QtGui/qinputmethod.h>
58 #include <QtCore/qdebug.h>
59 #include <QtCore/qcoreevent.h>
60 #include <QtCore/qnumeric.h>
61
62 #include <private/qqmlglobal_p.h>
63 #include <private/qqmlengine_p.h>
64 #include <QtQuick/private/qquickstategroup_p.h>
65 #include <private/qqmlopenmetaobject_p.h>
66 #include <QtQuick/private/qquickstate_p.h>
67 #include <private/qlistmodelinterface_p.h>
68 #include <private/qquickitem_p.h>
69 #include <private/qqmlaccessors_p.h>
70 #include <QtQuick/private/qquickaccessibleattached_p.h>
71
72 #include <float.h>
73
74 // XXX todo Check that elements that create items handle memory correctly after visual ownership change
75
76 QT_BEGIN_NAMESPACE
77
78 #ifdef FOCUS_DEBUG
79 void printFocusTree(QQuickItem *item, QQuickItem *scope = 0, int depth = 1);
80 void printFocusTree(QQuickItem *item, QQuickItem *scope, int depth)
81 {
82     qWarning()
83             << QByteArray(depth, '\t').constData()
84             << (scope && QQuickItemPrivate::get(scope)->subFocusItem == item ? '*' : ' ')
85             << item->hasFocus()
86             << item->hasActiveFocus()
87             << item->isFocusScope()
88             << item;
89     foreach (QQuickItem *child, item->childItems()) {
90         printFocusTree(
91                 child,
92                 item->isFocusScope() || !scope ? item : scope,
93                 item->isFocusScope() || !scope ? depth + 1 : depth);
94     }
95 }
96 #endif
97
98 static void QQuickItem_parentNotifier(QObject *o, intptr_t, QQmlNotifier **n)
99 {
100     QQuickItemPrivate *d = QQuickItemPrivate::get(static_cast<QQuickItem *>(o));
101     *n = &d->parentNotifier;
102 }
103
104 QML_PRIVATE_ACCESSOR(QQuickItem, QQuickItem *, parent, parentItem)
105 QML_PRIVATE_ACCESSOR(QQuickItem, qreal, x, x)
106 QML_PRIVATE_ACCESSOR(QQuickItem, qreal, y, y)
107 QML_PRIVATE_ACCESSOR(QQuickItem, qreal, width, width)
108 QML_PRIVATE_ACCESSOR(QQuickItem, qreal, height, height)
109
110 static QQmlAccessors QQuickItem_parent = { QQuickItem_parentRead, QQuickItem_parentNotifier };
111 static QQmlAccessors QQuickItem_x = { QQuickItem_xRead, 0 };
112 static QQmlAccessors QQuickItem_y = { QQuickItem_yRead, 0 };
113 static QQmlAccessors QQuickItem_width = { QQuickItem_widthRead, 0 };
114 static QQmlAccessors QQuickItem_height = { QQuickItem_heightRead, 0 };
115
116 QML_DECLARE_PROPERTIES(QQuickItem) {
117     { QML_PROPERTY_NAME(parent), 0, &QQuickItem_parent },
118     { QML_PROPERTY_NAME(x), 0, &QQuickItem_x },
119     { QML_PROPERTY_NAME(y), 0, &QQuickItem_y },
120     { QML_PROPERTY_NAME(width), 0, &QQuickItem_width },
121     { QML_PROPERTY_NAME(height), 0, &QQuickItem_height }
122 };
123
124 void QQuickItemPrivate::registerAccessorProperties()
125 {
126     QML_DEFINE_PROPERTIES(QQuickItem);
127 }
128
129 /*!
130     \qmlclass Transform QQuickTransform
131     \inqmlmodule QtQuick 2
132     \ingroup qml-transform-elements
133     \brief The Transform elements provide a way of building advanced transformations on Items.
134
135     The Transform element is a base type which cannot be instantiated directly.
136     The following concrete Transform types are available:
137
138     \list
139     \li \l Rotation
140     \li \l Scale
141     \li \l Translate
142     \endlist
143
144     The Transform elements let you create and control advanced transformations that can be configured
145     independently using specialized properties.
146
147     You can assign any number of Transform elements to an \l Item. Each Transform is applied in order,
148     one at a time.
149 */
150
151 /*!
152     \qmlclass Translate QQuickTranslate
153     \inqmlmodule QtQuick 2
154     \ingroup qml-transform-elements
155     \brief The Translate object provides a way to move an Item without changing its x or y properties.
156
157     The Translate object provides independent control over position in addition to the Item's x and y properties.
158
159     The following example moves the Y axis of the \l Rectangle elements while still allowing the \l Row element
160     to lay the items out as if they had not been transformed:
161     \qml
162     import QtQuick 2.0
163
164     Row {
165         Rectangle {
166             width: 100; height: 100
167             color: "blue"
168             transform: Translate { y: 20 }
169         }
170         Rectangle {
171             width: 100; height: 100
172             color: "red"
173             transform: Translate { y: -20 }
174         }
175     }
176     \endqml
177
178     \image translate.png
179 */
180
181 /*!
182     \qmlproperty real QtQuick2::Translate::x
183
184     The translation along the X axis.
185 */
186
187 /*!
188     \qmlproperty real QtQuick2::Translate::y
189
190     The translation along the Y axis.
191 */
192
193 /*!
194     \qmlclass Scale QQuickScale
195     \inqmlmodule QtQuick 2
196     \ingroup qml-transform-elements
197     \brief The Scale element provides a way to scale an Item.
198
199     The Scale element gives more control over scaling than using \l Item's \l{Item::scale}{scale} property. Specifically,
200     it allows a different scale for the x and y axes, and allows the scale to be relative to an
201     arbitrary point.
202
203     The following example scales the X axis of the Rectangle, relative to its interior point 25, 25:
204     \qml
205     Rectangle {
206         width: 100; height: 100
207         color: "blue"
208         transform: Scale { origin.x: 25; origin.y: 25; xScale: 3}
209     }
210     \endqml
211
212     \sa Rotation, Translate
213 */
214
215 /*!
216     \qmlproperty real QtQuick2::Scale::origin.x
217     \qmlproperty real QtQuick2::Scale::origin.y
218
219     The point that the item is scaled from (i.e., the point that stays fixed relative to the parent as
220     the rest of the item grows). By default the origin is 0, 0.
221 */
222
223 /*!
224     \qmlproperty real QtQuick2::Scale::xScale
225
226     The scaling factor for the X axis.
227 */
228
229 /*!
230     \qmlproperty real QtQuick2::Scale::yScale
231
232     The scaling factor for the Y axis.
233 */
234
235 /*!
236     \qmlclass Rotation QQuickRotation
237     \inqmlmodule QtQuick 2
238     \ingroup qml-transform-elements
239     \brief The Rotation object provides a way to rotate an Item.
240
241     The Rotation object gives more control over rotation than using \l Item's \l{Item::rotation}{rotation} property.
242     Specifically, it allows (z axis) rotation to be relative to an arbitrary point.
243
244     The following example rotates a Rectangle around its interior point 25, 25:
245     \qml
246     Rectangle {
247         width: 100; height: 100
248         color: "blue"
249         transform: Rotation { origin.x: 25; origin.y: 25; angle: 45}
250     }
251     \endqml
252
253     Rotation also provides a way to specify 3D-like rotations for Items. For these types of
254     rotations you must specify the axis to rotate around in addition to the origin point.
255
256     The following example shows various 3D-like rotations applied to an \l Image.
257     \snippet doc/src/snippets/qml/rotation.qml 0
258
259     \image axisrotation.png
260
261     \sa {declarative/ui-components/dialcontrol}{Dial Control example}, {declarative/toys/clocks}{Clocks example}
262 */
263
264 /*!
265     \qmlproperty real QtQuick2::Rotation::origin.x
266     \qmlproperty real QtQuick2::Rotation::origin.y
267
268     The origin point of the rotation (i.e., the point that stays fixed relative to the parent as
269     the rest of the item rotates). By default the origin is 0, 0.
270 */
271
272 /*!
273     \qmlproperty real QtQuick2::Rotation::axis.x
274     \qmlproperty real QtQuick2::Rotation::axis.y
275     \qmlproperty real QtQuick2::Rotation::axis.z
276
277     The axis to rotate around. For simple (2D) rotation around a point, you do not need to specify an axis,
278     as the default axis is the z axis (\c{ axis { x: 0; y: 0; z: 1 } }).
279
280     For a typical 3D-like rotation you will usually specify both the origin and the axis.
281
282     \image 3d-rotation-axis.png
283 */
284
285 /*!
286     \qmlproperty real QtQuick2::Rotation::angle
287
288     The angle to rotate, in degrees clockwise.
289 */
290
291 QQuickTransformPrivate::QQuickTransformPrivate()
292 {
293 }
294
295 QQuickTransform::QQuickTransform(QObject *parent)
296 : QObject(*(new QQuickTransformPrivate), parent)
297 {
298 }
299
300 QQuickTransform::QQuickTransform(QQuickTransformPrivate &dd, QObject *parent)
301 : QObject(dd, parent)
302 {
303 }
304
305 QQuickTransform::~QQuickTransform()
306 {
307     Q_D(QQuickTransform);
308     for (int ii = 0; ii < d->items.count(); ++ii) {
309         QQuickItemPrivate *p = QQuickItemPrivate::get(d->items.at(ii));
310         p->transforms.removeOne(this);
311         p->dirty(QQuickItemPrivate::Transform);
312     }
313 }
314
315 void QQuickTransform::update()
316 {
317     Q_D(QQuickTransform);
318     for (int ii = 0; ii < d->items.count(); ++ii) {
319         QQuickItemPrivate *p = QQuickItemPrivate::get(d->items.at(ii));
320         p->dirty(QQuickItemPrivate::Transform);
321     }
322 }
323
324 QQuickContents::QQuickContents(QQuickItem *item)
325 : m_item(item), m_x(0), m_y(0), m_width(0), m_height(0)
326 {
327 }
328
329 QQuickContents::~QQuickContents()
330 {
331     QList<QQuickItem *> children = m_item->childItems();
332     for (int i = 0; i < children.count(); ++i) {
333         QQuickItem *child = children.at(i);
334         QQuickItemPrivate::get(child)->removeItemChangeListener(this, QQuickItemPrivate::Geometry | QQuickItemPrivate::Destroyed);
335     }
336 }
337
338 bool QQuickContents::calcHeight(QQuickItem *changed)
339 {
340     qreal oldy = m_y;
341     qreal oldheight = m_height;
342
343     if (changed) {
344         qreal top = oldy;
345         qreal bottom = oldy + oldheight;
346         qreal y = changed->y();
347         if (y + changed->height() > bottom)
348             bottom = y + changed->height();
349         if (y < top)
350             top = y;
351         m_y = top;
352         m_height = bottom - top;
353     } else {
354         qreal top = FLT_MAX;
355         qreal bottom = 0;
356         QList<QQuickItem *> children = m_item->childItems();
357         for (int i = 0; i < children.count(); ++i) {
358             QQuickItem *child = children.at(i);
359             qreal y = child->y();
360             if (y + child->height() > bottom)
361                 bottom = y + child->height();
362             if (y < top)
363                 top = y;
364         }
365         if (!children.isEmpty())
366             m_y = top;
367         m_height = qMax(bottom - top, qreal(0.0));
368     }
369
370     return (m_height != oldheight || m_y != oldy);
371 }
372
373 bool QQuickContents::calcWidth(QQuickItem *changed)
374 {
375     qreal oldx = m_x;
376     qreal oldwidth = m_width;
377
378     if (changed) {
379         qreal left = oldx;
380         qreal right = oldx + oldwidth;
381         qreal x = changed->x();
382         if (x + changed->width() > right)
383             right = x + changed->width();
384         if (x < left)
385             left = x;
386         m_x = left;
387         m_width = right - left;
388     } else {
389         qreal left = FLT_MAX;
390         qreal right = 0;
391         QList<QQuickItem *> children = m_item->childItems();
392         for (int i = 0; i < children.count(); ++i) {
393             QQuickItem *child = children.at(i);
394             qreal x = child->x();
395             if (x + child->width() > right)
396                 right = x + child->width();
397             if (x < left)
398                 left = x;
399         }
400         if (!children.isEmpty())
401             m_x = left;
402         m_width = qMax(right - left, qreal(0.0));
403     }
404
405     return (m_width != oldwidth || m_x != oldx);
406 }
407
408 void QQuickContents::complete()
409 {
410     QQuickItemPrivate::get(m_item)->addItemChangeListener(this, QQuickItemPrivate::Children);
411
412     QList<QQuickItem *> children = m_item->childItems();
413     for (int i = 0; i < children.count(); ++i) {
414         QQuickItem *child = children.at(i);
415         QQuickItemPrivate::get(child)->addItemChangeListener(this, QQuickItemPrivate::Geometry | QQuickItemPrivate::Destroyed);
416         //###what about changes to visibility?
417     }
418     calcGeometry();
419 }
420
421 void QQuickContents::updateRect()
422 {
423     QQuickItemPrivate::get(m_item)->emitChildrenRectChanged(rectF());
424 }
425
426 void QQuickContents::itemGeometryChanged(QQuickItem *changed, const QRectF &newGeometry, const QRectF &oldGeometry)
427 {
428     Q_UNUSED(changed)
429     bool wChanged = false;
430     bool hChanged = false;
431     //### we can only pass changed if the left edge has moved left, or the right edge has moved right
432     if (newGeometry.width() != oldGeometry.width() || newGeometry.x() != oldGeometry.x())
433         wChanged = calcWidth(/*changed*/);
434     if (newGeometry.height() != oldGeometry.height() || newGeometry.y() != oldGeometry.y())
435         hChanged = calcHeight(/*changed*/);
436     if (wChanged || hChanged)
437         updateRect();
438 }
439
440 void QQuickContents::itemDestroyed(QQuickItem *item)
441 {
442     if (item)
443         QQuickItemPrivate::get(item)->removeItemChangeListener(this, QQuickItemPrivate::Geometry | QQuickItemPrivate::Destroyed);
444     calcGeometry();
445 }
446
447 void QQuickContents::itemChildRemoved(QQuickItem *, QQuickItem *item)
448 {
449     if (item)
450         QQuickItemPrivate::get(item)->removeItemChangeListener(this, QQuickItemPrivate::Geometry | QQuickItemPrivate::Destroyed);
451     calcGeometry();
452 }
453
454 void QQuickContents::itemChildAdded(QQuickItem *, QQuickItem *item)
455 {
456     if (item)
457         QQuickItemPrivate::get(item)->addItemChangeListener(this, QQuickItemPrivate::Geometry | QQuickItemPrivate::Destroyed);
458     calcGeometry(item);
459 }
460
461 QQuickItemKeyFilter::QQuickItemKeyFilter(QQuickItem *item)
462 : m_processPost(false), m_next(0)
463 {
464     QQuickItemPrivate *p = item?QQuickItemPrivate::get(item):0;
465     if (p) {
466         m_next = p->extra.value().keyHandler;
467         p->extra->keyHandler = this;
468     }
469 }
470
471 QQuickItemKeyFilter::~QQuickItemKeyFilter()
472 {
473 }
474
475 void QQuickItemKeyFilter::keyPressed(QKeyEvent *event, bool post)
476 {
477     if (m_next) m_next->keyPressed(event, post);
478 }
479
480 void QQuickItemKeyFilter::keyReleased(QKeyEvent *event, bool post)
481 {
482     if (m_next) m_next->keyReleased(event, post);
483 }
484
485 void QQuickItemKeyFilter::inputMethodEvent(QInputMethodEvent *event, bool post)
486 {
487     if (m_next)
488         m_next->inputMethodEvent(event, post);
489     else
490         event->ignore();
491 }
492
493 QVariant QQuickItemKeyFilter::inputMethodQuery(Qt::InputMethodQuery query) const
494 {
495     if (m_next) return m_next->inputMethodQuery(query);
496     return QVariant();
497 }
498
499 void QQuickItemKeyFilter::componentComplete()
500 {
501     if (m_next) m_next->componentComplete();
502 }
503 /*!
504     \qmlclass KeyNavigation QQuickKeyNavigationAttached
505     \inqmlmodule QtQuick 2
506     \ingroup qml-basic-interaction-elements
507     \brief The KeyNavigation attached property supports key navigation by arrow keys.
508
509     Key-based user interfaces commonly allow the use of arrow keys to navigate between
510     focusable items.  The KeyNavigation attached property enables this behavior by providing a
511     convenient way to specify the item that should gain focus when an arrow or tab key is pressed.
512
513     The following example provides key navigation for a 2x2 grid of items:
514
515     \snippet doc/src/snippets/qml/keynavigation.qml 0
516
517     The top-left item initially receives focus by setting \l {Item::}{focus} to
518     \c true. When an arrow key is pressed, the focus will move to the
519     appropriate item, as defined by the value that has been set for
520     the KeyNavigation \l left, \l right, \l up or \l down properties.
521
522     Note that if a KeyNavigation attached property receives the key press and release
523     events for a requested arrow or tab key, the event is accepted and does not
524     propagate any further.
525
526     By default, KeyNavigation receives key events after the item to which it is attached.
527     If the item accepts the key event, the KeyNavigation attached property will not
528     receive an event for that key.  Setting the \l priority property to
529     \c KeyNavigation.BeforeItem allows the event to be used for key navigation
530     before the item, rather than after.
531
532     If item to which the focus is switching is not enabled or visible, an attempt will
533     be made to skip this item and focus on the next. This is possible if there are
534     a chain of items with the same KeyNavigation handler. If multiple items in a row are not enabled
535     or visible, they will also be skipped.
536
537     KeyNavigation will implicitly set the other direction to return focus to this item. So if you set
538     \l left to another item, \l right will be set on that item's KeyNavigation to set focus back to this
539     item. However, if that item's KeyNavigation has had right explicitly set then no change will occur.
540     This means that the above example could have been written, with the same behaviour, without specifing
541     KeyNavigation.right or KeyNavigation.down for any of the items.
542
543     \sa {Keys}{Keys attached property}
544 */
545
546 /*!
547     \qmlproperty Item QtQuick2::KeyNavigation::left
548     \qmlproperty Item QtQuick2::KeyNavigation::right
549     \qmlproperty Item QtQuick2::KeyNavigation::up
550     \qmlproperty Item QtQuick2::KeyNavigation::down
551     \qmlproperty Item QtQuick2::KeyNavigation::tab
552     \qmlproperty Item QtQuick2::KeyNavigation::backtab
553
554     These properties hold the item to assign focus to
555     when the left, right, up or down cursor keys, or the
556     tab key are pressed.
557 */
558
559 /*!
560     \qmlproperty Item QtQuick2::KeyNavigation::tab
561     \qmlproperty Item QtQuick2::KeyNavigation::backtab
562
563     These properties hold the item to assign focus to
564     when the Tab key or Shift+Tab key combination (Backtab) are pressed.
565 */
566
567 QQuickKeyNavigationAttached::QQuickKeyNavigationAttached(QObject *parent)
568 : QObject(*(new QQuickKeyNavigationAttachedPrivate), parent),
569   QQuickItemKeyFilter(qobject_cast<QQuickItem*>(parent))
570 {
571     m_processPost = true;
572 }
573
574 QQuickKeyNavigationAttached *
575 QQuickKeyNavigationAttached::qmlAttachedProperties(QObject *obj)
576 {
577     return new QQuickKeyNavigationAttached(obj);
578 }
579
580 QQuickItem *QQuickKeyNavigationAttached::left() const
581 {
582     Q_D(const QQuickKeyNavigationAttached);
583     return d->left;
584 }
585
586 void QQuickKeyNavigationAttached::setLeft(QQuickItem *i)
587 {
588     Q_D(QQuickKeyNavigationAttached);
589     if (d->left == i)
590         return;
591     d->left = i;
592     d->leftSet = true;
593     QQuickKeyNavigationAttached* other =
594             qobject_cast<QQuickKeyNavigationAttached*>(qmlAttachedPropertiesObject<QQuickKeyNavigationAttached>(i));
595     if (other && !other->d_func()->rightSet){
596         other->d_func()->right = qobject_cast<QQuickItem*>(parent());
597         emit other->rightChanged();
598     }
599     emit leftChanged();
600 }
601
602 QQuickItem *QQuickKeyNavigationAttached::right() const
603 {
604     Q_D(const QQuickKeyNavigationAttached);
605     return d->right;
606 }
607
608 void QQuickKeyNavigationAttached::setRight(QQuickItem *i)
609 {
610     Q_D(QQuickKeyNavigationAttached);
611     if (d->right == i)
612         return;
613     d->right = i;
614     d->rightSet = true;
615     QQuickKeyNavigationAttached* other =
616             qobject_cast<QQuickKeyNavigationAttached*>(qmlAttachedPropertiesObject<QQuickKeyNavigationAttached>(i));
617     if (other && !other->d_func()->leftSet){
618         other->d_func()->left = qobject_cast<QQuickItem*>(parent());
619         emit other->leftChanged();
620     }
621     emit rightChanged();
622 }
623
624 QQuickItem *QQuickKeyNavigationAttached::up() const
625 {
626     Q_D(const QQuickKeyNavigationAttached);
627     return d->up;
628 }
629
630 void QQuickKeyNavigationAttached::setUp(QQuickItem *i)
631 {
632     Q_D(QQuickKeyNavigationAttached);
633     if (d->up == i)
634         return;
635     d->up = i;
636     d->upSet = true;
637     QQuickKeyNavigationAttached* other =
638             qobject_cast<QQuickKeyNavigationAttached*>(qmlAttachedPropertiesObject<QQuickKeyNavigationAttached>(i));
639     if (other && !other->d_func()->downSet){
640         other->d_func()->down = qobject_cast<QQuickItem*>(parent());
641         emit other->downChanged();
642     }
643     emit upChanged();
644 }
645
646 QQuickItem *QQuickKeyNavigationAttached::down() const
647 {
648     Q_D(const QQuickKeyNavigationAttached);
649     return d->down;
650 }
651
652 void QQuickKeyNavigationAttached::setDown(QQuickItem *i)
653 {
654     Q_D(QQuickKeyNavigationAttached);
655     if (d->down == i)
656         return;
657     d->down = i;
658     d->downSet = true;
659     QQuickKeyNavigationAttached* other =
660             qobject_cast<QQuickKeyNavigationAttached*>(qmlAttachedPropertiesObject<QQuickKeyNavigationAttached>(i));
661     if (other && !other->d_func()->upSet) {
662         other->d_func()->up = qobject_cast<QQuickItem*>(parent());
663         emit other->upChanged();
664     }
665     emit downChanged();
666 }
667
668 QQuickItem *QQuickKeyNavigationAttached::tab() const
669 {
670     Q_D(const QQuickKeyNavigationAttached);
671     return d->tab;
672 }
673
674 void QQuickKeyNavigationAttached::setTab(QQuickItem *i)
675 {
676     Q_D(QQuickKeyNavigationAttached);
677     if (d->tab == i)
678         return;
679     d->tab = i;
680     d->tabSet = true;
681     QQuickKeyNavigationAttached* other =
682             qobject_cast<QQuickKeyNavigationAttached*>(qmlAttachedPropertiesObject<QQuickKeyNavigationAttached>(i));
683     if (other && !other->d_func()->backtabSet) {
684         other->d_func()->backtab = qobject_cast<QQuickItem*>(parent());
685         emit other->backtabChanged();
686     }
687     emit tabChanged();
688 }
689
690 QQuickItem *QQuickKeyNavigationAttached::backtab() const
691 {
692     Q_D(const QQuickKeyNavigationAttached);
693     return d->backtab;
694 }
695
696 void QQuickKeyNavigationAttached::setBacktab(QQuickItem *i)
697 {
698     Q_D(QQuickKeyNavigationAttached);
699     if (d->backtab == i)
700         return;
701     d->backtab = i;
702     d->backtabSet = true;
703     QQuickKeyNavigationAttached* other =
704             qobject_cast<QQuickKeyNavigationAttached*>(qmlAttachedPropertiesObject<QQuickKeyNavigationAttached>(i));
705     if (other && !other->d_func()->tabSet) {
706         other->d_func()->tab = qobject_cast<QQuickItem*>(parent());
707         emit other->tabChanged();
708     }
709     emit backtabChanged();
710 }
711
712 /*!
713     \qmlproperty enumeration QtQuick2::KeyNavigation::priority
714
715     This property determines whether the keys are processed before
716     or after the attached item's own key handling.
717
718     \list
719     \li KeyNavigation.BeforeItem - process the key events before normal
720     item key processing.  If the event is used for key navigation, it will be accepted and will not
721     be passed on to the item.
722     \li KeyNavigation.AfterItem (default) - process the key events after normal item key
723     handling.  If the item accepts the key event it will not be
724     handled by the KeyNavigation attached property handler.
725     \endlist
726 */
727 QQuickKeyNavigationAttached::Priority QQuickKeyNavigationAttached::priority() const
728 {
729     return m_processPost ? AfterItem : BeforeItem;
730 }
731
732 void QQuickKeyNavigationAttached::setPriority(Priority order)
733 {
734     bool processPost = order == AfterItem;
735     if (processPost != m_processPost) {
736         m_processPost = processPost;
737         emit priorityChanged();
738     }
739 }
740
741 void QQuickKeyNavigationAttached::keyPressed(QKeyEvent *event, bool post)
742 {
743     Q_D(QQuickKeyNavigationAttached);
744     event->ignore();
745
746     if (post != m_processPost) {
747         QQuickItemKeyFilter::keyPressed(event, post);
748         return;
749     }
750
751     bool mirror = false;
752     switch (event->key()) {
753     case Qt::Key_Left: {
754         if (QQuickItem *parentItem = qobject_cast<QQuickItem*>(parent()))
755             mirror = QQuickItemPrivate::get(parentItem)->effectiveLayoutMirror;
756         QQuickItem* leftItem = mirror ? d->right : d->left;
757         if (leftItem) {
758             setFocusNavigation(leftItem, mirror ? "right" : "left");
759             event->accept();
760         }
761         break;
762     }
763     case Qt::Key_Right: {
764         if (QQuickItem *parentItem = qobject_cast<QQuickItem*>(parent()))
765             mirror = QQuickItemPrivate::get(parentItem)->effectiveLayoutMirror;
766         QQuickItem* rightItem = mirror ? d->left : d->right;
767         if (rightItem) {
768             setFocusNavigation(rightItem, mirror ? "left" : "right");
769             event->accept();
770         }
771         break;
772     }
773     case Qt::Key_Up:
774         if (d->up) {
775             setFocusNavigation(d->up, "up");
776             event->accept();
777         }
778         break;
779     case Qt::Key_Down:
780         if (d->down) {
781             setFocusNavigation(d->down, "down");
782             event->accept();
783         }
784         break;
785     case Qt::Key_Tab:
786         if (d->tab) {
787             setFocusNavigation(d->tab, "tab");
788             event->accept();
789         }
790         break;
791     case Qt::Key_Backtab:
792         if (d->backtab) {
793             setFocusNavigation(d->backtab, "backtab");
794             event->accept();
795         }
796         break;
797     default:
798         break;
799     }
800
801     if (!event->isAccepted()) QQuickItemKeyFilter::keyPressed(event, post);
802 }
803
804 void QQuickKeyNavigationAttached::keyReleased(QKeyEvent *event, bool post)
805 {
806     Q_D(QQuickKeyNavigationAttached);
807     event->ignore();
808
809     if (post != m_processPost) {
810         QQuickItemKeyFilter::keyReleased(event, post);
811         return;
812     }
813
814     bool mirror = false;
815     switch (event->key()) {
816     case Qt::Key_Left:
817         if (QQuickItem *parentItem = qobject_cast<QQuickItem*>(parent()))
818             mirror = QQuickItemPrivate::get(parentItem)->effectiveLayoutMirror;
819         if (mirror ? d->right : d->left)
820             event->accept();
821         break;
822     case Qt::Key_Right:
823         if (QQuickItem *parentItem = qobject_cast<QQuickItem*>(parent()))
824             mirror = QQuickItemPrivate::get(parentItem)->effectiveLayoutMirror;
825         if (mirror ? d->left : d->right)
826             event->accept();
827         break;
828     case Qt::Key_Up:
829         if (d->up) {
830             event->accept();
831         }
832         break;
833     case Qt::Key_Down:
834         if (d->down) {
835             event->accept();
836         }
837         break;
838     case Qt::Key_Tab:
839         if (d->tab) {
840             event->accept();
841         }
842         break;
843     case Qt::Key_Backtab:
844         if (d->backtab) {
845             event->accept();
846         }
847         break;
848     default:
849         break;
850     }
851
852     if (!event->isAccepted()) QQuickItemKeyFilter::keyReleased(event, post);
853 }
854
855 void QQuickKeyNavigationAttached::setFocusNavigation(QQuickItem *currentItem, const char *dir)
856 {
857     QQuickItem *initialItem = currentItem;
858     bool isNextItem = false;
859     do {
860         isNextItem = false;
861         if (currentItem->isVisible() && currentItem->isEnabled()) {
862             currentItem->setFocus(true);
863         } else {
864             QObject *attached =
865                 qmlAttachedPropertiesObject<QQuickKeyNavigationAttached>(currentItem, false);
866             if (attached) {
867                 QQuickItem *tempItem = qvariant_cast<QQuickItem*>(attached->property(dir));
868                 if (tempItem) {
869                     currentItem = tempItem;
870                     isNextItem = true;
871                 }
872             }
873         }
874     }
875     while (currentItem != initialItem && isNextItem);
876 }
877
878 const QQuickKeysAttached::SigMap QQuickKeysAttached::sigMap[] = {
879     { Qt::Key_Left, "leftPressed" },
880     { Qt::Key_Right, "rightPressed" },
881     { Qt::Key_Up, "upPressed" },
882     { Qt::Key_Down, "downPressed" },
883     { Qt::Key_Tab, "tabPressed" },
884     { Qt::Key_Backtab, "backtabPressed" },
885     { Qt::Key_Asterisk, "asteriskPressed" },
886     { Qt::Key_NumberSign, "numberSignPressed" },
887     { Qt::Key_Escape, "escapePressed" },
888     { Qt::Key_Return, "returnPressed" },
889     { Qt::Key_Enter, "enterPressed" },
890     { Qt::Key_Delete, "deletePressed" },
891     { Qt::Key_Space, "spacePressed" },
892     { Qt::Key_Back, "backPressed" },
893     { Qt::Key_Cancel, "cancelPressed" },
894     { Qt::Key_Select, "selectPressed" },
895     { Qt::Key_Yes, "yesPressed" },
896     { Qt::Key_No, "noPressed" },
897     { Qt::Key_Context1, "context1Pressed" },
898     { Qt::Key_Context2, "context2Pressed" },
899     { Qt::Key_Context3, "context3Pressed" },
900     { Qt::Key_Context4, "context4Pressed" },
901     { Qt::Key_Call, "callPressed" },
902     { Qt::Key_Hangup, "hangupPressed" },
903     { Qt::Key_Flip, "flipPressed" },
904     { Qt::Key_Menu, "menuPressed" },
905     { Qt::Key_VolumeUp, "volumeUpPressed" },
906     { Qt::Key_VolumeDown, "volumeDownPressed" },
907     { 0, 0 }
908 };
909
910 bool QQuickKeysAttached::isConnected(const char *signalName)
911 {
912     Q_D(QQuickKeysAttached);
913     //### doing two string-based lookups isn't ideal
914     int signal_index = d->signalIndex(signalName);
915     int index = metaObject()->indexOfSignal(signalName);
916     return QQml_isSignalConnected(this, signal_index, index);
917 }
918
919 /*!
920     \qmlclass Keys QQuickKeysAttached
921     \inqmlmodule QtQuick 2
922     \ingroup qml-basic-interaction-elements
923     \brief The Keys attached property provides key handling to Items.
924
925     All visual primitives support key handling via the Keys
926     attached property.  Keys can be handled via the onPressed
927     and onReleased signal properties.
928
929     The signal properties have a \l KeyEvent parameter, named
930     \e event which contains details of the event.  If a key is
931     handled \e event.accepted should be set to true to prevent the
932     event from propagating up the item hierarchy.
933
934     \section1 Example Usage
935
936     The following example shows how the general onPressed handler can
937     be used to test for a certain key; in this case, the left cursor
938     key:
939
940     \snippet doc/src/snippets/qml/keys/keys-pressed.qml key item
941
942     Some keys may alternatively be handled via specific signal properties,
943     for example \e onSelectPressed.  These handlers automatically set
944     \e event.accepted to true.
945
946     \snippet doc/src/snippets/qml/keys/keys-handler.qml key item
947
948     See \l{Qt::Key}{Qt.Key} for the list of keyboard codes.
949
950     \section1 Key Handling Priorities
951
952     The Keys attached property can be configured to handle key events
953     before or after the item it is attached to. This makes it possible
954     to intercept events in order to override an item's default behavior,
955     or act as a fallback for keys not handled by the item.
956
957     If \l priority is Keys.BeforeItem (default) the order of key event processing is:
958
959     \list 1
960     \li Items specified in \c forwardTo
961     \li specific key handlers, e.g. onReturnPressed
962     \li onKeyPress, onKeyRelease handlers
963     \li Item specific key handling, e.g. TextInput key handling
964     \li parent item
965     \endlist
966
967     If priority is Keys.AfterItem the order of key event processing is:
968
969     \list 1
970     \li Item specific key handling, e.g. TextInput key handling
971     \li Items specified in \c forwardTo
972     \li specific key handlers, e.g. onReturnPressed
973     \li onKeyPress, onKeyRelease handlers
974     \li parent item
975     \endlist
976
977     If the event is accepted during any of the above steps, key
978     propagation stops.
979
980     \sa KeyEvent, {KeyNavigation}{KeyNavigation attached property}
981 */
982
983 /*!
984     \qmlproperty bool QtQuick2::Keys::enabled
985
986     This flags enables key handling if true (default); otherwise
987     no key handlers will be called.
988 */
989
990 /*!
991     \qmlproperty enumeration QtQuick2::Keys::priority
992
993     This property determines whether the keys are processed before
994     or after the attached item's own key handling.
995
996     \list
997     \li Keys.BeforeItem (default) - process the key events before normal
998     item key processing.  If the event is accepted it will not
999     be passed on to the item.
1000     \li Keys.AfterItem - process the key events after normal item key
1001     handling.  If the item accepts the key event it will not be
1002     handled by the Keys attached property handler.
1003     \endlist
1004 */
1005
1006 /*!
1007     \qmlproperty list<Object> QtQuick2::Keys::forwardTo
1008
1009     This property provides a way to forward key presses, key releases, and keyboard input
1010     coming from input methods to other items. This can be useful when you want
1011     one item to handle some keys (e.g. the up and down arrow keys), and another item to
1012     handle other keys (e.g. the left and right arrow keys).  Once an item that has been
1013     forwarded keys accepts the event it is no longer forwarded to items later in the
1014     list.
1015
1016     This example forwards key events to two lists:
1017     \qml
1018     Item {
1019         ListView {
1020             id: list1
1021             // ...
1022         }
1023         ListView {
1024             id: list2
1025             // ...
1026         }
1027         Keys.forwardTo: [list1, list2]
1028         focus: true
1029     }
1030     \endqml
1031 */
1032
1033 /*!
1034     \qmlsignal QtQuick2::Keys::onPressed(KeyEvent event)
1035
1036     This handler is called when a key has been pressed. The \a event
1037     parameter provides information about the event.
1038 */
1039
1040 /*!
1041     \qmlsignal QtQuick2::Keys::onReleased(KeyEvent event)
1042
1043     This handler is called when a key has been released. The \a event
1044     parameter provides information about the event.
1045 */
1046
1047 /*!
1048     \qmlsignal QtQuick2::Keys::onDigit0Pressed(KeyEvent event)
1049
1050     This handler is called when the digit '0' has been pressed. The \a event
1051     parameter provides information about the event.
1052 */
1053
1054 /*!
1055     \qmlsignal QtQuick2::Keys::onDigit1Pressed(KeyEvent event)
1056
1057     This handler is called when the digit '1' has been pressed. The \a event
1058     parameter provides information about the event.
1059 */
1060
1061 /*!
1062     \qmlsignal QtQuick2::Keys::onDigit2Pressed(KeyEvent event)
1063
1064     This handler is called when the digit '2' has been pressed. The \a event
1065     parameter provides information about the event.
1066 */
1067
1068 /*!
1069     \qmlsignal QtQuick2::Keys::onDigit3Pressed(KeyEvent event)
1070
1071     This handler is called when the digit '3' has been pressed. The \a event
1072     parameter provides information about the event.
1073 */
1074
1075 /*!
1076     \qmlsignal QtQuick2::Keys::onDigit4Pressed(KeyEvent event)
1077
1078     This handler is called when the digit '4' has been pressed. The \a event
1079     parameter provides information about the event.
1080 */
1081
1082 /*!
1083     \qmlsignal QtQuick2::Keys::onDigit5Pressed(KeyEvent event)
1084
1085     This handler is called when the digit '5' has been pressed. The \a event
1086     parameter provides information about the event.
1087 */
1088
1089 /*!
1090     \qmlsignal QtQuick2::Keys::onDigit6Pressed(KeyEvent event)
1091
1092     This handler is called when the digit '6' has been pressed. The \a event
1093     parameter provides information about the event.
1094 */
1095
1096 /*!
1097     \qmlsignal QtQuick2::Keys::onDigit7Pressed(KeyEvent event)
1098
1099     This handler is called when the digit '7' has been pressed. The \a event
1100     parameter provides information about the event.
1101 */
1102
1103 /*!
1104     \qmlsignal QtQuick2::Keys::onDigit8Pressed(KeyEvent event)
1105
1106     This handler is called when the digit '8' has been pressed. The \a event
1107     parameter provides information about the event.
1108 */
1109
1110 /*!
1111     \qmlsignal QtQuick2::Keys::onDigit9Pressed(KeyEvent event)
1112
1113     This handler is called when the digit '9' has been pressed. The \a event
1114     parameter provides information about the event.
1115 */
1116
1117 /*!
1118     \qmlsignal QtQuick2::Keys::onLeftPressed(KeyEvent event)
1119
1120     This handler is called when the Left arrow has been pressed. The \a event
1121     parameter provides information about the event.
1122 */
1123
1124 /*!
1125     \qmlsignal QtQuick2::Keys::onRightPressed(KeyEvent event)
1126
1127     This handler is called when the Right arrow has been pressed. The \a event
1128     parameter provides information about the event.
1129 */
1130
1131 /*!
1132     \qmlsignal QtQuick2::Keys::onUpPressed(KeyEvent event)
1133
1134     This handler is called when the Up arrow has been pressed. The \a event
1135     parameter provides information about the event.
1136 */
1137
1138 /*!
1139     \qmlsignal QtQuick2::Keys::onDownPressed(KeyEvent event)
1140
1141     This handler is called when the Down arrow has been pressed. The \a event
1142     parameter provides information about the event.
1143 */
1144
1145 /*!
1146     \qmlsignal QtQuick2::Keys::onTabPressed(KeyEvent event)
1147
1148     This handler is called when the Tab key has been pressed. The \a event
1149     parameter provides information about the event.
1150 */
1151
1152 /*!
1153     \qmlsignal QtQuick2::Keys::onBacktabPressed(KeyEvent event)
1154
1155     This handler is called when the Shift+Tab key combination (Backtab) has
1156     been pressed. The \a event parameter provides information about the event.
1157 */
1158
1159 /*!
1160     \qmlsignal QtQuick2::Keys::onAsteriskPressed(KeyEvent event)
1161
1162     This handler is called when the Asterisk '*' has been pressed. The \a event
1163     parameter provides information about the event.
1164 */
1165
1166 /*!
1167     \qmlsignal QtQuick2::Keys::onEscapePressed(KeyEvent event)
1168
1169     This handler is called when the Escape key has been pressed. The \a event
1170     parameter provides information about the event.
1171 */
1172
1173 /*!
1174     \qmlsignal QtQuick2::Keys::onReturnPressed(KeyEvent event)
1175
1176     This handler is called when the Return key has been pressed. The \a event
1177     parameter provides information about the event.
1178 */
1179
1180 /*!
1181     \qmlsignal QtQuick2::Keys::onEnterPressed(KeyEvent event)
1182
1183     This handler is called when the Enter key has been pressed. The \a event
1184     parameter provides information about the event.
1185 */
1186
1187 /*!
1188     \qmlsignal QtQuick2::Keys::onDeletePressed(KeyEvent event)
1189
1190     This handler is called when the Delete key has been pressed. The \a event
1191     parameter provides information about the event.
1192 */
1193
1194 /*!
1195     \qmlsignal QtQuick2::Keys::onSpacePressed(KeyEvent event)
1196
1197     This handler is called when the Space key has been pressed. The \a event
1198     parameter provides information about the event.
1199 */
1200
1201 /*!
1202     \qmlsignal QtQuick2::Keys::onBackPressed(KeyEvent event)
1203
1204     This handler is called when the Back key has been pressed. The \a event
1205     parameter provides information about the event.
1206 */
1207
1208 /*!
1209     \qmlsignal QtQuick2::Keys::onCancelPressed(KeyEvent event)
1210
1211     This handler is called when the Cancel key has been pressed. The \a event
1212     parameter provides information about the event.
1213 */
1214
1215 /*!
1216     \qmlsignal QtQuick2::Keys::onSelectPressed(KeyEvent event)
1217
1218     This handler is called when the Select key has been pressed. The \a event
1219     parameter provides information about the event.
1220 */
1221
1222 /*!
1223     \qmlsignal QtQuick2::Keys::onYesPressed(KeyEvent event)
1224
1225     This handler is called when the Yes key has been pressed. The \a event
1226     parameter provides information about the event.
1227 */
1228
1229 /*!
1230     \qmlsignal QtQuick2::Keys::onNoPressed(KeyEvent event)
1231
1232     This handler is called when the No key has been pressed. The \a event
1233     parameter provides information about the event.
1234 */
1235
1236 /*!
1237     \qmlsignal QtQuick2::Keys::onContext1Pressed(KeyEvent event)
1238
1239     This handler is called when the Context1 key has been pressed. The \a event
1240     parameter provides information about the event.
1241 */
1242
1243 /*!
1244     \qmlsignal QtQuick2::Keys::onContext2Pressed(KeyEvent event)
1245
1246     This handler is called when the Context2 key has been pressed. The \a event
1247     parameter provides information about the event.
1248 */
1249
1250 /*!
1251     \qmlsignal QtQuick2::Keys::onContext3Pressed(KeyEvent event)
1252
1253     This handler is called when the Context3 key has been pressed. The \a event
1254     parameter provides information about the event.
1255 */
1256
1257 /*!
1258     \qmlsignal QtQuick2::Keys::onContext4Pressed(KeyEvent event)
1259
1260     This handler is called when the Context4 key has been pressed. The \a event
1261     parameter provides information about the event.
1262 */
1263
1264 /*!
1265     \qmlsignal QtQuick2::Keys::onCallPressed(KeyEvent event)
1266
1267     This handler is called when the Call key has been pressed. The \a event
1268     parameter provides information about the event.
1269 */
1270
1271 /*!
1272     \qmlsignal QtQuick2::Keys::onHangupPressed(KeyEvent event)
1273
1274     This handler is called when the Hangup key has been pressed. The \a event
1275     parameter provides information about the event.
1276 */
1277
1278 /*!
1279     \qmlsignal QtQuick2::Keys::onFlipPressed(KeyEvent event)
1280
1281     This handler is called when the Flip key has been pressed. The \a event
1282     parameter provides information about the event.
1283 */
1284
1285 /*!
1286     \qmlsignal QtQuick2::Keys::onMenuPressed(KeyEvent event)
1287
1288     This handler is called when the Menu key has been pressed. The \a event
1289     parameter provides information about the event.
1290 */
1291
1292 /*!
1293     \qmlsignal QtQuick2::Keys::onVolumeUpPressed(KeyEvent event)
1294
1295     This handler is called when the VolumeUp key has been pressed. The \a event
1296     parameter provides information about the event.
1297 */
1298
1299 /*!
1300     \qmlsignal QtQuick2::Keys::onVolumeDownPressed(KeyEvent event)
1301
1302     This handler is called when the VolumeDown key has been pressed. The \a event
1303     parameter provides information about the event.
1304 */
1305
1306 QQuickKeysAttached::QQuickKeysAttached(QObject *parent)
1307 : QObject(*(new QQuickKeysAttachedPrivate), parent),
1308   QQuickItemKeyFilter(qobject_cast<QQuickItem*>(parent))
1309 {
1310     Q_D(QQuickKeysAttached);
1311     m_processPost = false;
1312     d->item = qobject_cast<QQuickItem*>(parent);
1313 }
1314
1315 QQuickKeysAttached::~QQuickKeysAttached()
1316 {
1317 }
1318
1319 QQuickKeysAttached::Priority QQuickKeysAttached::priority() const
1320 {
1321     return m_processPost ? AfterItem : BeforeItem;
1322 }
1323
1324 void QQuickKeysAttached::setPriority(Priority order)
1325 {
1326     bool processPost = order == AfterItem;
1327     if (processPost != m_processPost) {
1328         m_processPost = processPost;
1329         emit priorityChanged();
1330     }
1331 }
1332
1333 void QQuickKeysAttached::componentComplete()
1334 {
1335     Q_D(QQuickKeysAttached);
1336     if (d->item) {
1337         for (int ii = 0; ii < d->targets.count(); ++ii) {
1338             QQuickItem *targetItem = d->targets.at(ii);
1339             if (targetItem && (targetItem->flags() & QQuickItem::ItemAcceptsInputMethod)) {
1340                 d->item->setFlag(QQuickItem::ItemAcceptsInputMethod);
1341                 break;
1342             }
1343         }
1344     }
1345 }
1346
1347 void QQuickKeysAttached::keyPressed(QKeyEvent *event, bool post)
1348 {
1349     Q_D(QQuickKeysAttached);
1350     if (post != m_processPost || !d->enabled || d->inPress) {
1351         event->ignore();
1352         QQuickItemKeyFilter::keyPressed(event, post);
1353         return;
1354     }
1355
1356     // first process forwards
1357     if (d->item && d->item->canvas()) {
1358         d->inPress = true;
1359         for (int ii = 0; ii < d->targets.count(); ++ii) {
1360             QQuickItem *i = d->targets.at(ii);
1361             if (i && i->isVisible()) {
1362                 d->item->canvas()->sendEvent(i, event);
1363                 if (event->isAccepted()) {
1364                     d->inPress = false;
1365                     return;
1366                 }
1367             }
1368         }
1369         d->inPress = false;
1370     }
1371
1372     QQuickKeyEvent ke(*event);
1373     QByteArray keySignal = keyToSignal(event->key());
1374     if (!keySignal.isEmpty()) {
1375         keySignal += "(QQuickKeyEvent*)";
1376         if (isConnected(keySignal)) {
1377             // If we specifically handle a key then default to accepted
1378             ke.setAccepted(true);
1379             int idx = QQuickKeysAttached::staticMetaObject.indexOfSignal(keySignal);
1380             metaObject()->method(idx).invoke(this, Qt::DirectConnection, Q_ARG(QQuickKeyEvent*, &ke));
1381         }
1382     }
1383     if (!ke.isAccepted())
1384         emit pressed(&ke);
1385     event->setAccepted(ke.isAccepted());
1386
1387     if (!event->isAccepted()) QQuickItemKeyFilter::keyPressed(event, post);
1388 }
1389
1390 void QQuickKeysAttached::keyReleased(QKeyEvent *event, bool post)
1391 {
1392     Q_D(QQuickKeysAttached);
1393     if (post != m_processPost || !d->enabled || d->inRelease) {
1394         event->ignore();
1395         QQuickItemKeyFilter::keyReleased(event, post);
1396         return;
1397     }
1398
1399     if (d->item && d->item->canvas()) {
1400         d->inRelease = true;
1401         for (int ii = 0; ii < d->targets.count(); ++ii) {
1402             QQuickItem *i = d->targets.at(ii);
1403             if (i && i->isVisible()) {
1404                 d->item->canvas()->sendEvent(i, event);
1405                 if (event->isAccepted()) {
1406                     d->inRelease = false;
1407                     return;
1408                 }
1409             }
1410         }
1411         d->inRelease = false;
1412     }
1413
1414     QQuickKeyEvent ke(*event);
1415     emit released(&ke);
1416     event->setAccepted(ke.isAccepted());
1417
1418     if (!event->isAccepted()) QQuickItemKeyFilter::keyReleased(event, post);
1419 }
1420
1421 void QQuickKeysAttached::inputMethodEvent(QInputMethodEvent *event, bool post)
1422 {
1423     Q_D(QQuickKeysAttached);
1424     if (post == m_processPost && d->item && !d->inIM && d->item->canvas()) {
1425         d->inIM = true;
1426         for (int ii = 0; ii < d->targets.count(); ++ii) {
1427             QQuickItem *i = d->targets.at(ii);
1428             if (i && i->isVisible() && (i->flags() & QQuickItem::ItemAcceptsInputMethod)) {
1429                 d->item->canvas()->sendEvent(i, event);
1430                 if (event->isAccepted()) {
1431                     d->imeItem = i;
1432                     d->inIM = false;
1433                     return;
1434                 }
1435             }
1436         }
1437         d->inIM = false;
1438     }
1439     QQuickItemKeyFilter::inputMethodEvent(event, post);
1440 }
1441
1442 QVariant QQuickKeysAttached::inputMethodQuery(Qt::InputMethodQuery query) const
1443 {
1444     Q_D(const QQuickKeysAttached);
1445     if (d->item) {
1446         for (int ii = 0; ii < d->targets.count(); ++ii) {
1447             QQuickItem *i = d->targets.at(ii);
1448             if (i && i->isVisible() && (i->flags() & QQuickItem::ItemAcceptsInputMethod) && i == d->imeItem) {
1449                 //### how robust is i == d->imeItem check?
1450                 QVariant v = i->inputMethodQuery(query);
1451                 if (v.userType() == QVariant::RectF)
1452                     v = d->item->mapRectFromItem(i, v.toRectF());  //### cost?
1453                 return v;
1454             }
1455         }
1456     }
1457     return QQuickItemKeyFilter::inputMethodQuery(query);
1458 }
1459
1460 QQuickKeysAttached *QQuickKeysAttached::qmlAttachedProperties(QObject *obj)
1461 {
1462     return new QQuickKeysAttached(obj);
1463 }
1464
1465 /*!
1466     \qmlclass LayoutMirroring QQuickLayoutMirroringAttached
1467     \inqmlmodule QtQuick 2
1468     \ingroup qml-utility-elements
1469     \brief The LayoutMirroring attached property is used to mirror layout behavior.
1470
1471     The LayoutMirroring attached property is used to horizontally mirror \l {anchor-layout}{Item anchors},
1472     \l{Using QML Positioner and Repeater Items}{positioner} elements (such as \l Row and \l Grid)
1473     and views (such as \l GridView and horizontal \l ListView). Mirroring is a visual change: left
1474     anchors become right anchors, and positioner elements like \l Grid and \l Row reverse the
1475     horizontal layout of child items.
1476
1477     Mirroring is enabled for an item by setting the \l enabled property to true. By default, this
1478     only affects the item itself; setting the \l childrenInherit property to true propagates the mirroring
1479     behavior to all child elements as well. If the \c LayoutMirroring attached property has not been defined
1480     for an item, mirroring is not enabled.
1481
1482     The following example shows mirroring in action. The \l Row below is specified as being anchored
1483     to the left of its parent. However, since mirroring has been enabled, the anchor is horizontally
1484     reversed and it is now anchored to the right. Also, since items in a \l Row are positioned
1485     from left to right by default, they are now positioned from right to left instead, as demonstrated
1486     by the numbering and opacity of the items:
1487
1488     \snippet doc/src/snippets/qml/layoutmirroring.qml 0
1489
1490     \image layoutmirroring.png
1491
1492     Layout mirroring is useful when it is necessary to support both left-to-right and right-to-left
1493     layout versions of an application to target different language areas. The \l childrenInherit
1494     property allows layout mirroring to be applied without manually setting layout configurations
1495     for every item in an application. Keep in mind, however, that mirroring does not affect any
1496     positioning that is defined by the \l Item \l {Item::}{x} coordinate value, so even with
1497     mirroring enabled, it will often be necessary to apply some layout fixes to support the
1498     desired layout direction. Also, it may be necessary to disable the mirroring of individual
1499     child items (by setting \l {enabled}{LayoutMirroring.enabled} to false for such items) if
1500     mirroring is not the desired behavior, or if the child item already implements mirroring in
1501     some custom way.
1502
1503     See \l {QML Right-to-left User Interfaces} for further details on using \c LayoutMirroring and
1504     other related features to implement right-to-left support for an application.
1505 */
1506
1507 /*!
1508     \qmlproperty bool QtQuick2::LayoutMirroring::enabled
1509
1510     This property holds whether the item's layout is mirrored horizontally. Setting this to true
1511     horizontally reverses \l {anchor-layout}{anchor} settings such that left anchors become right,
1512     and right anchors become left. For \l{Using QML Positioner and Repeater Items}{positioner} elements
1513     (such as \l Row and \l Grid) and view elements (such as \l {GridView}{GridView} and \l {ListView}{ListView})
1514     this also mirrors the horizontal layout direction of the item.
1515
1516     The default value is false.
1517 */
1518
1519 /*!
1520     \qmlproperty bool QtQuick2::LayoutMirroring::childrenInherit
1521
1522     This property holds whether the \l {enabled}{LayoutMirroring.enabled} value for this item
1523     is inherited by its children.
1524
1525     The default value is false.
1526 */
1527
1528
1529 QQuickLayoutMirroringAttached::QQuickLayoutMirroringAttached(QObject *parent) : QObject(parent), itemPrivate(0)
1530 {
1531     if (QQuickItem *item = qobject_cast<QQuickItem*>(parent)) {
1532         itemPrivate = QQuickItemPrivate::get(item);
1533         itemPrivate->extra.value().layoutDirectionAttached = this;
1534     } else
1535         qmlInfo(parent) << tr("LayoutDirection attached property only works with Items");
1536 }
1537
1538 QQuickLayoutMirroringAttached * QQuickLayoutMirroringAttached::qmlAttachedProperties(QObject *object)
1539 {
1540     return new QQuickLayoutMirroringAttached(object);
1541 }
1542
1543 bool QQuickLayoutMirroringAttached::enabled() const
1544 {
1545     return itemPrivate ? itemPrivate->effectiveLayoutMirror : false;
1546 }
1547
1548 void QQuickLayoutMirroringAttached::setEnabled(bool enabled)
1549 {
1550     if (!itemPrivate)
1551         return;
1552
1553     itemPrivate->isMirrorImplicit = false;
1554     if (enabled != itemPrivate->effectiveLayoutMirror) {
1555         itemPrivate->setLayoutMirror(enabled);
1556         if (itemPrivate->inheritMirrorFromItem)
1557              itemPrivate->resolveLayoutMirror();
1558     }
1559 }
1560
1561 void QQuickLayoutMirroringAttached::resetEnabled()
1562 {
1563     if (itemPrivate && !itemPrivate->isMirrorImplicit) {
1564         itemPrivate->isMirrorImplicit = true;
1565         itemPrivate->resolveLayoutMirror();
1566     }
1567 }
1568
1569 bool QQuickLayoutMirroringAttached::childrenInherit() const
1570 {
1571     return itemPrivate ? itemPrivate->inheritMirrorFromItem : false;
1572 }
1573
1574 void QQuickLayoutMirroringAttached::setChildrenInherit(bool childrenInherit) {
1575     if (itemPrivate && childrenInherit != itemPrivate->inheritMirrorFromItem) {
1576         itemPrivate->inheritMirrorFromItem = childrenInherit;
1577         itemPrivate->resolveLayoutMirror();
1578         childrenInheritChanged();
1579     }
1580 }
1581
1582 void QQuickItemPrivate::resolveLayoutMirror()
1583 {
1584     Q_Q(QQuickItem);
1585     if (QQuickItem *parentItem = q->parentItem()) {
1586         QQuickItemPrivate *parentPrivate = QQuickItemPrivate::get(parentItem);
1587         setImplicitLayoutMirror(parentPrivate->inheritedLayoutMirror, parentPrivate->inheritMirrorFromParent);
1588     } else {
1589         setImplicitLayoutMirror(isMirrorImplicit ? false : effectiveLayoutMirror, inheritMirrorFromItem);
1590     }
1591 }
1592
1593 void QQuickItemPrivate::setImplicitLayoutMirror(bool mirror, bool inherit)
1594 {
1595     inherit = inherit || inheritMirrorFromItem;
1596     if (!isMirrorImplicit && inheritMirrorFromItem)
1597         mirror = effectiveLayoutMirror;
1598     if (mirror == inheritedLayoutMirror && inherit == inheritMirrorFromParent)
1599         return;
1600
1601     inheritMirrorFromParent = inherit;
1602     inheritedLayoutMirror = inheritMirrorFromParent ? mirror : false;
1603
1604     if (isMirrorImplicit)
1605         setLayoutMirror(inherit ? inheritedLayoutMirror : false);
1606     for (int i = 0; i < childItems.count(); ++i) {
1607         if (QQuickItem *child = qobject_cast<QQuickItem *>(childItems.at(i))) {
1608             QQuickItemPrivate *childPrivate = QQuickItemPrivate::get(child);
1609             childPrivate->setImplicitLayoutMirror(inheritedLayoutMirror, inheritMirrorFromParent);
1610         }
1611     }
1612 }
1613
1614 void QQuickItemPrivate::setLayoutMirror(bool mirror)
1615 {
1616     if (mirror != effectiveLayoutMirror) {
1617         effectiveLayoutMirror = mirror;
1618         if (_anchors) {
1619             QQuickAnchorsPrivate *anchor_d = QQuickAnchorsPrivate::get(_anchors);
1620             anchor_d->fillChanged();
1621             anchor_d->centerInChanged();
1622             anchor_d->updateHorizontalAnchors();
1623             emit _anchors->mirroredChanged();
1624         }
1625         mirrorChange();
1626         if (extra.isAllocated() && extra->layoutDirectionAttached) {
1627             emit extra->layoutDirectionAttached->enabledChanged();
1628         }
1629     }
1630 }
1631
1632 void QQuickItemPrivate::setAccessibleFlagAndListener()
1633 {
1634     Q_Q(QQuickItem);
1635     QQuickItem *item = q;
1636     while (item) {
1637         if (item->d_func()->isAccessible)
1638             break; // already set - grandparents should have the flag set as well.
1639
1640         item->d_func()->isAccessible = true;
1641         item = item->d_func()->parentItem;
1642     }
1643 }
1644
1645 void QQuickItemPrivate::updateSubFocusItem(QQuickItem *scope, bool focus)
1646 {
1647     Q_Q(QQuickItem);
1648     Q_ASSERT(scope);
1649
1650     QQuickItemPrivate *scopePrivate = QQuickItemPrivate::get(scope);
1651
1652     QQuickItem *oldSubFocusItem = scopePrivate->subFocusItem;
1653     // Correct focus chain in scope
1654     if (oldSubFocusItem) {
1655         QQuickItem *sfi = scopePrivate->subFocusItem->parentItem();
1656         while (sfi && sfi != scope) {
1657             QQuickItemPrivate::get(sfi)->subFocusItem = 0;
1658             sfi = sfi->parentItem();
1659         }
1660     }
1661
1662     if (focus) {
1663         scopePrivate->subFocusItem = q;
1664         QQuickItem *sfi = scopePrivate->subFocusItem->parentItem();
1665         while (sfi && sfi != scope) {
1666             QQuickItemPrivate::get(sfi)->subFocusItem = q;
1667             sfi = sfi->parentItem();
1668         }
1669     } else {
1670         scopePrivate->subFocusItem = 0;
1671     }
1672 }
1673
1674
1675 /*!
1676     \class QQuickItem
1677     \brief The QQuickItem class provides the most basic of all visual items in QML.
1678
1679     \inmodule QtQuick
1680
1681     All visual items in Qt Quick inherit from QQuickItem.  Although QQuickItem
1682     has no visual appearance, it defines all the properties that are
1683     common across visual items - such as the x and y position, the
1684     width and height, \l {anchor-layout}{anchoring} and key handling.
1685
1686     You can subclass QQuickItem to provide your own custom visual item
1687     that inherits these features.
1688
1689     \section1 Custom Items using Scene Graph
1690
1691     All visual QML items are rendered using the scene graph, a
1692     low-level, high-performance rendering stack, closely tied to
1693     OpenGL. It is possible for subclasses of QQuickItem to add their
1694     own custom content into the scene graph by setting the
1695     QQuickItem::ItemHasContents flag and reimplementing the
1696     QQuickItem::updatePaintNode() function.
1697
1698     \warning It is crucial that OpenGL operations and interaction with
1699     the scene graph happens exclusively on the rendering thread,
1700     primarily during the updatePaintNode() call. The best rule of
1701     thumb is to only use classes with the "QSG" prefix inside the
1702     QQuickItem::updatePaintNode() function.
1703
1704     To read more about how the scene graph rendering works, see
1705     \l{Scene Graph and Rendering}
1706
1707     \section1 Custom Items using QPainter
1708
1709     The QQuickItem provides a subclass, QQuickPaintedItem, which
1710     allows the users to render content using QPainter.
1711
1712     \warning Using QQuickPaintedItem uses an indirect 2D surface to
1713     render its content, either using software rasterization or using
1714     an OpenGL framebuffer object (FBO), so the rendering is a two-step
1715     operation. First rasterize the surface, then draw the
1716     surface. Using scene graph API directly is always significantly
1717     faster.
1718
1719     \sa QQuickCanvas, QQuickPaintedItem
1720 */
1721
1722 /*!
1723     \qmlclass Item QQuickItem
1724     \inherits QtObject
1725     \inqmlmodule QtQuick 2
1726     \ingroup qml-basic-visual-elements
1727     \brief The Item is the most basic of all visual items in QML.
1728
1729     All visual items in Qt Quick inherit from Item.  Although Item
1730     has no visual appearance, it defines all the properties that are
1731     common across visual items - such as the x and y position, the
1732     width and height, \l {anchor-layout}{anchoring} and key handling.
1733
1734     Item is also useful for grouping items together.
1735
1736     \qml
1737     Item {
1738         Image {
1739             source: "tile.png"
1740         }
1741         Image {
1742             x: 80
1743             width: 100
1744             height: 100
1745             source: "tile.png"
1746         }
1747         Image {
1748             x: 190
1749             width: 100
1750             height: 100
1751             fillMode: Image.Tile
1752             source: "tile.png"
1753         }
1754     }
1755     \endqml
1756
1757
1758     \section1 Key Handling
1759
1760     Key handling is available to all Item-based visual elements via the \l {Keys}{Keys}
1761     attached property.  The \e Keys attached property provides basic handlers such
1762     as \l {Keys::onPressed}{onPressed} and \l {Keys::onReleased}{onReleased},
1763     as well as handlers for specific keys, such as
1764     \l {Keys::onCancelPressed}{onCancelPressed}.  The example below
1765     assigns \l {qmlfocus}{focus} to the item and handles
1766     the Left key via the general \e onPressed handler and the Select key via the
1767     onSelectPressed handler:
1768
1769     \qml
1770     Item {
1771         focus: true
1772         Keys.onPressed: {
1773             if (event.key == Qt.Key_Left) {
1774                 console.log("move left");
1775                 event.accepted = true;
1776             }
1777         }
1778         Keys.onSelectPressed: console.log("Selected");
1779     }
1780     \endqml
1781
1782     See the \l {Keys}{Keys} attached property for detailed documentation.
1783
1784     \section1 Layout Mirroring
1785
1786     Item layouts can be mirrored using the \l {LayoutMirroring}{LayoutMirroring} attached property.
1787
1788 */
1789
1790 /*!
1791     \fn void QQuickItem::childrenRectChanged(const QRectF &)
1792     \internal
1793 */
1794
1795 /*!
1796     \fn void QQuickItem::baselineOffsetChanged(qreal)
1797     \internal
1798 */
1799
1800 /*!
1801     \fn void QQuickItem::stateChanged(const QString &state)
1802     \internal
1803 */
1804
1805 /*!
1806     \fn void QQuickItem::parentChanged(QQuickItem *)
1807     \internal
1808 */
1809
1810 /*!
1811     \fn void QQuickItem::smoothChanged(bool)
1812     \internal
1813 */
1814
1815 /*!
1816     \fn void QQuickItem::clipChanged(bool)
1817     \internal
1818 */
1819
1820 /*! \fn void QQuickItem::transformOriginChanged(TransformOrigin)
1821   \internal
1822 */
1823
1824 /*!
1825     \fn void QQuickItem::focusChanged(bool)
1826     \internal
1827 */
1828
1829 /*!
1830     \fn void QQuickItem::activeFocusChanged(bool)
1831     \internal
1832 */
1833 /*!
1834     \fn QQuickItem::QQuickItem(QQuickItem *parent)
1835
1836     Constructs a QQuickItem with the given \a parent.
1837 */
1838 QQuickItem::QQuickItem(QQuickItem* parent)
1839 : QObject(*(new QQuickItemPrivate), parent)
1840 {
1841     Q_D(QQuickItem);
1842     d->init(parent);
1843 }
1844
1845 /*! \internal
1846 */
1847 QQuickItem::QQuickItem(QQuickItemPrivate &dd, QQuickItem *parent)
1848 : QObject(dd, parent)
1849 {
1850     Q_D(QQuickItem);
1851     d->init(parent);
1852 }
1853
1854 #ifndef QT_NO_DEBUG
1855 static int qt_item_count = 0;
1856
1857 static void qt_print_item_count()
1858 {
1859     qDebug("Number of leaked items: %i", qt_item_count);
1860     qt_item_count = -1;
1861 }
1862 #endif
1863
1864 /*!
1865     Destroys the QQuickItem.
1866 */
1867 QQuickItem::~QQuickItem()
1868 {
1869 #ifndef QT_NO_DEBUG
1870     --qt_item_count;
1871     if (qt_item_count < 0)
1872         qDebug("Item destroyed after qt_print_item_count() was called.");
1873 #endif
1874
1875     Q_D(QQuickItem);
1876
1877     if (d->canvasRefCount > 1)
1878         d->canvasRefCount = 1; // Make sure canvas is set to null in next call to derefCanvas().
1879     if (d->parentItem)
1880         setParentItem(0);
1881     else if (d->canvas)
1882         d->derefCanvas();
1883
1884     // XXX todo - optimize
1885     while (!d->childItems.isEmpty())
1886         d->childItems.first()->setParentItem(0);
1887
1888     for (int ii = 0; ii < d->changeListeners.count(); ++ii) {
1889         QQuickAnchorsPrivate *anchor = d->changeListeners.at(ii).listener->anchorPrivate();
1890         if (anchor)
1891             anchor->clearItem(this);
1892     }
1893
1894     /*
1895         update item anchors that depended on us unless they are our child (and will also be destroyed),
1896         or our sibling, and our parent is also being destroyed.
1897     */
1898     for (int ii = 0; ii < d->changeListeners.count(); ++ii) {
1899         QQuickAnchorsPrivate *anchor = d->changeListeners.at(ii).listener->anchorPrivate();
1900         if (anchor && anchor->item && anchor->item->parentItem() && anchor->item->parentItem() != this)
1901             anchor->update();
1902     }
1903
1904     for (int ii = 0; ii < d->changeListeners.count(); ++ii) {
1905         const QQuickItemPrivate::ChangeListener &change = d->changeListeners.at(ii);
1906         if (change.types & QQuickItemPrivate::Destroyed)
1907             change.listener->itemDestroyed(this);
1908     }
1909
1910     d->changeListeners.clear();
1911
1912     if (d->extra.isAllocated()) {
1913         delete d->extra->contents; d->extra->contents = 0;
1914         delete d->extra->layer; d->extra->layer = 0;
1915     }
1916
1917     delete d->_anchors; d->_anchors = 0;
1918     delete d->_stateGroup; d->_stateGroup = 0;
1919 }
1920
1921 /*!
1922     \qmlproperty enumeration QtQuick2::Item::transformOrigin
1923     This property holds the origin point around which scale and rotation transform.
1924
1925     Nine transform origins are available, as shown in the image below.
1926
1927     \image declarative-transformorigin.png
1928
1929     This example rotates an image around its bottom-right corner.
1930     \qml
1931     Image {
1932         source: "myimage.png"
1933         transformOrigin: Item.BottomRight
1934         rotation: 45
1935     }
1936     \endqml
1937
1938     The default transform origin is \c Item.Center.
1939
1940     To set an arbitrary transform origin point use the \l Scale or \l Rotation
1941     transform elements.
1942 */
1943
1944 /*!
1945     \qmlproperty Item QtQuick2::Item::parent
1946     This property holds the parent of the item.
1947 */
1948
1949 /*!
1950     \property QQuickItem::parent
1951     This property holds the parent of the item.
1952 */
1953 void QQuickItem::setParentItem(QQuickItem *parentItem)
1954 {
1955     Q_D(QQuickItem);
1956     if (parentItem == d->parentItem)
1957         return;
1958
1959     if (parentItem) {
1960         QQuickItem *itemAncestor = parentItem->parentItem();
1961         while (itemAncestor != 0) {
1962             if (itemAncestor == this) {
1963                 qWarning("QQuickItem::setParentItem: Parent is already part of this items subtree.");
1964                 return;
1965             }
1966             itemAncestor = itemAncestor->parentItem();
1967         }
1968     }
1969
1970     d->removeFromDirtyList();
1971
1972     QQuickItem *oldParentItem = d->parentItem;
1973     QQuickItem *scopeFocusedItem = 0;
1974
1975     if (oldParentItem) {
1976         QQuickItemPrivate *op = QQuickItemPrivate::get(oldParentItem);
1977
1978         QQuickItem *scopeItem = 0;
1979
1980         if (hasFocus())
1981             scopeFocusedItem = this;
1982         else if (!isFocusScope() && d->subFocusItem)
1983             scopeFocusedItem = d->subFocusItem;
1984
1985         if (scopeFocusedItem) {
1986             scopeItem = oldParentItem;
1987             while (!scopeItem->isFocusScope() && scopeItem->parentItem())
1988                 scopeItem = scopeItem->parentItem();
1989             if (d->canvas) {
1990                 QQuickCanvasPrivate::get(d->canvas)->clearFocusInScope(scopeItem, scopeFocusedItem,
1991                                                                 QQuickCanvasPrivate::DontChangeFocusProperty);
1992                 if (scopeFocusedItem != this)
1993                     QQuickItemPrivate::get(scopeFocusedItem)->updateSubFocusItem(this, true);
1994             } else {
1995                 QQuickItemPrivate::get(scopeFocusedItem)->updateSubFocusItem(scopeItem, false);
1996             }
1997         }
1998
1999         const bool wasVisible = isVisible();
2000         op->removeChild(this);
2001         if (wasVisible) {
2002             emit oldParentItem->visibleChildrenChanged();
2003         }
2004     } else if (d->canvas) {
2005         QQuickCanvasPrivate::get(d->canvas)->parentlessItems.remove(this);
2006     }
2007
2008     QQuickCanvas *oldParentCanvas = oldParentItem ? QQuickItemPrivate::get(oldParentItem)->canvas : 0;
2009     QQuickCanvas *parentCanvas = parentItem ? QQuickItemPrivate::get(parentItem)->canvas : 0;
2010     if (oldParentCanvas == parentCanvas) {
2011         // Avoid freeing and reallocating resources if the canvas stays the same.
2012         d->parentItem = parentItem;
2013     } else {
2014         if (oldParentCanvas)
2015             d->derefCanvas();
2016         d->parentItem = parentItem;
2017         if (parentCanvas)
2018             d->refCanvas(parentCanvas);
2019     }
2020
2021     d->dirty(QQuickItemPrivate::ParentChanged);
2022
2023     if (d->parentItem)
2024         QQuickItemPrivate::get(d->parentItem)->addChild(this);
2025     else if (d->canvas)
2026         QQuickCanvasPrivate::get(d->canvas)->parentlessItems.insert(this);
2027
2028     d->setEffectiveVisibleRecur(d->calcEffectiveVisible());
2029     d->setEffectiveEnableRecur(0, d->calcEffectiveEnable());
2030
2031     if (d->parentItem) {
2032         if (!scopeFocusedItem) {
2033             if (hasFocus())
2034                 scopeFocusedItem = this;
2035             else if (!isFocusScope() && d->subFocusItem)
2036                 scopeFocusedItem = d->subFocusItem;
2037         }
2038
2039         if (scopeFocusedItem) {
2040             // We need to test whether this item becomes scope focused
2041             QQuickItem *scopeItem = d->parentItem;
2042             while (!scopeItem->isFocusScope() && scopeItem->parentItem())
2043                 scopeItem = scopeItem->parentItem();
2044
2045             if (QQuickItemPrivate::get(scopeItem)->subFocusItem
2046                     || (!scopeItem->isFocusScope() && scopeItem->hasFocus())) {
2047                 if (scopeFocusedItem != this)
2048                     QQuickItemPrivate::get(scopeFocusedItem)->updateSubFocusItem(this, false);
2049                 QQuickItemPrivate::get(scopeFocusedItem)->focus = false;
2050                 emit scopeFocusedItem->focusChanged(false);
2051             } else {
2052                 if (d->canvas) {
2053                     QQuickCanvasPrivate::get(d->canvas)->setFocusInScope(scopeItem, scopeFocusedItem,
2054                                                                   QQuickCanvasPrivate::DontChangeFocusProperty);
2055                 } else {
2056                     QQuickItemPrivate::get(scopeFocusedItem)->updateSubFocusItem(scopeItem, true);
2057                 }
2058             }
2059         }
2060     }
2061
2062     d->resolveLayoutMirror();
2063
2064     d->itemChange(ItemParentHasChanged, d->parentItem);
2065
2066     d->parentNotifier.notify();
2067     if (d->isAccessible && d->parentItem) {
2068         d->parentItem->d_func()->setAccessibleFlagAndListener();
2069     }
2070
2071     emit parentChanged(d->parentItem);
2072     if (isVisible() && d->parentItem)
2073         emit d->parentItem->visibleChildrenChanged();
2074 }
2075
2076 void QQuickItem::stackBefore(const QQuickItem *sibling)
2077 {
2078     Q_D(QQuickItem);
2079     if (!sibling || sibling == this || !d->parentItem || d->parentItem != QQuickItemPrivate::get(sibling)->parentItem) {
2080         qWarning("QQuickItem::stackBefore: Cannot stack before %p, which must be a sibling", sibling);
2081         return;
2082     }
2083
2084     QQuickItemPrivate *parentPrivate = QQuickItemPrivate::get(d->parentItem);
2085
2086     int myIndex = parentPrivate->childItems.indexOf(this);
2087     int siblingIndex = parentPrivate->childItems.indexOf(const_cast<QQuickItem *>(sibling));
2088
2089     Q_ASSERT(myIndex != -1 && siblingIndex != -1);
2090
2091     if (myIndex == siblingIndex - 1)
2092         return;
2093
2094     parentPrivate->childItems.removeAt(myIndex);
2095
2096     if (myIndex < siblingIndex) --siblingIndex;
2097
2098     parentPrivate->childItems.insert(siblingIndex, this);
2099
2100     parentPrivate->dirty(QQuickItemPrivate::ChildrenStackingChanged);
2101     parentPrivate->markSortedChildrenDirty(this);
2102
2103     for (int ii = qMin(siblingIndex, myIndex); ii < parentPrivate->childItems.count(); ++ii)
2104         QQuickItemPrivate::get(parentPrivate->childItems.at(ii))->siblingOrderChanged();
2105 }
2106
2107 void QQuickItem::stackAfter(const QQuickItem *sibling)
2108 {
2109     Q_D(QQuickItem);
2110     if (!sibling || sibling == this || !d->parentItem || d->parentItem != QQuickItemPrivate::get(sibling)->parentItem) {
2111         qWarning("QQuickItem::stackAfter: Cannot stack after %p, which must be a sibling", sibling);
2112         return;
2113     }
2114
2115     QQuickItemPrivate *parentPrivate = QQuickItemPrivate::get(d->parentItem);
2116
2117     int myIndex = parentPrivate->childItems.indexOf(this);
2118     int siblingIndex = parentPrivate->childItems.indexOf(const_cast<QQuickItem *>(sibling));
2119
2120     Q_ASSERT(myIndex != -1 && siblingIndex != -1);
2121
2122     if (myIndex == siblingIndex + 1)
2123         return;
2124
2125     parentPrivate->childItems.removeAt(myIndex);
2126
2127     if (myIndex < siblingIndex) --siblingIndex;
2128
2129     parentPrivate->childItems.insert(siblingIndex + 1, this);
2130
2131     parentPrivate->dirty(QQuickItemPrivate::ChildrenStackingChanged);
2132     parentPrivate->markSortedChildrenDirty(this);
2133
2134     for (int ii = qMin(myIndex, siblingIndex + 1); ii < parentPrivate->childItems.count(); ++ii)
2135         QQuickItemPrivate::get(parentPrivate->childItems.at(ii))->siblingOrderChanged();
2136 }
2137
2138 /*!
2139     Returns the QQuickItem parent of this item.
2140 */
2141 QQuickItem *QQuickItem::parentItem() const
2142 {
2143     Q_D(const QQuickItem);
2144     return d->parentItem;
2145 }
2146
2147 QQuickCanvas *QQuickItem::canvas() const
2148 {
2149     Q_D(const QQuickItem);
2150     return d->canvas;
2151 }
2152
2153 static bool itemZOrder_sort(QQuickItem *lhs, QQuickItem *rhs)
2154 {
2155     return lhs->z() < rhs->z();
2156 }
2157
2158 QList<QQuickItem *> QQuickItemPrivate::paintOrderChildItems() const
2159 {
2160     if (sortedChildItems)
2161         return *sortedChildItems;
2162
2163     // If none of the items have set Z then the paint order list is the same as
2164     // the childItems list.  This is by far the most common case.
2165     bool haveZ = false;
2166     for (int i = 0; i < childItems.count(); ++i) {
2167         if (QQuickItemPrivate::get(childItems.at(i))->z() != 0.) {
2168             haveZ = true;
2169             break;
2170         }
2171     }
2172     if (haveZ) {
2173         sortedChildItems = new QList<QQuickItem*>(childItems);
2174         qStableSort(sortedChildItems->begin(), sortedChildItems->end(), itemZOrder_sort);
2175         return *sortedChildItems;
2176     }
2177
2178     sortedChildItems = const_cast<QList<QQuickItem*>*>(&childItems);
2179
2180     return childItems;
2181 }
2182
2183 void QQuickItemPrivate::addChild(QQuickItem *child)
2184 {
2185     Q_Q(QQuickItem);
2186
2187     Q_ASSERT(!childItems.contains(child));
2188
2189     childItems.append(child);
2190
2191     markSortedChildrenDirty(child);
2192     dirty(QQuickItemPrivate::ChildrenChanged);
2193
2194     itemChange(QQuickItem::ItemChildAddedChange, child);
2195
2196     emit q->childrenChanged();
2197 }
2198
2199 void QQuickItemPrivate::removeChild(QQuickItem *child)
2200 {
2201     Q_Q(QQuickItem);
2202
2203     Q_ASSERT(child);
2204     Q_ASSERT(childItems.contains(child));
2205     childItems.removeOne(child);
2206     Q_ASSERT(!childItems.contains(child));
2207
2208     markSortedChildrenDirty(child);
2209     dirty(QQuickItemPrivate::ChildrenChanged);
2210
2211     itemChange(QQuickItem::ItemChildRemovedChange, child);
2212
2213     emit q->childrenChanged();
2214 }
2215
2216 void QQuickItemPrivate::InitializationState::clear()
2217 {
2218     focusScope = 0;
2219 }
2220
2221 void QQuickItemPrivate::InitializationState::clear(QQuickItem *fs)
2222 {
2223     focusScope = fs;
2224 }
2225
2226 QQuickItem *QQuickItemPrivate::InitializationState::getFocusScope(QQuickItem *item)
2227 {
2228     if (!focusScope) {
2229         QQuickItem *fs = item->parentItem();
2230         while (fs->parentItem() && !fs->isFocusScope())
2231             fs = fs->parentItem();
2232         focusScope = fs;
2233     }
2234     return focusScope;
2235 }
2236
2237 void QQuickItemPrivate::refCanvas(InitializationState *state, QQuickCanvas *c)
2238 {
2239     // An item needs a canvas if it is referenced by another item which has a canvas.
2240     // Typically the item is referenced by a parent, but can also be referenced by a
2241     // ShaderEffect or ShaderEffectSource. 'canvasRefCount' counts how many items with
2242     // a canvas is referencing this item. When the reference count goes from zero to one,
2243     // or one to zero, the canvas of this item is updated and propagated to the children.
2244     // As long as the reference count stays above zero, the canvas is unchanged.
2245     // refCanvas() increments the reference count.
2246     // derefCanvas() decrements the reference count.
2247
2248     Q_Q(QQuickItem);
2249     Q_ASSERT((canvas != 0) == (canvasRefCount > 0));
2250     Q_ASSERT(c);
2251     if (++canvasRefCount > 1) {
2252         if (c != canvas)
2253             qWarning("QQuickItem: Cannot use same item on different canvases at the same time.");
2254         return; // Canvas already set.
2255     }
2256
2257     Q_ASSERT(canvas == 0);
2258     canvas = c;
2259
2260     if (polishScheduled)
2261         QQuickCanvasPrivate::get(canvas)->itemsToPolish.insert(q);
2262
2263     InitializationState _dummy;
2264     InitializationState *childState = state;
2265
2266     if (q->isFocusScope()) {
2267         _dummy.clear(q);
2268         childState = &_dummy;
2269     }
2270
2271     if (!parentItem)
2272         QQuickCanvasPrivate::get(canvas)->parentlessItems.insert(q);
2273
2274     for (int ii = 0; ii < childItems.count(); ++ii) {
2275         QQuickItem *child = childItems.at(ii);
2276         QQuickItemPrivate::get(child)->refCanvas(childState, c);
2277     }
2278
2279     dirty(Canvas);
2280
2281     if (extra.isAllocated() && extra->screenAttached)
2282         extra->screenAttached->canvasChanged(c);
2283     itemChange(QQuickItem::ItemSceneChange, c);
2284 }
2285
2286 void QQuickItemPrivate::derefCanvas()
2287 {
2288     Q_Q(QQuickItem);
2289     Q_ASSERT((canvas != 0) == (canvasRefCount > 0));
2290
2291     if (!canvas)
2292         return; // This can happen when destroying recursive shader effect sources.
2293
2294     if (--canvasRefCount > 0)
2295         return; // There are still other references, so don't set canvas to null yet.
2296
2297     q->releaseResources();
2298     removeFromDirtyList();
2299     QQuickCanvasPrivate *c = QQuickCanvasPrivate::get(canvas);
2300     if (polishScheduled)
2301         c->itemsToPolish.remove(q);
2302     if (c->mouseGrabberItem == q)
2303         c->mouseGrabberItem = 0;
2304     if ( hoverEnabled )
2305         c->hoverItems.removeAll(q);
2306     if (itemNodeInstance)
2307         c->cleanup(itemNodeInstance);
2308     if (!parentItem)
2309         c->parentlessItems.remove(q);
2310
2311     canvas = 0;
2312
2313     itemNodeInstance = 0;
2314
2315     if (extra.isAllocated()) {
2316         extra->opacityNode = 0;
2317         extra->clipNode = 0;
2318         extra->rootNode = 0;
2319         extra->beforePaintNode = 0;
2320     }
2321
2322     groupNode = 0;
2323     paintNode = 0;
2324
2325     for (int ii = 0; ii < childItems.count(); ++ii) {
2326         QQuickItem *child = childItems.at(ii);
2327         QQuickItemPrivate::get(child)->derefCanvas();
2328     }
2329
2330     dirty(Canvas);
2331
2332     if (extra.isAllocated() && extra->screenAttached)
2333         extra->screenAttached->canvasChanged(0);
2334     itemChange(QQuickItem::ItemSceneChange, (QQuickCanvas *)0);
2335 }
2336
2337
2338 /*!
2339 Returns a transform that maps points from canvas space into item space.
2340 */
2341 QTransform QQuickItemPrivate::canvasToItemTransform() const
2342 {
2343     // XXX todo - optimize
2344     return itemToCanvasTransform().inverted();
2345 }
2346
2347 /*!
2348 Returns a transform that maps points from item space into canvas space.
2349 */
2350 QTransform QQuickItemPrivate::itemToCanvasTransform() const
2351 {
2352     // XXX todo
2353     QTransform rv = parentItem?QQuickItemPrivate::get(parentItem)->itemToCanvasTransform():QTransform();
2354     itemToParentTransform(rv);
2355     return rv;
2356 }
2357
2358 /*!
2359 Motifies \a t with this items local transform relative to its parent.
2360 */
2361 void QQuickItemPrivate::itemToParentTransform(QTransform &t) const
2362 {
2363     if (x || y)
2364         t.translate(x, y);
2365
2366     if (!transforms.isEmpty()) {
2367         QMatrix4x4 m(t);
2368         for (int ii = transforms.count() - 1; ii >= 0; --ii)
2369             transforms.at(ii)->applyTo(&m);
2370         t = m.toTransform();
2371     }
2372
2373     if (scale() != 1. || rotation() != 0.) {
2374         QPointF tp = computeTransformOrigin();
2375         t.translate(tp.x(), tp.y());
2376         t.scale(scale(), scale());
2377         t.rotate(rotation());
2378         t.translate(-tp.x(), -tp.y());
2379     }
2380 }
2381
2382
2383 /*!
2384     \qmlproperty real QtQuick2::Item::childrenRect.x
2385     \qmlproperty real QtQuick2::Item::childrenRect.y
2386     \qmlproperty real QtQuick2::Item::childrenRect.width
2387     \qmlproperty real QtQuick2::Item::childrenRect.height
2388
2389     The childrenRect properties allow an item access to the geometry of its
2390     children. This property is useful if you have an item that needs to be
2391     sized to fit its children.
2392 */
2393
2394
2395 /*!
2396     \qmlproperty list<Item> QtQuick2::Item::children
2397     \qmlproperty list<Object> QtQuick2::Item::resources
2398
2399     The children property contains the list of visual children of this item.
2400     The resources property contains non-visual resources that you want to
2401     reference by name.
2402
2403     Generally you can rely on Item's default property to handle all this for
2404     you, but it can come in handy in some cases.
2405
2406     \qml
2407     Item {
2408         children: [
2409             Text {},
2410             Rectangle {}
2411         ]
2412         resources: [
2413             Component {
2414                 id: myComponent
2415                 Text {}
2416             }
2417         ]
2418     }
2419     \endqml
2420 */
2421
2422 /*!
2423     Returns true if construction of the QML component is complete; otherwise
2424     returns false.
2425
2426     It is often desirable to delay some processing until the component is
2427     completed.
2428
2429     \sa componentComplete()
2430 */
2431 bool QQuickItem::isComponentComplete() const
2432 {
2433     Q_D(const QQuickItem);
2434     return d->componentComplete;
2435 }
2436
2437 QQuickItemPrivate::QQuickItemPrivate()
2438 : _anchors(0), _stateGroup(0),
2439   flags(0), widthValid(false), heightValid(false), baselineOffsetValid(false), componentComplete(true),
2440   keepMouse(false), keepTouch(false), hoverEnabled(false), smooth(true), focus(false), activeFocus(false), notifiedFocus(false),
2441   notifiedActiveFocus(false), filtersChildMouseEvents(false), explicitVisible(true),
2442   effectiveVisible(true), explicitEnable(true), effectiveEnable(true), polishScheduled(false),
2443   inheritedLayoutMirror(false), effectiveLayoutMirror(false), isMirrorImplicit(true),
2444   inheritMirrorFromParent(false), inheritMirrorFromItem(false), childrenDoNotOverlap(false),
2445   staticSubtreeGeometry(false),
2446   isAccessible(false),
2447
2448   dirtyAttributes(0), nextDirtyItem(0), prevDirtyItem(0),
2449
2450   canvas(0), canvasRefCount(0), parentItem(0), sortedChildItems(&childItems),
2451
2452   subFocusItem(0),
2453
2454   x(0), y(0), width(0), height(0), implicitWidth(0), implicitHeight(0),
2455
2456   baselineOffset(0),
2457
2458   itemNodeInstance(0), groupNode(0), paintNode(0)
2459 {
2460 }
2461
2462 QQuickItemPrivate::~QQuickItemPrivate()
2463 {
2464     if (sortedChildItems != &childItems)
2465         delete sortedChildItems;
2466 }
2467
2468 void QQuickItemPrivate::init(QQuickItem *parent)
2469 {
2470 #ifndef QT_NO_DEBUG
2471     ++qt_item_count;
2472     static bool atexit_registered = false;
2473     if (!atexit_registered) {
2474         atexit(qt_print_item_count);
2475         atexit_registered = true;
2476     }
2477 #endif
2478
2479     Q_Q(QQuickItem);
2480
2481     registerAccessorProperties();
2482
2483     baselineOffsetValid = false;
2484
2485     if (parent) {
2486         q->setParentItem(parent);
2487         QQuickItemPrivate *parentPrivate = QQuickItemPrivate::get(parent);
2488         setImplicitLayoutMirror(parentPrivate->inheritedLayoutMirror, parentPrivate->inheritMirrorFromParent);
2489     }
2490 }
2491
2492 void QQuickItemPrivate::data_append(QQmlListProperty<QObject> *prop, QObject *o)
2493 {
2494     if (!o)
2495         return;
2496
2497     QQuickItem *that = static_cast<QQuickItem *>(prop->object);
2498
2499     // This test is measurably (albeit only slightly) faster than qobject_cast<>()
2500     const QMetaObject *mo = o->metaObject();
2501     while (mo && mo != &QQuickItem::staticMetaObject) {
2502         mo = mo->d.superdata;
2503     }
2504
2505     if (mo) {
2506         QQuickItem *item = static_cast<QQuickItem *>(o);
2507         item->setParentItem(that);
2508     } else {
2509         if (o->inherits("QGraphicsItem"))
2510             qWarning("Cannot add a QtQuick 1.0 item (%s) into a QtQuick 2.0 scene!", o->metaObject()->className());
2511
2512         // XXX todo - do we really want this behavior?
2513         o->setParent(that);
2514     }
2515 }
2516
2517 /*!
2518     \qmlproperty list<Object> QtQuick2::Item::data
2519     \default
2520
2521     The data property allows you to freely mix visual children and resources
2522     in an item.  If you assign a visual item to the data list it becomes
2523     a child and if you assign any other object type, it is added as a resource.
2524
2525     So you can write:
2526     \qml
2527     Item {
2528         Text {}
2529         Rectangle {}
2530         Timer {}
2531     }
2532     \endqml
2533
2534     instead of:
2535     \qml
2536     Item {
2537         children: [
2538             Text {},
2539             Rectangle {}
2540         ]
2541         resources: [
2542             Timer {}
2543         ]
2544     }
2545     \endqml
2546
2547     data is a behind-the-scenes property: you should never need to explicitly
2548     specify it.
2549  */
2550
2551 int QQuickItemPrivate::data_count(QQmlListProperty<QObject> *prop)
2552 {
2553     Q_UNUSED(prop);
2554     // XXX todo
2555     return 0;
2556 }
2557
2558 QObject *QQuickItemPrivate::data_at(QQmlListProperty<QObject> *prop, int i)
2559 {
2560     Q_UNUSED(prop);
2561     Q_UNUSED(i);
2562     // XXX todo
2563     return 0;
2564 }
2565
2566 void QQuickItemPrivate::data_clear(QQmlListProperty<QObject> *prop)
2567 {
2568     Q_UNUSED(prop);
2569     // XXX todo
2570 }
2571
2572 QObject *QQuickItemPrivate::resources_at(QQmlListProperty<QObject> *prop, int index)
2573 {
2574     const QObjectList children = prop->object->children();
2575     if (index < children.count())
2576         return children.at(index);
2577     else
2578         return 0;
2579 }
2580
2581 void QQuickItemPrivate::resources_append(QQmlListProperty<QObject> *prop, QObject *o)
2582 {
2583     // XXX todo - do we really want this behavior?
2584     o->setParent(prop->object);
2585 }
2586
2587 int QQuickItemPrivate::resources_count(QQmlListProperty<QObject> *prop)
2588 {
2589     return prop->object->children().count();
2590 }
2591
2592 void QQuickItemPrivate::resources_clear(QQmlListProperty<QObject> *prop)
2593 {
2594     // XXX todo - do we really want this behavior?
2595     const QObjectList children = prop->object->children();
2596     for (int index = 0; index < children.count(); index++)
2597         children.at(index)->setParent(0);
2598 }
2599
2600 QQuickItem *QQuickItemPrivate::children_at(QQmlListProperty<QQuickItem> *prop, int index)
2601 {
2602     QQuickItemPrivate *p = QQuickItemPrivate::get(static_cast<QQuickItem *>(prop->object));
2603     if (index >= p->childItems.count() || index < 0)
2604         return 0;
2605     else
2606         return p->childItems.at(index);
2607 }
2608
2609 void QQuickItemPrivate::children_append(QQmlListProperty<QQuickItem> *prop, QQuickItem *o)
2610 {
2611     if (!o)
2612         return;
2613
2614     QQuickItem *that = static_cast<QQuickItem *>(prop->object);
2615     if (o->parentItem() == that)
2616         o->setParentItem(0);
2617
2618     o->setParentItem(that);
2619 }
2620
2621 int QQuickItemPrivate::children_count(QQmlListProperty<QQuickItem> *prop)
2622 {
2623     QQuickItemPrivate *p = QQuickItemPrivate::get(static_cast<QQuickItem *>(prop->object));
2624     return p->childItems.count();
2625 }
2626
2627 void QQuickItemPrivate::children_clear(QQmlListProperty<QQuickItem> *prop)
2628 {
2629     QQuickItem *that = static_cast<QQuickItem *>(prop->object);
2630     QQuickItemPrivate *p = QQuickItemPrivate::get(that);
2631     while (!p->childItems.isEmpty())
2632         p->childItems.at(0)->setParentItem(0);
2633 }
2634
2635 void QQuickItemPrivate::visibleChildren_append(QQmlListProperty<QQuickItem>*, QQuickItem *self)
2636 {
2637     // do nothing
2638     qmlInfo(self) << "QQuickItem: visibleChildren property is readonly and cannot be assigned to.";
2639 }
2640
2641 int QQuickItemPrivate::visibleChildren_count(QQmlListProperty<QQuickItem> *prop)
2642 {
2643     QQuickItemPrivate *p = QQuickItemPrivate::get(static_cast<QQuickItem *>(prop->object));
2644     int visibleCount = 0;
2645     int c = p->childItems.count();
2646     while (c--) {
2647         if (p->childItems.at(c)->isVisible()) visibleCount++;
2648     }
2649
2650     return visibleCount;
2651 }
2652
2653 QQuickItem *QQuickItemPrivate::visibleChildren_at(QQmlListProperty<QQuickItem> *prop, int index)
2654 {
2655     QQuickItemPrivate *p = QQuickItemPrivate::get(static_cast<QQuickItem *>(prop->object));
2656     const int childCount = p->childItems.count();
2657     if (index >= childCount || index < 0)
2658         return 0;
2659
2660     int visibleCount = -1;
2661     for (int i = 0; i < childCount; i++) {
2662         if (p->childItems.at(i)->isVisible()) visibleCount++;
2663         if (visibleCount == index) return p->childItems.at(i);
2664     }
2665     return 0;
2666 }
2667
2668 int QQuickItemPrivate::transform_count(QQmlListProperty<QQuickTransform> *prop)
2669 {
2670     QQuickItem *that = static_cast<QQuickItem *>(prop->object);
2671     QQuickItemPrivate *p = QQuickItemPrivate::get(that);
2672
2673     return p->transforms.count();
2674 }
2675
2676 void QQuickTransform::appendToItem(QQuickItem *item)
2677 {
2678     Q_D(QQuickTransform);
2679     if (!item)
2680         return;
2681
2682     QQuickItemPrivate *p = QQuickItemPrivate::get(item);
2683
2684     if (!d->items.isEmpty() && !p->transforms.isEmpty() && p->transforms.contains(this)) {
2685         p->transforms.removeOne(this);
2686         p->transforms.append(this);
2687     } else {
2688         p->transforms.append(this);
2689         d->items.append(item);
2690     }
2691
2692     p->dirty(QQuickItemPrivate::Transform);
2693 }
2694
2695 void QQuickTransform::prependToItem(QQuickItem *item)
2696 {
2697     Q_D(QQuickTransform);
2698     if (!item)
2699         return;
2700
2701     QQuickItemPrivate *p = QQuickItemPrivate::get(item);
2702
2703     if (!d->items.isEmpty() && !p->transforms.isEmpty() && p->transforms.contains(this)) {
2704         p->transforms.removeOne(this);
2705         p->transforms.prepend(this);
2706     } else {
2707         p->transforms.prepend(this);
2708         d->items.append(item);
2709     }
2710
2711     p->dirty(QQuickItemPrivate::Transform);
2712 }
2713
2714 void QQuickItemPrivate::transform_append(QQmlListProperty<QQuickTransform> *prop, QQuickTransform *transform)
2715 {
2716     if (!transform)
2717         return;
2718
2719     QQuickItem *that = static_cast<QQuickItem *>(prop->object);
2720     transform->appendToItem(that);
2721 }
2722
2723 QQuickTransform *QQuickItemPrivate::transform_at(QQmlListProperty<QQuickTransform> *prop, int idx)
2724 {
2725     QQuickItem *that = static_cast<QQuickItem *>(prop->object);
2726     QQuickItemPrivate *p = QQuickItemPrivate::get(that);
2727
2728     if (idx < 0 || idx >= p->transforms.count())
2729         return 0;
2730     else
2731         return p->transforms.at(idx);
2732 }
2733
2734 void QQuickItemPrivate::transform_clear(QQmlListProperty<QQuickTransform> *prop)
2735 {
2736     QQuickItem *that = static_cast<QQuickItem *>(prop->object);
2737     QQuickItemPrivate *p = QQuickItemPrivate::get(that);
2738
2739     for (int ii = 0; ii < p->transforms.count(); ++ii) {
2740         QQuickTransform *t = p->transforms.at(ii);
2741         QQuickTransformPrivate *tp = QQuickTransformPrivate::get(t);
2742         tp->items.removeOne(that);
2743     }
2744
2745     p->transforms.clear();
2746
2747     p->dirty(QQuickItemPrivate::Transform);
2748 }
2749
2750 /*!
2751     \property QQuickItem::childrenRect
2752     \brief The geometry of an item's children.
2753
2754     This property holds the (collective) position and size of the item's children.
2755 */
2756
2757 /*!
2758   \qmlproperty real QtQuick2::Item::x
2759   \qmlproperty real QtQuick2::Item::y
2760   \qmlproperty real QtQuick2::Item::width
2761   \qmlproperty real QtQuick2::Item::height
2762
2763   Defines the item's position and size relative to its parent.
2764
2765   \qml
2766   Item { x: 100; y: 100; width: 100; height: 100 }
2767   \endqml
2768  */
2769
2770 /*!
2771   \qmlproperty real QtQuick2::Item::z
2772
2773   Sets the stacking order of sibling items.  By default the stacking order is 0.
2774
2775   Items with a higher stacking value are drawn on top of siblings with a
2776   lower stacking order.  Items with the same stacking value are drawn
2777   bottom up in the order they appear.  Items with a negative stacking
2778   value are drawn under their parent's content.
2779
2780   The following example shows the various effects of stacking order.
2781
2782   \table
2783   \row
2784   \li \image declarative-item_stacking1.png
2785   \li Same \c z - later children above earlier children:
2786   \qml
2787   Item {
2788       Rectangle {
2789           color: "red"
2790           width: 100; height: 100
2791       }
2792       Rectangle {
2793           color: "blue"
2794           x: 50; y: 50; width: 100; height: 100
2795       }
2796   }
2797   \endqml
2798   \row
2799   \li \image declarative-item_stacking2.png
2800   \li Higher \c z on top:
2801   \qml
2802   Item {
2803       Rectangle {
2804           z: 1
2805           color: "red"
2806           width: 100; height: 100
2807       }
2808       Rectangle {
2809           color: "blue"
2810           x: 50; y: 50; width: 100; height: 100
2811       }
2812   }
2813   \endqml
2814   \row
2815   \li \image declarative-item_stacking3.png
2816   \li Same \c z - children above parents:
2817   \qml
2818   Item {
2819       Rectangle {
2820           color: "red"
2821           width: 100; height: 100
2822           Rectangle {
2823               color: "blue"
2824               x: 50; y: 50; width: 100; height: 100
2825           }
2826       }
2827   }
2828   \endqml
2829   \row
2830   \li \image declarative-item_stacking4.png
2831   \li Lower \c z below:
2832   \qml
2833   Item {
2834       Rectangle {
2835           color: "red"
2836           width: 100; height: 100
2837           Rectangle {
2838               z: -1
2839               color: "blue"
2840               x: 50; y: 50; width: 100; height: 100
2841           }
2842       }
2843   }
2844   \endqml
2845   \endtable
2846  */
2847
2848 /*!
2849     \qmlproperty bool QtQuick2::Item::visible
2850
2851     This property holds whether the item is visible. By default this is true.
2852
2853     Setting this property directly affects the \c visible value of child
2854     items. When set to \c false, the \c visible values of all child items also
2855     become \c false. When set to \c true, the \c visible values of child items
2856     are returned to \c true, unless they have explicitly been set to \c false.
2857
2858     (Because of this flow-on behavior, using the \c visible property may not
2859     have the intended effect if a property binding should only respond to
2860     explicit property changes. In such cases it may be better to use the
2861     \l opacity property instead.)
2862
2863     Setting this property to \c false automatically causes \l focus to be set
2864     to \c false, and this item will longer receive mouse and keyboard events.
2865     (In contrast, setting the \l opacity to 0 does not affect the \l focus
2866     property and the receiving of key events.)
2867
2868     \note This property's value is only affected by changes to this property or
2869     the parent's \c visible property. It does not change, for example, if this
2870     item moves off-screen, or if the \l opacity changes to 0.
2871 */
2872
2873
2874 /*!
2875   \qmlproperty AnchorLine QtQuick2::Item::anchors.top
2876   \qmlproperty AnchorLine QtQuick2::Item::anchors.bottom
2877   \qmlproperty AnchorLine QtQuick2::Item::anchors.left
2878   \qmlproperty AnchorLine QtQuick2::Item::anchors.right
2879   \qmlproperty AnchorLine QtQuick2::Item::anchors.horizontalCenter
2880   \qmlproperty AnchorLine QtQuick2::Item::anchors.verticalCenter
2881   \qmlproperty AnchorLine QtQuick2::Item::anchors.baseline
2882
2883   \qmlproperty Item QtQuick2::Item::anchors.fill
2884   \qmlproperty Item QtQuick2::Item::anchors.centerIn
2885
2886   \qmlproperty real QtQuick2::Item::anchors.margins
2887   \qmlproperty real QtQuick2::Item::anchors.topMargin
2888   \qmlproperty real QtQuick2::Item::anchors.bottomMargin
2889   \qmlproperty real QtQuick2::Item::anchors.leftMargin
2890   \qmlproperty real QtQuick2::Item::anchors.rightMargin
2891   \qmlproperty real QtQuick2::Item::anchors.horizontalCenterOffset
2892   \qmlproperty real QtQuick2::Item::anchors.verticalCenterOffset
2893   \qmlproperty real QtQuick2::Item::anchors.baselineOffset
2894
2895   \qmlproperty bool QtQuick2::Item::anchors.mirrored
2896
2897   Anchors provide a way to position an item by specifying its
2898   relationship with other items.
2899
2900   Margins apply to top, bottom, left, right, and fill anchors.
2901   The \c anchors.margins property can be used to set all of the various margins at once, to the same value.
2902   Note that margins are anchor-specific and are not applied if an item does not
2903   use anchors.
2904
2905   Offsets apply for horizontal center, vertical center, and baseline anchors.
2906
2907   \table
2908   \row
2909   \li \image declarative-anchors_example.png
2910   \li Text anchored to Image, horizontally centered and vertically below, with a margin.
2911   \qml
2912   Item {
2913       Image {
2914           id: pic
2915           // ...
2916       }
2917       Text {
2918           id: label
2919           anchors.horizontalCenter: pic.horizontalCenter
2920           anchors.top: pic.bottom
2921           anchors.topMargin: 5
2922           // ...
2923       }
2924   }
2925   \endqml
2926   \row
2927   \li \image declarative-anchors_example2.png
2928   \li
2929   Left of Text anchored to right of Image, with a margin. The y
2930   property of both defaults to 0.
2931
2932   \qml
2933   Item {
2934       Image {
2935           id: pic
2936           // ...
2937       }
2938       Text {
2939           id: label
2940           anchors.left: pic.right
2941           anchors.leftMargin: 5
2942           // ...
2943       }
2944   }
2945   \endqml
2946   \endtable
2947
2948   \c anchors.fill provides a convenient way for one item to have the
2949   same geometry as another item, and is equivalent to connecting all
2950   four directional anchors.
2951
2952   To clear an anchor value, set it to \c undefined.
2953
2954   \c anchors.mirrored returns true it the layout has been \l {LayoutMirroring}{mirrored}.
2955
2956   \note You can only anchor an item to siblings or a parent.
2957
2958   For more information see \l {anchor-layout}{Anchor Layouts}.
2959 */
2960
2961 /*!
2962   \property QQuickItem::baselineOffset
2963   \brief The position of the item's baseline in local coordinates.
2964
2965   The baseline of a \l Text item is the imaginary line on which the text
2966   sits. Controls containing text usually set their baseline to the
2967   baseline of their text.
2968
2969   For non-text items, a default baseline offset of 0 is used.
2970 */
2971 QQuickAnchors *QQuickItemPrivate::anchors() const
2972 {
2973     if (!_anchors) {
2974         Q_Q(const QQuickItem);
2975         _anchors = new QQuickAnchors(const_cast<QQuickItem *>(q));
2976         if (!componentComplete)
2977             _anchors->classBegin();
2978     }
2979     return _anchors;
2980 }
2981
2982 void QQuickItemPrivate::siblingOrderChanged()
2983 {
2984     Q_Q(QQuickItem);
2985     for (int ii = 0; ii < changeListeners.count(); ++ii) {
2986         const QQuickItemPrivate::ChangeListener &change = changeListeners.at(ii);
2987         if (change.types & QQuickItemPrivate::SiblingOrder) {
2988             change.listener->itemSiblingOrderChanged(q);
2989         }
2990     }
2991 }
2992
2993 QQmlListProperty<QObject> QQuickItemPrivate::data()
2994 {
2995     return QQmlListProperty<QObject>(q_func(), 0, QQuickItemPrivate::data_append,
2996                                              QQuickItemPrivate::data_count,
2997                                              QQuickItemPrivate::data_at,
2998                                              QQuickItemPrivate::data_clear);
2999 }
3000
3001 QRectF QQuickItem::childrenRect()
3002 {
3003     Q_D(QQuickItem);
3004     if (!d->extra.isAllocated() || !d->extra->contents) {
3005         d->extra.value().contents = new QQuickContents(this);
3006         if (d->componentComplete)
3007             d->extra->contents->complete();
3008     }
3009     return d->extra->contents->rectF();
3010 }
3011
3012 QList<QQuickItem *> QQuickItem::childItems() const
3013 {
3014     Q_D(const QQuickItem);
3015     return d->childItems;
3016 }
3017
3018 bool QQuickItem::clip() const
3019 {
3020     return flags() & ItemClipsChildrenToShape;
3021 }
3022
3023 void QQuickItem::setClip(bool c)
3024 {
3025     if (clip() == c)
3026         return;
3027
3028     setFlag(ItemClipsChildrenToShape, c);
3029
3030     emit clipChanged(c);
3031 }
3032
3033
3034 /*!
3035   This function is called to handle this item's changes in
3036   geometry from \a oldGeometry to \a newGeometry. If the two
3037   geometries are the same, it doesn't do anything.
3038  */
3039 void QQuickItem::geometryChanged(const QRectF &newGeometry, const QRectF &oldGeometry)
3040 {
3041     Q_D(QQuickItem);
3042
3043     if (d->_anchors)
3044         QQuickAnchorsPrivate::get(d->_anchors)->updateMe();
3045
3046     bool xChange = (newGeometry.x() != oldGeometry.x());
3047     bool yChange = (newGeometry.y() != oldGeometry.y());
3048     bool widthChange = (newGeometry.width() != oldGeometry.width());
3049     bool heightChange = (newGeometry.height() != oldGeometry.height());
3050
3051     for (int ii = 0; ii < d->changeListeners.count(); ++ii) {
3052         const QQuickItemPrivate::ChangeListener &change = d->changeListeners.at(ii);
3053         if (change.types & QQuickItemPrivate::Geometry) {
3054             if (change.gTypes == QQuickItemPrivate::GeometryChange) {
3055                 change.listener->itemGeometryChanged(this, newGeometry, oldGeometry);
3056             } else if ((xChange && (change.gTypes & QQuickItemPrivate::XChange)) ||
3057                        (yChange && (change.gTypes & QQuickItemPrivate::YChange)) ||
3058                        (widthChange && (change.gTypes & QQuickItemPrivate::WidthChange)) ||
3059                        (heightChange && (change.gTypes & QQuickItemPrivate::HeightChange))) {
3060                 change.listener->itemGeometryChanged(this, newGeometry, oldGeometry);
3061             }
3062         }
3063     }
3064
3065     if (xChange)
3066         emit xChanged();
3067     if (yChange)
3068         emit yChanged();
3069     if (widthChange)
3070         emit widthChanged();
3071     if (heightChange)
3072         emit heightChanged();
3073 }
3074
3075 /*!
3076     Called by the rendering thread, as a result of
3077     QQuickItem::update(), when it is time to sync the state of the QML
3078     objects with the scene graph objects.
3079
3080     The function should return the root of the scene graph subtree for
3081     this item. Most implementations will return a single
3082     QSGGeometryNode containing the visual representation of this item.
3083     \a oldNode is the node that was returned the last time the
3084     function was called.
3085
3086     \code
3087     QSGNode *MyItem::updatePaintNode(QSGNode *node, UpdatePaintNodeData *)
3088     {
3089         QSGSimpleRectNode *n = static_cast<QSGSimpleRectNode *>(node);
3090         if (!n) {
3091             n = new QSGSimpleRectNode();
3092             n->setColor(Qt::red);
3093         }
3094         n->setRect(boundingRect());
3095         return n;
3096     }
3097     \endcode
3098
3099     The main thread is blocked while this function is executed so it is safe to read
3100     values from the QQuickItem instance and other objects in the main thread.
3101
3102     \warning It is crucial that OpenGL operations and interaction with
3103     the scene graph happens exclusively on the rendering thread,
3104     primarily during the QQuickItem::updatePaintNode() call. The best
3105     rule of thumb is to only use classes with the "QSG" prefix inside
3106     the QQuickItem::updatePaintNode() function.
3107
3108     \sa QSGMaterial, QSGSimpleMaterial, QSGGeometryNode, QSGGeometry,
3109     QSGFlatColorMaterial, QSGTextureMaterial
3110  */
3111
3112 QSGNode *QQuickItem::updatePaintNode(QSGNode *oldNode, UpdatePaintNodeData *)
3113 {
3114     delete oldNode;
3115     return 0;
3116 }
3117
3118 /*!
3119     This function is called when the item's scene graph resources are no longer needed.
3120     It allows items to free its resources, for instance textures, that are not owned by scene graph
3121     nodes. Note that scene graph nodes are managed by QQuickCanvas and should not be deleted by
3122     this function. Scene graph resources are no longer needed when the parent is set to null and
3123     the item is not used by any \l ShaderEffect or \l ShaderEffectSource.
3124
3125     This function is called from the main thread. Therefore, resources used by the scene graph
3126     should not be deleted directly, but by calling \l QObject::deleteLater().
3127
3128     \note The item destructor still needs to free its scene graph resources if not already done.
3129  */
3130
3131 void QQuickItem::releaseResources()
3132 {
3133 }
3134
3135 QSGTransformNode *QQuickItemPrivate::createTransformNode()
3136 {
3137     return new QSGTransformNode;
3138 }
3139
3140 void QQuickItem::updatePolish()
3141 {
3142 }
3143
3144 void QQuickItemPrivate::addItemChangeListener(QQuickItemChangeListener *listener, ChangeTypes types)
3145 {
3146     changeListeners.append(ChangeListener(listener, types));
3147 }
3148
3149 void QQuickItemPrivate::removeItemChangeListener(QQuickItemChangeListener *listener, ChangeTypes types)
3150 {
3151     ChangeListener change(listener, types);
3152     changeListeners.removeOne(change);
3153 }
3154
3155 void QQuickItemPrivate::updateOrAddGeometryChangeListener(QQuickItemChangeListener *listener, GeometryChangeTypes types)
3156 {
3157     ChangeListener change(listener, types);
3158     int index = changeListeners.find(change);
3159     if (index > -1)
3160         changeListeners[index].gTypes = change.gTypes;  //we may have different GeometryChangeTypes
3161     else
3162         changeListeners.append(change);
3163 }
3164
3165 void QQuickItemPrivate::updateOrRemoveGeometryChangeListener(QQuickItemChangeListener *listener,
3166                                                              GeometryChangeTypes types)
3167 {
3168     ChangeListener change(listener, types);
3169     if (types == NoChange) {
3170         changeListeners.removeOne(change);
3171     } else {
3172         int index = changeListeners.find(change);
3173         if (index > -1)
3174             changeListeners[index].gTypes = change.gTypes;  //we may have different GeometryChangeTypes
3175     }
3176 }
3177
3178 void QQuickItem::keyPressEvent(QKeyEvent *event)
3179 {
3180     event->ignore();
3181 }
3182
3183 void QQuickItem::keyReleaseEvent(QKeyEvent *event)
3184 {
3185     event->ignore();
3186 }
3187
3188 void QQuickItem::inputMethodEvent(QInputMethodEvent *event)
3189 {
3190     event->ignore();
3191 }
3192
3193 void QQuickItem::focusInEvent(QFocusEvent *)
3194 {
3195 #ifndef QT_NO_ACCESSIBILITY
3196     QAccessibleEvent ev(this, QAccessible::Focus);
3197     QAccessible::updateAccessibility(&ev);
3198 #endif
3199 }
3200
3201 void QQuickItem::focusOutEvent(QFocusEvent *)
3202 {
3203 }
3204
3205 void QQuickItem::mousePressEvent(QMouseEvent *event)
3206 {
3207     event->ignore();
3208 }
3209
3210 void QQuickItem::mouseMoveEvent(QMouseEvent *event)
3211 {
3212     event->ignore();
3213 }
3214
3215 void QQuickItem::mouseReleaseEvent(QMouseEvent *event)
3216 {
3217     event->ignore();
3218 }
3219
3220 void QQuickItem::mouseDoubleClickEvent(QMouseEvent *)
3221 {
3222 }
3223
3224 void QQuickItem::mouseUngrabEvent()
3225 {
3226     // XXX todo
3227 }
3228
3229 void QQuickItem::touchUngrabEvent()
3230 {
3231     // XXX todo
3232 }
3233
3234 void QQuickItem::wheelEvent(QWheelEvent *event)
3235 {
3236     event->ignore();
3237 }
3238
3239 void QQuickItem::touchEvent(QTouchEvent *event)
3240 {
3241     event->ignore();
3242 }
3243
3244 void QQuickItem::hoverEnterEvent(QHoverEvent *event)
3245 {
3246     Q_UNUSED(event);
3247 }
3248
3249 void QQuickItem::hoverMoveEvent(QHoverEvent *event)
3250 {
3251     Q_UNUSED(event);
3252 }
3253
3254 void QQuickItem::hoverLeaveEvent(QHoverEvent *event)
3255 {
3256     Q_UNUSED(event);
3257 }
3258
3259 void QQuickItem::dragEnterEvent(QDragEnterEvent *event)
3260 {
3261     Q_UNUSED(event);
3262 }
3263
3264 void QQuickItem::dragMoveEvent(QDragMoveEvent *event)
3265 {
3266
3267     Q_UNUSED(event);
3268 }
3269
3270 void QQuickItem::dragLeaveEvent(QDragLeaveEvent *event)
3271 {
3272
3273     Q_UNUSED(event);
3274 }
3275
3276 void QQuickItem::dropEvent(QDropEvent *event)
3277 {
3278     Q_UNUSED(event);
3279 }
3280
3281 bool QQuickItem::childMouseEventFilter(QQuickItem *, QEvent *)
3282 {
3283     return false;
3284 }
3285
3286 void QQuickItem::windowDeactivateEvent()
3287 {
3288     foreach (QQuickItem* item, childItems()) {
3289         item->windowDeactivateEvent();
3290     }
3291 }
3292
3293 QVariant QQuickItem::inputMethodQuery(Qt::InputMethodQuery query) const
3294 {
3295     Q_D(const QQuickItem);
3296     QVariant v;
3297
3298     switch (query) {
3299     case Qt::ImEnabled:
3300         v = (bool)(flags() & ItemAcceptsInputMethod);
3301         break;
3302     case Qt::ImHints:
3303     case Qt::ImCursorRectangle:
3304     case Qt::ImFont:
3305     case Qt::ImCursorPosition:
3306     case Qt::ImSurroundingText:
3307     case Qt::ImCurrentSelection:
3308     case Qt::ImMaximumTextLength:
3309     case Qt::ImAnchorPosition:
3310     case Qt::ImPreferredLanguage:
3311         if (d->extra.isAllocated() && d->extra->keyHandler)
3312             v = d->extra->keyHandler->inputMethodQuery(query);
3313     default:
3314         break;
3315     }
3316
3317     return v;
3318 }
3319
3320 QQuickAnchorLine QQuickItemPrivate::left() const
3321 {
3322     Q_Q(const QQuickItem);
3323     return QQuickAnchorLine(const_cast<QQuickItem *>(q), QQuickAnchorLine::Left);
3324 }
3325
3326 QQuickAnchorLine QQuickItemPrivate::right() const
3327 {
3328     Q_Q(const QQuickItem);
3329     return QQuickAnchorLine(const_cast<QQuickItem *>(q), QQuickAnchorLine::Right);
3330 }
3331
3332 QQuickAnchorLine QQuickItemPrivate::horizontalCenter() const
3333 {
3334     Q_Q(const QQuickItem);
3335     return QQuickAnchorLine(const_cast<QQuickItem *>(q), QQuickAnchorLine::HCenter);
3336 }
3337
3338 QQuickAnchorLine QQuickItemPrivate::top() const
3339 {
3340     Q_Q(const QQuickItem);
3341     return QQuickAnchorLine(const_cast<QQuickItem *>(q), QQuickAnchorLine::Top);
3342 }
3343
3344 QQuickAnchorLine QQuickItemPrivate::bottom() const
3345 {
3346     Q_Q(const QQuickItem);
3347     return QQuickAnchorLine(const_cast<QQuickItem *>(q), QQuickAnchorLine::Bottom);
3348 }
3349
3350 QQuickAnchorLine QQuickItemPrivate::verticalCenter() const
3351 {
3352     Q_Q(const QQuickItem);
3353     return QQuickAnchorLine(const_cast<QQuickItem *>(q), QQuickAnchorLine::VCenter);
3354 }
3355
3356 QQuickAnchorLine QQuickItemPrivate::baseline() const
3357 {
3358     Q_Q(const QQuickItem);
3359     return QQuickAnchorLine(const_cast<QQuickItem *>(q), QQuickAnchorLine::Baseline);
3360 }
3361
3362 qreal QQuickItem::baselineOffset() const
3363 {
3364     Q_D(const QQuickItem);
3365     if (d->baselineOffsetValid) {
3366         return d->baselineOffset;
3367     } else {
3368         return 0.0;
3369     }
3370 }
3371
3372 void QQuickItem::setBaselineOffset(qreal offset)
3373 {
3374     Q_D(QQuickItem);
3375     if (offset == d->baselineOffset)
3376         return;
3377
3378     d->baselineOffset = offset;
3379     d->baselineOffsetValid = true;
3380
3381     for (int ii = 0; ii < d->changeListeners.count(); ++ii) {
3382         const QQuickItemPrivate::ChangeListener &change = d->changeListeners.at(ii);
3383         if (change.types & QQuickItemPrivate::Geometry) {
3384             QQuickAnchorsPrivate *anchor = change.listener->anchorPrivate();
3385             if (anchor)
3386                 anchor->updateVerticalAnchors();
3387         }
3388     }
3389
3390     if (d->_anchors && (d->_anchors->usedAnchors() & QQuickAnchors::BaselineAnchor))
3391         QQuickAnchorsPrivate::get(d->_anchors)->updateVerticalAnchors();
3392
3393     emit baselineOffsetChanged(offset);
3394 }
3395
3396 void QQuickItem::update()
3397 {
3398     Q_D(QQuickItem);
3399     Q_ASSERT(flags() & ItemHasContents);
3400     d->dirty(QQuickItemPrivate::Content);
3401 }
3402
3403 void QQuickItem::polish()
3404 {
3405     Q_D(QQuickItem);
3406     if (!d->polishScheduled) {
3407         d->polishScheduled = true;
3408         if (d->canvas) {
3409             QQuickCanvasPrivate *p = QQuickCanvasPrivate::get(d->canvas);
3410             bool maybeupdate = p->itemsToPolish.isEmpty();
3411             p->itemsToPolish.insert(this);
3412             if (maybeupdate) d->canvas->maybeUpdate();
3413         }
3414     }
3415 }
3416
3417 void QQuickItem::mapFromItem(QQmlV8Function *args) const
3418 {
3419     if (args->Length() != 0) {
3420         v8::Local<v8::Value> item = (*args)[0];
3421         QV8Engine *engine = args->engine();
3422
3423         QQuickItem *itemObj = 0;
3424         if (!item->IsNull())
3425             itemObj = qobject_cast<QQuickItem*>(engine->toQObject(item));
3426
3427         if (!itemObj && !item->IsNull()) {
3428             qmlInfo(this) << "mapFromItem() given argument \"" << engine->toString(item->ToString())
3429                           << "\" which is neither null nor an Item";
3430             return;
3431         }
3432
3433         v8::Local<v8::Object> rv = v8::Object::New();
3434         args->returnValue(rv);
3435
3436         qreal x = (args->Length() > 1)?(*args)[1]->NumberValue():0;
3437         qreal y = (args->Length() > 2)?(*args)[2]->NumberValue():0;
3438
3439         QPointF p = mapFromItem(itemObj, QPointF(x, y));
3440
3441         rv->Set(v8::String::New("x"), v8::Number::New(p.x()));
3442         rv->Set(v8::String::New("y"), v8::Number::New(p.y()));
3443     }
3444 }
3445
3446 QTransform QQuickItem::itemTransform(QQuickItem *other, bool *ok) const
3447 {
3448     Q_D(const QQuickItem);
3449
3450     // XXX todo - we need to be able to handle common parents better and detect
3451     // invalid cases
3452     if (ok) *ok = true;
3453
3454     QTransform t = d->itemToCanvasTransform();
3455     if (other) t *= QQuickItemPrivate::get(other)->canvasToItemTransform();
3456
3457     return t;
3458 }
3459
3460 void QQuickItem::mapToItem(QQmlV8Function *args) const
3461 {
3462     if (args->Length() != 0) {
3463         v8::Local<v8::Value> item = (*args)[0];
3464         QV8Engine *engine = args->engine();
3465
3466         QQuickItem *itemObj = 0;
3467         if (!item->IsNull())
3468             itemObj = qobject_cast<QQuickItem*>(engine->toQObject(item));
3469
3470         if (!itemObj && !item->IsNull()) {
3471             qmlInfo(this) << "mapToItem() given argument \"" << engine->toString(item->ToString())
3472                           << "\" which is neither null nor an Item";
3473             return;
3474         }
3475
3476         v8::Local<v8::Object> rv = v8::Object::New();
3477         args->returnValue(rv);
3478
3479         qreal x = (args->Length() > 1)?(*args)[1]->NumberValue():0;
3480         qreal y = (args->Length() > 2)?(*args)[2]->NumberValue():0;
3481
3482         QPointF p = mapToItem(itemObj, QPointF(x, y));
3483
3484         rv->Set(v8::String::New("x"), v8::Number::New(p.x()));
3485         rv->Set(v8::String::New("y"), v8::Number::New(p.y()));
3486     }
3487 }
3488
3489 void QQuickItem::forceActiveFocus()
3490 {
3491     setFocus(true);
3492     QQuickItem *parent = parentItem();
3493     while (parent) {
3494         if (parent->flags() & QQuickItem::ItemIsFocusScope) {
3495             parent->setFocus(true);
3496         }
3497         parent = parent->parentItem();
3498     }
3499 }
3500
3501 QQuickItem *QQuickItem::childAt(qreal x, qreal y) const
3502 {
3503     // XXX todo - should this include transform etc.?
3504     const QList<QQuickItem *> children = childItems();
3505     for (int i = children.count()-1; i >= 0; --i) {
3506         QQuickItem *child = children.at(i);
3507         if (child->isVisible() && child->x() <= x
3508                 && child->x() + child->width() >= x
3509                 && child->y() <= y
3510                 && child->y() + child->height() >= y)
3511             return child;
3512     }
3513     return 0;
3514 }
3515
3516 QQmlListProperty<QObject> QQuickItemPrivate::resources()
3517 {
3518     return QQmlListProperty<QObject>(q_func(), 0, QQuickItemPrivate::resources_append,
3519                                              QQuickItemPrivate::resources_count,
3520                                              QQuickItemPrivate::resources_at,
3521                                              QQuickItemPrivate::resources_clear);
3522 }
3523
3524 QQmlListProperty<QQuickItem> QQuickItemPrivate::children()
3525 {
3526     return QQmlListProperty<QQuickItem>(q_func(), 0, QQuickItemPrivate::children_append,
3527                                              QQuickItemPrivate::children_count,
3528                                              QQuickItemPrivate::children_at,
3529                                              QQuickItemPrivate::children_clear);
3530
3531 }
3532
3533 /*!
3534   \qmlproperty real QtQuick2::Item::visibleChildren
3535   This read-only property lists all of the item's children that are currently visible.
3536   Note that a child's visibility may have changed explicitly, or because the visibility
3537   of this (it's parent) item or another grandparent changed.
3538 */
3539 QQmlListProperty<QQuickItem> QQuickItemPrivate::visibleChildren()
3540 {
3541     return QQmlListProperty<QQuickItem>(q_func(), 0, QQuickItemPrivate::visibleChildren_append,
3542                                              QQuickItemPrivate::visibleChildren_count,
3543                                              QQuickItemPrivate::visibleChildren_at);
3544
3545 }
3546
3547 QQmlListProperty<QQuickState> QQuickItemPrivate::states()
3548 {
3549     return _states()->statesProperty();
3550 }
3551
3552 QQmlListProperty<QQuickTransition> QQuickItemPrivate::transitions()
3553 {
3554     return _states()->transitionsProperty();
3555 }
3556
3557 QString QQuickItemPrivate::state() const
3558 {
3559     if (!_stateGroup)
3560         return QString();
3561     else
3562         return _stateGroup->state();
3563 }
3564
3565 void QQuickItemPrivate::setState(const QString &state)
3566 {
3567     _states()->setState(state);
3568 }
3569
3570 QString QQuickItem::state() const
3571 {
3572     Q_D(const QQuickItem);
3573     return d->state();
3574 }
3575
3576 void QQuickItem::setState(const QString &state)
3577 {
3578     Q_D(QQuickItem);
3579     d->setState(state);
3580 }
3581
3582 QQmlListProperty<QQuickTransform> QQuickItem::transform()
3583 {
3584     return QQmlListProperty<QQuickTransform>(this, 0, QQuickItemPrivate::transform_append,
3585                                                      QQuickItemPrivate::transform_count,
3586                                                      QQuickItemPrivate::transform_at,
3587                                                      QQuickItemPrivate::transform_clear);
3588 }
3589
3590 void QQuickItem::classBegin()
3591 {
3592     Q_D(QQuickItem);
3593     d->componentComplete = false;
3594     if (d->_stateGroup)
3595         d->_stateGroup->classBegin();
3596     if (d->_anchors)
3597         d->_anchors->classBegin();
3598     if (d->extra.isAllocated() && d->extra->layer)
3599         d->extra->layer->classBegin();
3600 }
3601
3602 void QQuickItem::componentComplete()
3603 {
3604     Q_D(QQuickItem);
3605     d->componentComplete = true;
3606     if (d->_stateGroup)
3607         d->_stateGroup->componentComplete();
3608     if (d->_anchors) {
3609         d->_anchors->componentComplete();
3610         QQuickAnchorsPrivate::get(d->_anchors)->updateOnComplete();
3611     }
3612
3613     if (d->extra.isAllocated() && d->extra->layer)
3614         d->extra->layer->componentComplete();
3615
3616     if (d->extra.isAllocated() && d->extra->keyHandler)
3617         d->extra->keyHandler->componentComplete();
3618
3619     if (d->extra.isAllocated() && d->extra->contents)
3620         d->extra->contents->complete();
3621 }
3622
3623 QQuickStateGroup *QQuickItemPrivate::_states()
3624 {
3625     Q_Q(QQuickItem);
3626     if (!_stateGroup) {
3627         _stateGroup = new QQuickStateGroup;
3628         if (!componentComplete)
3629             _stateGroup->classBegin();
3630         FAST_CONNECT(_stateGroup, SIGNAL(stateChanged(QString)),
3631                      q, SIGNAL(stateChanged(QString)))
3632     }
3633
3634     return _stateGroup;
3635 }
3636
3637 QPointF QQuickItemPrivate::computeTransformOrigin() const
3638 {
3639     switch (origin()) {
3640     default:
3641     case QQuickItem::TopLeft:
3642         return QPointF(0, 0);
3643     case QQuickItem::Top:
3644         return QPointF(width / 2., 0);
3645     case QQuickItem::TopRight:
3646         return QPointF(width, 0);
3647     case QQuickItem::Left:
3648         return QPointF(0, height / 2.);
3649     case QQuickItem::Center:
3650         return QPointF(width / 2., height / 2.);
3651     case QQuickItem::Right:
3652         return QPointF(width, height / 2.);
3653     case QQuickItem::BottomLeft:
3654         return QPointF(0, height);
3655     case QQuickItem::Bottom:
3656         return QPointF(width / 2., height);
3657     case QQuickItem::BottomRight:
3658         return QPointF(width, height);
3659     }
3660 }
3661
3662 void QQuickItemPrivate::transformChanged()
3663 {
3664     if (extra.isAllocated() && extra->layer)
3665         extra->layer->updateMatrix();
3666 }
3667
3668 void QQuickItemPrivate::deliverKeyEvent(QKeyEvent *e)
3669 {
3670     Q_Q(QQuickItem);
3671
3672     Q_ASSERT(e->isAccepted());
3673     if (extra.isAllocated() && extra->keyHandler) {
3674         if (e->type() == QEvent::KeyPress)
3675             extra->keyHandler->keyPressed(e, false);
3676         else
3677             extra->keyHandler->keyReleased(e, false);
3678
3679         if (e->isAccepted())
3680             return;
3681         else
3682             e->accept();
3683     }
3684
3685     if (e->type() == QEvent::KeyPress)
3686         q->keyPressEvent(e);
3687     else
3688         q->keyReleaseEvent(e);
3689
3690     if (e->isAccepted())
3691         return;
3692
3693     if (extra.isAllocated() && extra->keyHandler) {
3694         e->accept();
3695
3696         if (e->type() == QEvent::KeyPress)
3697             extra->keyHandler->keyPressed(e, true);
3698         else
3699             extra->keyHandler->keyReleased(e, true);
3700     }
3701 }
3702
3703 void QQuickItemPrivate::deliverInputMethodEvent(QInputMethodEvent *e)
3704 {
3705     Q_Q(QQuickItem);
3706
3707     Q_ASSERT(e->isAccepted());
3708     if (extra.isAllocated() && extra->keyHandler) {
3709         extra->keyHandler->inputMethodEvent(e, false);
3710
3711         if (e->isAccepted())
3712             return;
3713         else
3714             e->accept();
3715     }
3716
3717     q->inputMethodEvent(e);
3718
3719     if (e->isAccepted())
3720         return;
3721
3722     if (extra.isAllocated() && extra->keyHandler) {
3723         e->accept();
3724
3725         extra->keyHandler->inputMethodEvent(e, true);
3726     }
3727 }
3728
3729 void QQuickItemPrivate::deliverFocusEvent(QFocusEvent *e)
3730 {
3731     Q_Q(QQuickItem);
3732
3733     if (e->type() == QEvent::FocusIn) {
3734         q->focusInEvent(e);
3735     } else {
3736         q->focusOutEvent(e);
3737     }
3738 }
3739
3740 void QQuickItemPrivate::deliverMouseEvent(QMouseEvent *e)
3741 {
3742     Q_Q(QQuickItem);
3743
3744     Q_ASSERT(e->isAccepted());
3745
3746     switch (e->type()) {
3747     default:
3748         Q_ASSERT(!"Unknown event type");
3749     case QEvent::MouseMove:
3750         q->mouseMoveEvent(e);
3751         break;
3752     case QEvent::MouseButtonPress:
3753         q->mousePressEvent(e);
3754         break;
3755     case QEvent::MouseButtonRelease:
3756         q->mouseReleaseEvent(e);
3757         break;
3758     case QEvent::MouseButtonDblClick:
3759         q->mouseDoubleClickEvent(e);
3760         break;
3761     }
3762 }
3763
3764 void QQuickItemPrivate::deliverWheelEvent(QWheelEvent *e)
3765 {
3766     Q_Q(QQuickItem);
3767     q->wheelEvent(e);
3768 }
3769
3770 void QQuickItemPrivate::deliverTouchEvent(QTouchEvent *e)
3771 {
3772     Q_Q(QQuickItem);
3773     q->touchEvent(e);
3774 }
3775
3776 void QQuickItemPrivate::deliverHoverEvent(QHoverEvent *e)
3777 {
3778     Q_Q(QQuickItem);
3779     switch (e->type()) {
3780     default:
3781         Q_ASSERT(!"Unknown event type");
3782     case QEvent::HoverEnter:
3783         q->hoverEnterEvent(e);
3784         break;
3785     case QEvent::HoverLeave:
3786         q->hoverLeaveEvent(e);
3787         break;
3788     case QEvent::HoverMove:
3789         q->hoverMoveEvent(e);
3790         break;
3791     }
3792 }
3793
3794 void QQuickItemPrivate::deliverDragEvent(QEvent *e)
3795 {
3796     Q_Q(QQuickItem);
3797     switch (e->type()) {
3798     default:
3799         Q_ASSERT(!"Unknown event type");
3800     case QEvent::DragEnter:
3801         q->dragEnterEvent(static_cast<QDragEnterEvent *>(e));
3802         break;
3803     case QEvent::DragLeave:
3804         q->dragLeaveEvent(static_cast<QDragLeaveEvent *>(e));
3805         break;
3806     case QEvent::DragMove:
3807         q->dragMoveEvent(static_cast<QDragMoveEvent *>(e));
3808         break;
3809     case QEvent::Drop:
3810         q->dropEvent(static_cast<QDropEvent *>(e));
3811         break;
3812     }
3813 }
3814
3815 void QQuickItem::itemChange(ItemChange change, const ItemChangeData &value)
3816 {
3817     Q_UNUSED(change);
3818     Q_UNUSED(value);
3819 }
3820
3821 /*!
3822     Notify input method on updated query values if needed. \a indicates changed attributes.
3823 */
3824 void QQuickItem::updateInputMethod(Qt::InputMethodQueries queries)
3825 {
3826     if (hasActiveFocus())
3827         qApp->inputMethod()->update(queries);
3828 }
3829
3830 /*! \internal */
3831 // XXX todo - do we want/need this anymore?
3832 QRectF QQuickItem::boundingRect() const
3833 {
3834     Q_D(const QQuickItem);
3835     return QRectF(0, 0, d->width, d->height);
3836 }
3837
3838 /*! \internal */
3839 QRectF QQuickItem::clipRect() const
3840 {
3841     Q_D(const QQuickItem);
3842     return QRectF(0, 0, d->width, d->height);
3843 }
3844
3845
3846 QQuickItem::TransformOrigin QQuickItem::transformOrigin() const
3847 {
3848     Q_D(const QQuickItem);
3849     return d->origin();
3850 }
3851
3852 void QQuickItem::setTransformOrigin(TransformOrigin origin)
3853 {
3854     Q_D(QQuickItem);
3855     if (origin == d->origin())
3856         return;
3857
3858     d->extra.value().origin = origin;
3859     d->dirty(QQuickItemPrivate::TransformOrigin);
3860
3861     emit transformOriginChanged(d->origin());
3862 }
3863
3864 QPointF QQuickItem::transformOriginPoint() const
3865 {
3866     Q_D(const QQuickItem);
3867     if (d->extra.isAllocated() && !d->extra->userTransformOriginPoint.isNull())
3868         return d->extra->userTransformOriginPoint;
3869     return d->computeTransformOrigin();
3870 }
3871
3872 void QQuickItem::setTransformOriginPoint(const QPointF &point)
3873 {
3874     Q_D(QQuickItem);
3875     if (d->extra.value().userTransformOriginPoint == point)
3876         return;
3877
3878     d->extra->userTransformOriginPoint = point;
3879     d->dirty(QQuickItemPrivate::TransformOrigin);
3880 }
3881
3882 qreal QQuickItem::z() const
3883 {
3884     Q_D(const QQuickItem);
3885     return d->z();
3886 }
3887
3888 void QQuickItem::setZ(qreal v)
3889 {
3890     Q_D(QQuickItem);
3891     if (d->z() == v)
3892         return;
3893
3894     d->extra.value().z = v;
3895
3896     d->dirty(QQuickItemPrivate::ZValue);
3897     if (d->parentItem) {
3898         QQuickItemPrivate::get(d->parentItem)->dirty(QQuickItemPrivate::ChildrenStackingChanged);
3899         QQuickItemPrivate::get(d->parentItem)->markSortedChildrenDirty(this);
3900     }
3901
3902     emit zChanged();
3903
3904     if (d->extra.isAllocated() && d->extra->layer)
3905         d->extra->layer->updateZ();
3906 }
3907
3908
3909 /*!
3910   \qmlproperty real QtQuick2::Item::rotation
3911   This property holds the rotation of the item in degrees clockwise.
3912
3913   This specifies how many degrees to rotate the item around its transformOrigin.
3914   The default rotation is 0 degrees (i.e. not rotated at all).
3915
3916   \table
3917   \row
3918   \li \image declarative-rotation.png
3919   \li
3920   \qml
3921   Rectangle {
3922       color: "blue"
3923       width: 100; height: 100
3924       Rectangle {
3925           color: "red"
3926           x: 25; y: 25; width: 50; height: 50
3927           rotation: 30
3928       }
3929   }
3930   \endqml
3931   \endtable
3932
3933   \sa transform, Rotation
3934 */
3935
3936 /*!
3937   \qmlproperty real QtQuick2::Item::scale
3938   This property holds the scale of the item.
3939
3940   A scale of less than 1 means the item will be displayed smaller than
3941   normal, and a scale of greater than 1 means the item will be
3942   displayed larger than normal.  A negative scale means the item will
3943   be mirrored.
3944
3945   By default, items are displayed at a scale of 1 (i.e. at their
3946   normal size).
3947
3948   Scaling is from the item's transformOrigin.
3949
3950   \table
3951   \row
3952   \li \image declarative-scale.png
3953   \li
3954   \qml
3955   Rectangle {
3956       color: "blue"
3957       width: 100; height: 100
3958       Rectangle {
3959           color: "green"
3960           width: 25; height: 25
3961       }
3962       Rectangle {
3963           color: "red"
3964           x: 25; y: 25; width: 50; height: 50
3965           scale: 1.4
3966       }
3967   }
3968   \endqml
3969   \endtable
3970
3971   \sa transform, Scale
3972 */
3973
3974 /*!
3975   \qmlproperty real QtQuick2::Item::opacity
3976
3977   This property holds the opacity of the item.  Opacity is specified as a
3978   number between 0 (fully transparent) and 1 (fully opaque).  The default is 1.
3979
3980   When this property is set, the specified opacity is also applied
3981   individually to child items.  In almost all cases this is what you want,
3982   but in some cases it may produce undesired results. For example in the
3983   second set of rectangles below, the red rectangle has specified an opacity
3984   of 0.5, which affects the opacity of its blue child rectangle even though
3985   the child has not specified an opacity.
3986
3987   \table
3988   \row
3989   \li \image declarative-item_opacity1.png
3990   \li
3991   \qml
3992     Item {
3993         Rectangle {
3994             color: "red"
3995             width: 100; height: 100
3996             Rectangle {
3997                 color: "blue"
3998                 x: 50; y: 50; width: 100; height: 100
3999             }
4000         }
4001     }
4002   \endqml
4003   \row
4004   \li \image declarative-item_opacity2.png
4005   \li
4006   \qml
4007     Item {
4008         Rectangle {
4009             opacity: 0.5
4010             color: "red"
4011             width: 100; height: 100
4012             Rectangle {
4013                 color: "blue"
4014                 x: 50; y: 50; width: 100; height: 100
4015             }
4016         }
4017     }
4018   \endqml
4019   \endtable
4020
4021   If an item's opacity is set to 0, the item will no longer receive mouse
4022   events, but will continue to receive key events and will retain the keyboard
4023   \l focus if it has been set. (In contrast, setting the \l visible property
4024   to \c false stops both mouse and keyboard events, and also removes focus
4025   from the item.)
4026 */
4027
4028 /*!
4029   Returns a value indicating whether mouse input should
4030   remain with this item exclusively.
4031
4032   \sa setKeepMouseGrab()
4033  */
4034
4035 qreal QQuickItem::rotation() const
4036 {
4037     Q_D(const QQuickItem);
4038     return d->rotation();
4039 }
4040
4041 void QQuickItem::setRotation(qreal r)
4042 {
4043     Q_D(QQuickItem);
4044     if (d->rotation() == r)
4045         return;
4046
4047     d->extra.value().rotation = r;
4048
4049     d->dirty(QQuickItemPrivate::BasicTransform);
4050
4051     d->itemChange(ItemRotationHasChanged, r);
4052
4053     emit rotationChanged();
4054 }
4055
4056 qreal QQuickItem::scale() const
4057 {
4058     Q_D(const QQuickItem);
4059     return d->scale();
4060 }
4061
4062 void QQuickItem::setScale(qreal s)
4063 {
4064     Q_D(QQuickItem);
4065     if (d->scale() == s)
4066         return;
4067
4068     d->extra.value().scale = s;
4069
4070     d->dirty(QQuickItemPrivate::BasicTransform);
4071
4072     emit scaleChanged();
4073 }
4074
4075 qreal QQuickItem::opacity() const
4076 {
4077     Q_D(const QQuickItem);
4078     return d->opacity();
4079 }
4080
4081 void QQuickItem::setOpacity(qreal o)
4082 {
4083     Q_D(QQuickItem);
4084     if (d->opacity() == o)
4085         return;
4086
4087     d->extra.value().opacity = o;
4088
4089     d->dirty(QQuickItemPrivate::OpacityValue);
4090
4091     d->itemChange(ItemOpacityHasChanged, o);
4092
4093     emit opacityChanged();
4094 }
4095
4096 bool QQuickItem::isVisible() const
4097 {
4098     Q_D(const QQuickItem);
4099     return d->effectiveVisible;
4100 }
4101
4102 void QQuickItem::setVisible(bool v)
4103 {
4104     Q_D(QQuickItem);
4105     if (v == d->explicitVisible)
4106         return;
4107
4108     d->explicitVisible = v;
4109
4110     const bool childVisibilityChanged = d->setEffectiveVisibleRecur(d->calcEffectiveVisible());
4111     if (childVisibilityChanged && d->parentItem)
4112         emit d->parentItem->visibleChildrenChanged();   // signal the parent, not this!
4113 }
4114
4115 bool QQuickItem::isEnabled() const
4116 {
4117     Q_D(const QQuickItem);
4118     return d->effectiveEnable;
4119 }
4120
4121 void QQuickItem::setEnabled(bool e)
4122 {
4123     Q_D(QQuickItem);
4124     if (e == d->explicitEnable)
4125         return;
4126
4127     d->explicitEnable = e;
4128
4129     QQuickItem *scope = parentItem();
4130     while (scope && !scope->isFocusScope())
4131         scope = scope->parentItem();
4132
4133     d->setEffectiveEnableRecur(scope, d->calcEffectiveEnable());
4134 }
4135
4136 bool QQuickItemPrivate::calcEffectiveVisible() const
4137 {
4138     // XXX todo - Should the effective visible of an element with no parent just be the current
4139     // effective visible?  This would prevent pointless re-processing in the case of an element
4140     // moving to/from a no-parent situation, but it is different from what graphics view does.
4141     return explicitVisible && (!parentItem || QQuickItemPrivate::get(parentItem)->effectiveVisible);
4142 }
4143
4144 bool QQuickItemPrivate::setEffectiveVisibleRecur(bool newEffectiveVisible)
4145 {
4146     Q_Q(QQuickItem);
4147
4148     if (newEffectiveVisible && !explicitVisible) {
4149         // This item locally overrides visibility
4150         return false;   // effective visibility didn't change
4151     }
4152
4153     if (newEffectiveVisible == effectiveVisible) {
4154         // No change necessary
4155         return false;   // effective visibility didn't change
4156     }
4157
4158     effectiveVisible = newEffectiveVisible;
4159     dirty(Visible);
4160     if (parentItem) QQuickItemPrivate::get(parentItem)->dirty(ChildrenStackingChanged);
4161
4162     if (canvas) {
4163         QQuickCanvasPrivate *canvasPriv = QQuickCanvasPrivate::get(canvas);
4164         if (canvasPriv->mouseGrabberItem == q)
4165             q->ungrabMouse();
4166     }
4167
4168     bool childVisibilityChanged = false;
4169     for (int ii = 0; ii < childItems.count(); ++ii)
4170         childVisibilityChanged |= QQuickItemPrivate::get(childItems.at(ii))->setEffectiveVisibleRecur(newEffectiveVisible);
4171
4172     itemChange(QQuickItem::ItemVisibleHasChanged, effectiveVisible);
4173 #ifndef QT_NO_ACCESSIBILITY
4174     if (isAccessible) {
4175         QAccessibleEvent ev(q, effectiveVisible ? QAccessible::ObjectShow : QAccessible::ObjectHide);
4176         QAccessible::updateAccessibility(&ev);
4177     }
4178 #endif
4179     emit q->visibleChanged();
4180     if (childVisibilityChanged)
4181         emit q->visibleChildrenChanged();
4182
4183     return true;    // effective visibility DID change
4184 }
4185
4186 bool QQuickItemPrivate::calcEffectiveEnable() const
4187 {
4188     // XXX todo - Should the effective enable of an element with no parent just be the current
4189     // effective enable?  This would prevent pointless re-processing in the case of an element
4190     // moving to/from a no-parent situation, but it is different from what graphics view does.
4191     return explicitEnable && (!parentItem || QQuickItemPrivate::get(parentItem)->effectiveEnable);
4192 }
4193
4194 void QQuickItemPrivate::setEffectiveEnableRecur(QQuickItem *scope, bool newEffectiveEnable)
4195 {
4196     Q_Q(QQuickItem);
4197
4198     if (newEffectiveEnable && !explicitEnable) {
4199         // This item locally overrides enable
4200         return;
4201     }
4202
4203     if (newEffectiveEnable == effectiveEnable) {
4204         // No change necessary
4205         return;
4206     }
4207
4208     effectiveEnable = newEffectiveEnable;
4209
4210     if (canvas) {
4211         QQuickCanvasPrivate *canvasPriv = QQuickCanvasPrivate::get(canvas);
4212         if (canvasPriv->mouseGrabberItem == q)
4213             q->ungrabMouse();
4214         if (scope && !effectiveEnable && activeFocus) {
4215             canvasPriv->clearFocusInScope(
4216                     scope, q,  QQuickCanvasPrivate::DontChangeFocusProperty | QQuickCanvasPrivate::DontChangeSubFocusItem);
4217         }
4218     }
4219
4220     for (int ii = 0; ii < childItems.count(); ++ii) {
4221         QQuickItemPrivate::get(childItems.at(ii))->setEffectiveEnableRecur(
4222                 (flags & QQuickItem::ItemIsFocusScope) && scope ? q : scope, newEffectiveEnable);
4223     }
4224
4225     if (canvas && scope && effectiveEnable && focus) {
4226         QQuickCanvasPrivate::get(canvas)->setFocusInScope(
4227                 scope, q, QQuickCanvasPrivate::DontChangeFocusProperty | QQuickCanvasPrivate::DontChangeSubFocusItem);
4228     }
4229
4230     emit q->enabledChanged();
4231 }
4232
4233 QString QQuickItemPrivate::dirtyToString() const
4234 {
4235 #define DIRTY_TO_STRING(value) if (dirtyAttributes & value) { \
4236     if (!rv.isEmpty()) \
4237         rv.append(QLatin1String("|")); \
4238     rv.append(QLatin1String(#value)); \
4239 }
4240
4241 //    QString rv = QLatin1String("0x") + QString::number(dirtyAttributes, 16);
4242     QString rv;
4243
4244     DIRTY_TO_STRING(TransformOrigin);
4245     DIRTY_TO_STRING(Transform);
4246     DIRTY_TO_STRING(BasicTransform);
4247     DIRTY_TO_STRING(Position);
4248     DIRTY_TO_STRING(Size);
4249     DIRTY_TO_STRING(ZValue);
4250     DIRTY_TO_STRING(Content);
4251     DIRTY_TO_STRING(Smooth);
4252     DIRTY_TO_STRING(OpacityValue);
4253     DIRTY_TO_STRING(ChildrenChanged);
4254     DIRTY_TO_STRING(ChildrenStackingChanged);
4255     DIRTY_TO_STRING(ParentChanged);
4256     DIRTY_TO_STRING(Clip);
4257     DIRTY_TO_STRING(Canvas);
4258     DIRTY_TO_STRING(EffectReference);
4259     DIRTY_TO_STRING(Visible);
4260     DIRTY_TO_STRING(HideReference);
4261     DIRTY_TO_STRING(PerformanceHints);
4262
4263     return rv;
4264 }
4265
4266 void QQuickItemPrivate::dirty(DirtyType type)
4267 {
4268     Q_Q(QQuickItem);
4269     if (type & (TransformOrigin | Transform | BasicTransform | Position | Size))
4270         transformChanged();
4271
4272     if (!(dirtyAttributes & type) || (canvas && !prevDirtyItem)) {
4273         dirtyAttributes |= type;
4274         if (canvas) {
4275             addToDirtyList();
4276             QQuickCanvasPrivate::get(canvas)->dirtyItem(q);
4277         }
4278     }
4279 }
4280
4281 void QQuickItemPrivate::addToDirtyList()
4282 {
4283     Q_Q(QQuickItem);
4284
4285     Q_ASSERT(canvas);
4286     if (!prevDirtyItem) {
4287         Q_ASSERT(!nextDirtyItem);
4288
4289         QQuickCanvasPrivate *p = QQuickCanvasPrivate::get(canvas);
4290         nextDirtyItem = p->dirtyItemList;
4291         if (nextDirtyItem) QQuickItemPrivate::get(nextDirtyItem)->prevDirtyItem = &nextDirtyItem;
4292         prevDirtyItem = &p->dirtyItemList;
4293         p->dirtyItemList = q;
4294         p->dirtyItem(q);
4295     }
4296     Q_ASSERT(prevDirtyItem);
4297 }
4298
4299 void QQuickItemPrivate::removeFromDirtyList()
4300 {
4301     if (prevDirtyItem) {
4302         if (nextDirtyItem) QQuickItemPrivate::get(nextDirtyItem)->prevDirtyItem = prevDirtyItem;
4303         *prevDirtyItem = nextDirtyItem;
4304         prevDirtyItem = 0;
4305         nextDirtyItem = 0;
4306     }
4307     Q_ASSERT(!prevDirtyItem);
4308     Q_ASSERT(!nextDirtyItem);
4309 }
4310
4311 void QQuickItemPrivate::refFromEffectItem(bool hide)
4312 {
4313     ++extra.value().effectRefCount;
4314     if (1 == extra->effectRefCount) {
4315         dirty(EffectReference);
4316         if (parentItem) QQuickItemPrivate::get(parentItem)->dirty(ChildrenStackingChanged);
4317     }
4318     if (hide) {
4319         if (++extra->hideRefCount == 1)
4320             dirty(HideReference);
4321     }
4322 }
4323
4324 void QQuickItemPrivate::derefFromEffectItem(bool unhide)
4325 {
4326     Q_ASSERT(extra->effectRefCount);
4327     --extra->effectRefCount;
4328     if (0 == extra->effectRefCount) {
4329         dirty(EffectReference);
4330         if (parentItem) QQuickItemPrivate::get(parentItem)->dirty(ChildrenStackingChanged);
4331     }
4332     if (unhide) {
4333         if (--extra->hideRefCount == 0)
4334             dirty(HideReference);
4335     }
4336 }
4337
4338 void QQuickItemPrivate::itemChange(QQuickItem::ItemChange change, const QQuickItem::ItemChangeData &data)
4339 {
4340     Q_Q(QQuickItem);
4341     switch (change) {
4342     case QQuickItem::ItemChildAddedChange:
4343         q->itemChange(change, data);
4344         for (int ii = 0; ii < changeListeners.count(); ++ii) {
4345             const QQuickItemPrivate::ChangeListener &change = changeListeners.at(ii);
4346             if (change.types & QQuickItemPrivate::Children) {
4347                 change.listener->itemChildAdded(q, data.item);
4348             }
4349         }
4350         break;
4351     case QQuickItem::ItemChildRemovedChange:
4352         q->itemChange(change, data);
4353         for (int ii = 0; ii < changeListeners.count(); ++ii) {
4354             const QQuickItemPrivate::ChangeListener &change = changeListeners.at(ii);
4355             if (change.types & QQuickItemPrivate::Children) {
4356                 change.listener->itemChildRemoved(q, data.item);
4357             }
4358         }
4359         break;
4360     case QQuickItem::ItemSceneChange:
4361         q->itemChange(change, data);
4362         break;
4363     case QQuickItem::ItemVisibleHasChanged:
4364         q->itemChange(change, data);
4365         for (int ii = 0; ii < changeListeners.count(); ++ii) {
4366             const QQuickItemPrivate::ChangeListener &change = changeListeners.at(ii);
4367             if (change.types & QQuickItemPrivate::Visibility) {
4368                 change.listener->itemVisibilityChanged(q);
4369             }
4370         }
4371         break;
4372     case QQuickItem::ItemParentHasChanged:
4373         q->itemChange(change, data);
4374         for (int ii = 0; ii < changeListeners.count(); ++ii) {
4375             const QQuickItemPrivate::ChangeListener &change = changeListeners.at(ii);
4376             if (change.types & QQuickItemPrivate::Parent) {
4377                 change.listener->itemParentChanged(q, data.item);
4378             }
4379         }
4380         break;
4381     case QQuickItem::ItemOpacityHasChanged:
4382         q->itemChange(change, data);
4383         for (int ii = 0; ii < changeListeners.count(); ++ii) {
4384             const QQuickItemPrivate::ChangeListener &change = changeListeners.at(ii);
4385             if (change.types & QQuickItemPrivate::Opacity) {
4386                 change.listener->itemOpacityChanged(q);
4387             }
4388         }
4389         break;
4390     case QQuickItem::ItemActiveFocusHasChanged:
4391         q->itemChange(change, data);
4392         break;
4393     case QQuickItem::ItemRotationHasChanged:
4394         q->itemChange(change, data);
4395         for (int ii = 0; ii < changeListeners.count(); ++ii) {
4396             const QQuickItemPrivate::ChangeListener &change = changeListeners.at(ii);
4397             if (change.types & QQuickItemPrivate::Rotation) {
4398                 change.listener->itemRotationChanged(q);
4399             }
4400         }
4401         break;
4402     }
4403 }
4404
4405 /*!
4406     \property QQuickItem::smooth
4407     \brief whether the item is smoothed or not.
4408
4409     Primarily used in image based elements to decide if the item should use smooth
4410     sampling or not. Smooth sampling is performed using linear interpolation, while
4411     non-smooth is performed using nearest neighbor.
4412
4413     In Qt Quick 2.0, this property has minimal impact on performance.
4414
4415     By default is true.
4416 */
4417
4418 /*!
4419     Returns true if the item should be drawn with antialiasing and
4420     smooth pixmap filtering, false otherwise.
4421
4422     The default is false.
4423
4424     \sa setSmooth()
4425 */
4426 bool QQuickItem::smooth() const
4427 {
4428     Q_D(const QQuickItem);
4429     return d->smooth;
4430 }
4431
4432 /*!
4433     Sets whether the item should be drawn with antialiasing and
4434     smooth pixmap filtering to \a smooth.
4435
4436     \sa smooth()
4437 */
4438 void QQuickItem::setSmooth(bool smooth)
4439 {
4440     Q_D(QQuickItem);
4441     if (d->smooth == smooth)
4442         return;
4443
4444     d->smooth = smooth;
4445     d->dirty(QQuickItemPrivate::Smooth);
4446
4447     emit smoothChanged(smooth);
4448 }
4449
4450 QQuickItem::Flags QQuickItem::flags() const
4451 {
4452     Q_D(const QQuickItem);
4453     return (QQuickItem::Flags)d->flags;
4454 }
4455
4456 void QQuickItem::setFlag(Flag flag, bool enabled)
4457 {
4458     Q_D(QQuickItem);
4459     if (enabled)
4460         setFlags((Flags)(d->flags | (quint32)flag));
4461     else
4462         setFlags((Flags)(d->flags & ~(quint32)flag));
4463 }
4464
4465 void QQuickItem::setFlags(Flags flags)
4466 {
4467     Q_D(QQuickItem);
4468
4469     if ((flags & ItemIsFocusScope) != (d->flags & ItemIsFocusScope)) {
4470         if (flags & ItemIsFocusScope && !d->childItems.isEmpty() && d->canvas) {
4471             qWarning("QQuickItem: Cannot set FocusScope once item has children and is in a canvas.");
4472             flags &= ~ItemIsFocusScope;
4473         } else if (d->flags & ItemIsFocusScope) {
4474             qWarning("QQuickItem: Cannot unset FocusScope flag.");
4475             flags |= ItemIsFocusScope;
4476         }
4477     }
4478
4479     if ((flags & ItemClipsChildrenToShape ) != (d->flags & ItemClipsChildrenToShape))
4480         d->dirty(QQuickItemPrivate::Clip);
4481
4482     d->flags = flags;
4483 }
4484
4485 qreal QQuickItem::x() const
4486 {
4487     Q_D(const QQuickItem);
4488     return d->x;
4489 }
4490
4491 qreal QQuickItem::y() const
4492 {
4493     Q_D(const QQuickItem);
4494     return d->y;
4495 }
4496
4497 QPointF QQuickItem::pos() const
4498 {
4499     Q_D(const QQuickItem);
4500     return QPointF(d->x, d->y);
4501 }
4502
4503 void QQuickItem::setX(qreal v)
4504 {
4505     Q_D(QQuickItem);
4506     if (d->x == v)
4507         return;
4508
4509     qreal oldx = d->x;
4510     d->x = v;
4511
4512     d->dirty(QQuickItemPrivate::Position);
4513
4514     geometryChanged(QRectF(x(), y(), width(), height()),
4515                     QRectF(oldx, y(), width(), height()));
4516 }
4517
4518 void QQuickItem::setY(qreal v)
4519 {
4520     Q_D(QQuickItem);
4521     if (d->y == v)
4522         return;
4523
4524     qreal oldy = d->y;
4525     d->y = v;
4526
4527     d->dirty(QQuickItemPrivate::Position);
4528
4529     geometryChanged(QRectF(x(), y(), width(), height()),
4530                     QRectF(x(), oldy, width(), height()));
4531 }
4532
4533 void QQuickItem::setPos(const QPointF &pos)
4534 {
4535     Q_D(QQuickItem);
4536     if (QPointF(d->x, d->y) == pos)
4537         return;
4538
4539     qreal oldx = d->x;
4540     qreal oldy = d->y;
4541
4542     d->x = pos.x();
4543     d->y = pos.y();
4544
4545     d->dirty(QQuickItemPrivate::Position);
4546
4547     geometryChanged(QRectF(x(), y(), width(), height()),
4548                     QRectF(oldx, oldy, width(), height()));
4549 }
4550
4551 qreal QQuickItem::width() const
4552 {
4553     Q_D(const QQuickItem);
4554     return d->width;
4555 }
4556
4557 void QQuickItem::setWidth(qreal w)
4558 {
4559     Q_D(QQuickItem);
4560     if (qIsNaN(w))
4561         return;
4562
4563     d->widthValid = true;
4564     if (d->width == w)
4565         return;
4566
4567     qreal oldWidth = d->width;
4568     d->width = w;
4569
4570     d->dirty(QQuickItemPrivate::Size);
4571
4572     geometryChanged(QRectF(x(), y(), width(), height()),
4573                     QRectF(x(), y(), oldWidth, height()));
4574 }
4575
4576 void QQuickItem::resetWidth()
4577 {
4578     Q_D(QQuickItem);
4579     d->widthValid = false;
4580     setImplicitWidth(implicitWidth());
4581 }
4582
4583 void QQuickItemPrivate::implicitWidthChanged()
4584 {
4585     Q_Q(QQuickItem);
4586     for (int ii = 0; ii < changeListeners.count(); ++ii) {
4587         const QQuickItemPrivate::ChangeListener &change = changeListeners.at(ii);
4588         if (change.types & QQuickItemPrivate::ImplicitWidth) {
4589             change.listener->itemImplicitWidthChanged(q);
4590         }
4591     }
4592     emit q->implicitWidthChanged();
4593 }
4594
4595 qreal QQuickItemPrivate::getImplicitWidth() const
4596 {
4597     return implicitWidth;
4598 }
4599 /*!
4600     Returns the width of the item that is implied by other properties that determine the content.
4601 */
4602 qreal QQuickItem::implicitWidth() const
4603 {
4604     Q_D(const QQuickItem);
4605     return d->getImplicitWidth();
4606 }
4607
4608 /*!
4609     \qmlproperty real QtQuick2::Item::implicitWidth
4610     \qmlproperty real QtQuick2::Item::implicitHeight
4611
4612     Defines the natural width or height of the Item if no \l width or \l height is specified.
4613
4614     The default implicit size for most items is 0x0, however some elements have an inherent
4615     implicit size which cannot be overridden, e.g. Image, Text.
4616
4617     Setting the implicit size is useful for defining components that have a preferred size
4618     based on their content, for example:
4619
4620     \qml
4621     // Label.qml
4622     import QtQuick 2.0
4623
4624     Item {
4625         property alias icon: image.source
4626         property alias label: text.text
4627         implicitWidth: text.implicitWidth + image.implicitWidth
4628         implicitHeight: Math.max(text.implicitHeight, image.implicitHeight)
4629         Image { id: image }
4630         Text {
4631             id: text
4632             wrapMode: Text.Wrap
4633             anchors.left: image.right; anchors.right: parent.right
4634             anchors.verticalCenter: parent.verticalCenter
4635         }
4636     }
4637     \endqml
4638
4639     \b Note: using implicitWidth of Text or TextEdit and setting the width explicitly
4640     incurs a performance penalty as the text must be laid out twice.
4641 */
4642
4643 /*!
4644     Sets the implied width of the item to \a w.
4645     This is the width implied by other properties that determine the content.
4646 */
4647 void QQuickItem::setImplicitWidth(qreal w)
4648 {
4649     Q_D(QQuickItem);
4650     bool changed = w != d->implicitWidth;
4651     d->implicitWidth = w;
4652     if (d->width == w || widthValid()) {
4653         if (changed)
4654             d->implicitWidthChanged();
4655         if (d->width == w || widthValid())
4656             return;
4657         changed = false;
4658     }
4659
4660     qreal oldWidth = d->width;
4661     d->width = w;
4662
4663     d->dirty(QQuickItemPrivate::Size);
4664
4665     geometryChanged(QRectF(x(), y(), width(), height()),
4666                     QRectF(x(), y(), oldWidth, height()));
4667
4668     if (changed)
4669         d->implicitWidthChanged();
4670 }
4671
4672 /*!
4673     Returns whether the width property has been set explicitly.
4674 */
4675 bool QQuickItem::widthValid() const
4676 {
4677     Q_D(const QQuickItem);
4678     return d->widthValid;
4679 }
4680
4681 qreal QQuickItem::height() const
4682 {
4683     Q_D(const QQuickItem);
4684     return d->height;
4685 }
4686
4687 void QQuickItem::setHeight(qreal h)
4688 {
4689     Q_D(QQuickItem);
4690     if (qIsNaN(h))
4691         return;
4692
4693     d->heightValid = true;
4694     if (d->height == h)
4695         return;
4696
4697     qreal oldHeight = d->height;
4698     d->height = h;
4699
4700     d->dirty(QQuickItemPrivate::Size);
4701
4702     geometryChanged(QRectF(x(), y(), width(), height()),
4703                     QRectF(x(), y(), width(), oldHeight));
4704 }
4705
4706 void QQuickItem::resetHeight()
4707 {
4708     Q_D(QQuickItem);
4709     d->heightValid = false;
4710     setImplicitHeight(implicitHeight());
4711 }
4712
4713 void QQuickItemPrivate::implicitHeightChanged()
4714 {
4715     Q_Q(QQuickItem);
4716     for (int ii = 0; ii < changeListeners.count(); ++ii) {
4717         const QQuickItemPrivate::ChangeListener &change = changeListeners.at(ii);
4718         if (change.types & QQuickItemPrivate::ImplicitHeight) {
4719             change.listener->itemImplicitHeightChanged(q);
4720         }
4721     }
4722     emit q->implicitHeightChanged();
4723 }
4724
4725 qreal QQuickItemPrivate::getImplicitHeight() const
4726 {
4727     return implicitHeight;
4728 }
4729
4730 /*!
4731     Returns the height of the item that is implied by other properties that determine the content.
4732 */
4733 qreal QQuickItem::implicitHeight() const
4734 {
4735     Q_D(const QQuickItem);
4736     return d->getImplicitHeight();
4737 }
4738
4739
4740 /*!
4741     Sets the implied height of the item to \a h.
4742     This is the height implied by other properties that determine the content.
4743 */
4744 void QQuickItem::setImplicitHeight(qreal h)
4745 {
4746     Q_D(QQuickItem);
4747     bool changed = h != d->implicitHeight;
4748     d->implicitHeight = h;
4749     if (d->height == h || heightValid()) {
4750         if (changed)
4751             d->implicitHeightChanged();
4752         if (d->height == h || heightValid())
4753             return;
4754         changed = false;
4755     }
4756
4757     qreal oldHeight = d->height;
4758     d->height = h;
4759
4760     d->dirty(QQuickItemPrivate::Size);
4761
4762     geometryChanged(QRectF(x(), y(), width(), height()),
4763                     QRectF(x(), y(), width(), oldHeight));
4764
4765     if (changed)
4766         d->implicitHeightChanged();
4767 }
4768
4769 void QQuickItem::setImplicitSize(qreal w, qreal h)
4770 {
4771     Q_D(QQuickItem);
4772     bool wChanged = w != d->implicitWidth;
4773     bool hChanged = h != d->implicitHeight;
4774
4775     d->implicitWidth = w;
4776     d->implicitHeight = h;
4777
4778     bool wDone = false;
4779     bool hDone = false;
4780     if (d->width == w || widthValid()) {
4781         if (wChanged)
4782             d->implicitWidthChanged();
4783         wDone = d->width == w || widthValid();
4784         wChanged = false;
4785     }
4786     if (d->height == h || heightValid()) {
4787         if (hChanged)
4788             d->implicitHeightChanged();
4789         hDone = d->height == h || heightValid();
4790         hChanged = false;
4791     }
4792     if (wDone && hDone)
4793         return;
4794
4795     qreal oldWidth = d->width;
4796     qreal oldHeight = d->height;
4797     if (!wDone)
4798         d->width = w;
4799     if (!hDone)
4800         d->height = h;
4801
4802     d->dirty(QQuickItemPrivate::Size);
4803
4804     geometryChanged(QRectF(x(), y(), width(), height()),
4805                     QRectF(x(), y(), oldWidth, oldHeight));
4806
4807     if (!wDone && wChanged)
4808         d->implicitWidthChanged();
4809     if (!hDone && hChanged)
4810         d->implicitHeightChanged();
4811 }
4812
4813 /*!
4814     Returns whether the height property has been set explicitly.
4815 */
4816 bool QQuickItem::heightValid() const
4817 {
4818     Q_D(const QQuickItem);
4819     return d->heightValid;
4820 }
4821
4822 void QQuickItem::setSize(const QSizeF &size)
4823 {
4824     Q_D(QQuickItem);
4825     d->heightValid = true;
4826     d->widthValid = true;
4827
4828     if (QSizeF(d->width, d->height) == size)
4829         return;
4830
4831     qreal oldHeight = d->height;
4832     qreal oldWidth = d->width;
4833     d->height = size.height();
4834     d->width = size.width();
4835
4836     d->dirty(QQuickItemPrivate::Size);
4837
4838     geometryChanged(QRectF(x(), y(), width(), height()),
4839                     QRectF(x(), y(), oldWidth, oldHeight));
4840 }
4841
4842 bool QQuickItem::hasActiveFocus() const
4843 {
4844     Q_D(const QQuickItem);
4845     return d->activeFocus;
4846 }
4847
4848 bool QQuickItem::hasFocus() const
4849 {
4850     Q_D(const QQuickItem);
4851     return d->focus;
4852 }
4853
4854 void QQuickItem::setFocus(bool focus)
4855 {
4856     Q_D(QQuickItem);
4857     if (d->focus == focus)
4858         return;
4859
4860     if (d->canvas || d->parentItem) {
4861         // Need to find our nearest focus scope
4862         QQuickItem *scope = parentItem();
4863         while (scope && !scope->isFocusScope() && scope->parentItem())
4864             scope = scope->parentItem();
4865         if (d->canvas) {
4866             if (focus)
4867                 QQuickCanvasPrivate::get(d->canvas)->setFocusInScope(scope, this);
4868             else
4869                 QQuickCanvasPrivate::get(d->canvas)->clearFocusInScope(scope, this);
4870         } else {
4871             // do the focus changes from setFocusInScope/clearFocusInScope that are
4872             // unrelated to a canvas
4873             QVarLengthArray<QQuickItem *, 20> changed;
4874             QQuickItem *oldSubFocusItem = QQuickItemPrivate::get(scope)->subFocusItem;
4875             if (oldSubFocusItem) {
4876                 QQuickItemPrivate::get(oldSubFocusItem)->updateSubFocusItem(scope, false);
4877                 QQuickItemPrivate::get(oldSubFocusItem)->focus = false;
4878                 changed << oldSubFocusItem;
4879             }
4880             d->updateSubFocusItem(scope, focus);
4881
4882             d->focus = focus;
4883             changed << this;
4884             emit focusChanged(focus);
4885
4886             QQuickCanvasPrivate::notifyFocusChangesRecur(changed.data(), changed.count() - 1);
4887         }
4888     } else {
4889         d->focus = focus;
4890         emit focusChanged(focus);
4891     }
4892 }
4893
4894 bool QQuickItem::isFocusScope() const
4895 {
4896     return flags() & ItemIsFocusScope;
4897 }
4898
4899 QQuickItem *QQuickItem::scopedFocusItem() const
4900 {
4901     Q_D(const QQuickItem);
4902     if (!isFocusScope())
4903         return 0;
4904     else
4905         return d->subFocusItem;
4906 }
4907
4908
4909 Qt::MouseButtons QQuickItem::acceptedMouseButtons() const
4910 {
4911     Q_D(const QQuickItem);
4912     return d->acceptedMouseButtons();
4913 }
4914
4915 void QQuickItem::setAcceptedMouseButtons(Qt::MouseButtons buttons)
4916 {
4917     Q_D(QQuickItem);
4918     if (buttons & Qt::LeftButton)
4919         d->extra.setFlag();
4920     else
4921         d->extra.clearFlag();
4922
4923     buttons &= ~Qt::LeftButton;
4924     if (buttons || d->extra.isAllocated())
4925         d->extra.value().acceptedMouseButtons = buttons;
4926 }
4927
4928 bool QQuickItem::filtersChildMouseEvents() const
4929 {
4930     Q_D(const QQuickItem);
4931     return d->filtersChildMouseEvents;
4932 }
4933
4934 void QQuickItem::setFiltersChildMouseEvents(bool filter)
4935 {
4936     Q_D(QQuickItem);
4937     d->filtersChildMouseEvents = filter;
4938 }
4939
4940 bool QQuickItem::isUnderMouse() const
4941 {
4942     Q_D(const QQuickItem);
4943     if (!d->canvas)
4944         return false;
4945
4946     QPointF cursorPos = QGuiApplicationPrivate::lastCursorPosition;
4947     return contains(mapFromScene(cursorPos)); // ### refactor: d->canvas->mapFromGlobal(cursorPos))))
4948 }
4949
4950 bool QQuickItem::acceptHoverEvents() const
4951 {
4952     Q_D(const QQuickItem);
4953     return d->hoverEnabled;
4954 }
4955
4956 void QQuickItem::setAcceptHoverEvents(bool enabled)
4957 {
4958     Q_D(QQuickItem);
4959     d->hoverEnabled = enabled;
4960 }
4961
4962 void QQuickItem::grabMouse()
4963 {
4964     Q_D(QQuickItem);
4965     if (!d->canvas)
4966         return;
4967     QQuickCanvasPrivate *canvasPriv = QQuickCanvasPrivate::get(d->canvas);
4968     if (canvasPriv->mouseGrabberItem == this)
4969         return;
4970
4971     QQuickItem *oldGrabber = canvasPriv->mouseGrabberItem;
4972     canvasPriv->mouseGrabberItem = this;
4973     if (oldGrabber) {
4974         QEvent ev(QEvent::UngrabMouse);
4975         d->canvas->sendEvent(oldGrabber, &ev);
4976     }
4977 }
4978
4979 void QQuickItem::ungrabMouse()
4980 {
4981     Q_D(QQuickItem);
4982     if (!d->canvas)
4983         return;
4984     QQuickCanvasPrivate *canvasPriv = QQuickCanvasPrivate::get(d->canvas);
4985     if (canvasPriv->mouseGrabberItem != this) {
4986         qWarning("QQuickItem::ungrabMouse(): Item is not the mouse grabber.");
4987         return;
4988     }
4989
4990     canvasPriv->mouseGrabberItem = 0;
4991
4992     QEvent ev(QEvent::UngrabMouse);
4993     d->canvas->sendEvent(this, &ev);
4994 }
4995
4996 bool QQuickItem::keepMouseGrab() const
4997 {
4998     Q_D(const QQuickItem);
4999     return d->keepMouse;
5000 }
5001
5002 /*!
5003   The flag indicating whether the mouse should remain
5004   with this item is set to \a keep.
5005
5006   This is useful for items that wish to grab and keep mouse
5007   interaction following a predefined gesture.  For example,
5008   an item that is interested in horizontal mouse movement
5009   may set keepMouseGrab to true once a threshold has been
5010   exceeded.  Once keepMouseGrab has been set to true, filtering
5011   items will not react to mouse events.
5012
5013   If the item does not indicate that it wishes to retain mouse grab,
5014   a filtering item may steal the grab. For example, Flickable may attempt
5015   to steal a mouse grab if it detects that the user has begun to
5016   move the viewport.
5017
5018   \sa keepMouseGrab()
5019  */
5020 void QQuickItem::setKeepMouseGrab(bool keep)
5021 {
5022     Q_D(QQuickItem);
5023     d->keepMouse = keep;
5024 }
5025
5026 /*!
5027     Grabs the touch points specified by \a ids.
5028
5029     These touch points will be owned by the item until
5030     they are released. Alternatively, the grab can be stolen
5031     by a filtering item like Flickable. Use setKeepTouchGrab()
5032     to prevent the grab from being stolen.
5033
5034     \sa ungrabTouchPoints(), setKeepTouchGrab()
5035 */
5036 void QQuickItem::grabTouchPoints(const QList<int> &ids)
5037 {
5038     Q_D(QQuickItem);
5039     if (!d->canvas)
5040         return;
5041     QQuickCanvasPrivate *canvasPriv = QQuickCanvasPrivate::get(d->canvas);
5042
5043     QSet<QQuickItem*> ungrab;
5044     for (int i = 0; i < ids.count(); ++i) {
5045         QQuickItem *oldGrabber = canvasPriv->itemForTouchPointId.value(ids.at(i));
5046         if (oldGrabber == this)
5047             return;
5048
5049         canvasPriv->itemForTouchPointId[ids.at(i)] = this;
5050         if (oldGrabber)
5051             ungrab.insert(oldGrabber);
5052     }
5053     foreach (QQuickItem *oldGrabber, ungrab)
5054         oldGrabber->touchUngrabEvent();
5055 }
5056
5057 /*!
5058     Ungrabs the touch points owned by this item.
5059
5060     \sa grabTouchPoints()
5061 */
5062 void QQuickItem::ungrabTouchPoints()
5063 {
5064     Q_D(QQuickItem);
5065     if (!d->canvas)
5066         return;
5067     QQuickCanvasPrivate *canvasPriv = QQuickCanvasPrivate::get(d->canvas);
5068
5069     QMutableHashIterator<int, QQuickItem*> i(canvasPriv->itemForTouchPointId);
5070     while (i.hasNext()) {
5071         i.next();
5072         if (i.value() == this)
5073             i.remove();
5074     }
5075     touchUngrabEvent();
5076 }
5077
5078 /*!
5079     Returns a value indicating whether the touch points grabbed by this item
5080     should remain with this item exclusively.
5081
5082     \sa setKeepTouchGrab(), keepMouseGrab()
5083 */
5084 bool QQuickItem::keepTouchGrab() const
5085 {
5086     Q_D(const QQuickItem);
5087     return d->keepTouch;
5088 }
5089
5090 /*!
5091   The flag indicating whether the touch points grabbed
5092   by this item should remain with this item is set to \a keep.
5093
5094   This is useful for items that wish to grab and keep specific touch
5095   points following a predefined gesture.  For example,
5096   an item that is interested in horizontal touch point movement
5097   may set setKeepTouchGrab to true once a threshold has been
5098   exceeded.  Once setKeepTouchGrab has been set to true, filtering
5099   items will not react to the relevant touch points.
5100
5101   If the item does not indicate that it wishes to retain touch point grab,
5102   a filtering item may steal the grab. For example, Flickable may attempt
5103   to steal a touch point grab if it detects that the user has begun to
5104   move the viewport.
5105
5106   \sa keepTouchGrab(), setKeepMouseGrab()
5107  */
5108 void QQuickItem::setKeepTouchGrab(bool keep)
5109 {
5110     Q_D(QQuickItem);
5111     d->keepTouch = keep;
5112 }
5113
5114 /*!
5115   Returns true if this item contains \a point, which is in local coordinates;
5116   returns false otherwise.
5117
5118   This function can be overwritten in order to handle point collisions in items
5119   with custom shapes. The default implementation checks if the point is inside
5120   the item's bounding rect.
5121
5122   Note that it's normally used to check if the item is under the mouse cursor,
5123   and for that reason, the implementation of this function should be as light-weight
5124   as possible.
5125 */
5126 bool QQuickItem::contains(const QPointF &point) const
5127 {
5128     Q_D(const QQuickItem);
5129     return QRectF(0, 0, d->width, d->height).contains(point);
5130 }
5131
5132 /*!
5133     \qmlmethod object QtQuick2::Item::mapFromItem(Item item, real x, real y)
5134
5135     Maps the point (\a x, \a y), which is in \a item's coordinate system, to
5136     this item's coordinate system, and returns an object with \c x and \c y
5137     properties matching the mapped coordinate.
5138
5139     If \a item is a \c null value, this maps the point from the coordinate
5140     system of the root QML view.
5141 */
5142 /*!
5143     \qmlmethod object QtQuick2::Item::mapToItem(Item item, real x, real y)
5144
5145     Maps the point (\a x, \a y), which is in this item's coordinate system, to
5146     \a item's coordinate system, and returns an object with \c x and \c y
5147     properties matching the mapped coordinate.
5148
5149     If \a item is a \c null value, this maps \a x and \a y to the coordinate
5150     system of the root QML view.
5151 */
5152 QPointF QQuickItem::mapToItem(const QQuickItem *item, const QPointF &point) const
5153 {
5154     QPointF p = mapToScene(point);
5155     if (item)
5156         p = item->mapFromScene(p);
5157     return p;
5158 }
5159
5160 QPointF QQuickItem::mapToScene(const QPointF &point) const
5161 {
5162     Q_D(const QQuickItem);
5163     return d->itemToCanvasTransform().map(point);
5164 }
5165
5166 QRectF QQuickItem::mapRectToItem(const QQuickItem *item, const QRectF &rect) const
5167 {
5168     Q_D(const QQuickItem);
5169     QTransform t = d->itemToCanvasTransform();
5170     if (item)
5171         t *= QQuickItemPrivate::get(item)->canvasToItemTransform();
5172     return t.mapRect(rect);
5173 }
5174
5175 QRectF QQuickItem::mapRectToScene(const QRectF &rect) const
5176 {
5177     Q_D(const QQuickItem);
5178     return d->itemToCanvasTransform().mapRect(rect);
5179 }
5180
5181 QPointF QQuickItem::mapFromItem(const QQuickItem *item, const QPointF &point) const
5182 {
5183     QPointF p = item?item->mapToScene(point):point;
5184     return mapFromScene(p);
5185 }
5186
5187 QPointF QQuickItem::mapFromScene(const QPointF &point) const
5188 {
5189     Q_D(const QQuickItem);
5190     return d->canvasToItemTransform().map(point);
5191 }
5192
5193 QRectF QQuickItem::mapRectFromItem(const QQuickItem *item, const QRectF &rect) const
5194 {
5195     Q_D(const QQuickItem);
5196     QTransform t = item?QQuickItemPrivate::get(item)->itemToCanvasTransform():QTransform();
5197     t *= d->canvasToItemTransform();
5198     return t.mapRect(rect);
5199 }
5200
5201 QRectF QQuickItem::mapRectFromScene(const QRectF &rect) const
5202 {
5203     Q_D(const QQuickItem);
5204     return d->canvasToItemTransform().mapRect(rect);
5205 }
5206
5207
5208 /*!
5209     \qmlmethod QtQuick2::Item::forceActiveFocus()
5210
5211     Forces active focus on the item.
5212
5213     This method sets focus on the item and makes sure that all the focus scopes
5214     higher in the object hierarchy are also given the focus.
5215 */
5216
5217 /*!
5218     Forces active focus on the item.
5219
5220     This method sets focus on the item and makes sure that all the focus scopes
5221     higher in the object hierarchy are also given the focus.
5222 */
5223
5224 /*!
5225   \qmlmethod QtQuick2::Item::childAt(real x, real y)
5226
5227   Returns the visible child item at point (\a x, \a y), which is in this
5228   item's coordinate system, or \c null if there is no such item.
5229 */
5230
5231 /*!
5232   Returns the visible child item at point (\a x, \a y), which is in this
5233   item's coordinate system, or 0 if there is no such item.
5234 */
5235
5236 /*!
5237   \qmlproperty list<State> QtQuick2::Item::states
5238   This property holds a list of states defined by the item.
5239
5240   \qml
5241   Item {
5242       states: [
5243           State {
5244               // ...
5245           },
5246           State {
5247               // ...
5248           }
5249           // ...
5250       ]
5251   }
5252   \endqml
5253
5254   \sa {qmlstate}{States}
5255 */
5256 /*!
5257   \qmlproperty list<Transition> QtQuick2::Item::transitions
5258   This property holds a list of transitions defined by the item.
5259
5260   \qml
5261   Item {
5262       transitions: [
5263           Transition {
5264               // ...
5265           },
5266           Transition {
5267               // ...
5268           }
5269           // ...
5270       ]
5271   }
5272   \endqml
5273
5274   \sa {QML Animation and Transitions}{Transitions}
5275 */
5276 /*
5277   \qmlproperty list<Filter> QtQuick2::Item::filter
5278   This property holds a list of graphical filters to be applied to the item.
5279
5280   \l {Filter}{Filters} include things like \l {Blur}{blurring}
5281   the item, or giving it a \l Reflection.  Some
5282   filters may not be available on all canvases; if a filter is not
5283   available on a certain canvas, it will simply not be applied for
5284   that canvas (but the QML will still be considered valid).
5285
5286   \qml
5287   Item {
5288       filter: [
5289           Blur {
5290               // ...
5291           },
5292           Reflection {
5293               // ...
5294           }
5295           // ...
5296       ]
5297   }
5298   \endqml
5299 */
5300
5301 /*!
5302   \qmlproperty bool QtQuick2::Item::clip
5303   This property holds whether clipping is enabled. The default clip value is \c false.
5304
5305   If clipping is enabled, an item will clip its own painting, as well
5306   as the painting of its children, to its bounding rectangle.
5307
5308   Non-rectangular clipping regions are not supported for performance reasons.
5309 */
5310
5311 /*!
5312   \property QQuickItem::clip
5313   This property holds whether clipping is enabled. The default clip value is \c false.
5314
5315   If clipping is enabled, an item will clip its own painting, as well
5316   as the painting of its children, to its bounding rectangle. If you set
5317   clipping during an item's paint operation, remember to re-set it to
5318   prevent clipping the rest of your scene.
5319
5320   Non-rectangular clipping regions are not supported for performance reasons.
5321 */
5322
5323 /*!
5324   \qmlproperty string QtQuick2::Item::state
5325
5326   This property holds the name of the current state of the item.
5327
5328   This property is often used in scripts to change between states. For
5329   example:
5330
5331   \js
5332   function toggle() {
5333       if (button.state == 'On')
5334           button.state = 'Off';
5335       else
5336           button.state = 'On';
5337   }
5338   \endjs
5339
5340   If the item is in its base state (i.e. no explicit state has been
5341   set), \c state will be a blank string. Likewise, you can return an
5342   item to its base state by setting its current state to \c ''.
5343
5344   \sa {qmlstates}{States}
5345 */
5346
5347 /*!
5348   \qmlproperty list<Transform> QtQuick2::Item::transform
5349   This property holds the list of transformations to apply.
5350
5351   For more information see \l Transform.
5352 */
5353
5354 /*!
5355     \enum QQuickItem::TransformOrigin
5356
5357     Controls the point about which simple transforms like scale apply.
5358
5359     \value TopLeft The top-left corner of the item.
5360     \value Top The center point of the top of the item.
5361     \value TopRight The top-right corner of the item.
5362     \value Left The left most point of the vertical middle.
5363     \value Center The center of the item.
5364     \value Right The right most point of the vertical middle.
5365     \value BottomLeft The bottom-left corner of the item.
5366     \value Bottom The center point of the bottom of the item.
5367     \value BottomRight The bottom-right corner of the item.
5368 */
5369
5370
5371 /*!
5372   \qmlproperty bool QtQuick2::Item::activeFocus
5373
5374   This property indicates whether the item has active focus.
5375
5376   An item with active focus will receive keyboard input,
5377   or is a FocusScope ancestor of the item that will receive keyboard input.
5378
5379   Usually, activeFocus is gained by setting focus on an item and its enclosing
5380   FocusScopes. In the following example \c input will have activeFocus.
5381   \qml
5382   Rectangle {
5383       FocusScope {
5384           focus: true
5385           TextInput {
5386               id: input
5387               focus: true
5388           }
5389       }
5390   }
5391   \endqml
5392
5393   \sa focus, {qmlfocus}{Keyboard Focus}
5394 */
5395
5396 /*!
5397   \qmlproperty bool QtQuick2::Item::focus
5398   This property indicates whether the item has focus within the enclosing focus scope. If true, this item
5399   will gain active focus when the enclosing focus scope gains active focus.
5400   In the following example, \c input will be given active focus when \c scope gains active focus.
5401   \qml
5402   Rectangle {
5403       FocusScope {
5404           id: scope
5405           TextInput {
5406               id: input
5407               focus: true
5408           }
5409       }
5410   }
5411   \endqml
5412
5413   For the purposes of this property, the scene as a whole is assumed to act like a focus scope.
5414   On a practical level, that means the following QML will give active focus to \c input on startup.
5415
5416   \qml
5417   Rectangle {
5418       TextInput {
5419           id: input
5420           focus: true
5421       }
5422   }
5423   \endqml
5424
5425   \sa activeFocus, {qmlfocus}{Keyboard Focus}
5426 */
5427
5428
5429 /*!
5430   \property QQuickItem::anchors
5431   \internal
5432 */
5433
5434 /*!
5435   \property QQuickItem::left
5436   \internal
5437 */
5438
5439 /*!
5440   \property QQuickItem::right
5441   \internal
5442 */
5443
5444 /*!
5445   \property QQuickItem::horizontalCenter
5446   \internal
5447 */
5448
5449 /*!
5450   \property QQuickItem::top
5451   \internal
5452 */
5453
5454 /*!
5455   \property QQuickItem::bottom
5456   \internal
5457 */
5458
5459 /*!
5460   \property QQuickItem::verticalCenter
5461   \internal
5462 */
5463
5464 /*!
5465   \property QQuickItem::focus
5466   \internal
5467 */
5468
5469 /*!
5470   \property QQuickItem::transform
5471   \internal
5472 */
5473
5474 /*!
5475   \property QQuickItem::transformOrigin
5476   \internal
5477 */
5478
5479 /*!
5480   \property QQuickItem::activeFocus
5481   \internal
5482 */
5483
5484 /*!
5485   \property QQuickItem::baseline
5486   \internal
5487 */
5488
5489 /*!
5490   \property QQuickItem::data
5491   \internal
5492 */
5493
5494 /*!
5495   \property QQuickItem::resources
5496   \internal
5497 */
5498
5499 /*!
5500   \property QQuickItem::state
5501   \internal
5502 */
5503
5504 /*!
5505   \property QQuickItem::states
5506   \internal
5507 */
5508
5509 /*!
5510   \property QQuickItem::transformOriginPoint
5511   \internal
5512 */
5513
5514 /*!
5515   \property QQuickItem::transitions
5516   \internal
5517 */
5518
5519 bool QQuickItem::event(QEvent *ev)
5520 {
5521 #if 0
5522     if (ev->type() == QEvent::PolishRequest) {
5523         Q_D(QQuickItem);
5524         d->polishScheduled = false;
5525         updatePolish();
5526         return true;
5527     } else {
5528         return QObject::event(ev);
5529     }
5530 #endif
5531     if (ev->type() == QEvent::InputMethodQuery) {
5532         QInputMethodQueryEvent *query = static_cast<QInputMethodQueryEvent *>(ev);
5533         Qt::InputMethodQueries queries = query->queries();
5534         for (uint i = 0; i < 32; ++i) {
5535             Qt::InputMethodQuery q = (Qt::InputMethodQuery)(int)(queries & (1<<i));
5536             if (q) {
5537                 QVariant v = inputMethodQuery(q);
5538                 query->setValue(q, v);
5539             }
5540         }
5541         query->accept();
5542         return true;
5543     } else if (ev->type() == QEvent::InputMethod) {
5544         inputMethodEvent(static_cast<QInputMethodEvent *>(ev));
5545         return true;
5546     }
5547     return QObject::event(ev);
5548 }
5549
5550 #ifndef QT_NO_DEBUG_STREAM
5551 QDebug operator<<(QDebug debug, QQuickItem *item)
5552 {
5553     if (!item) {
5554         debug << "QQuickItem(0)";
5555         return debug;
5556     }
5557
5558     debug << item->metaObject()->className() << "(this =" << ((void*)item)
5559           << ", name=" << item->objectName()
5560           << ", parent =" << ((void*)item->parentItem())
5561           << ", geometry =" << QRectF(item->pos(), QSizeF(item->width(), item->height()))
5562           << ", z =" << item->z() << ')';
5563     return debug;
5564 }
5565 #endif
5566
5567 qint64 QQuickItemPrivate::consistentTime = -1;
5568 void QQuickItemPrivate::setConsistentTime(qint64 t)
5569 {
5570     consistentTime = t;
5571 }
5572
5573 class QElapsedTimerConsistentTimeHack
5574 {
5575 public:
5576     void start() {
5577         t1 = QQuickItemPrivate::consistentTime;
5578         t2 = 0;
5579     }
5580     qint64 elapsed() {
5581         return QQuickItemPrivate::consistentTime - t1;
5582     }
5583     qint64 restart() {
5584         qint64 val = QQuickItemPrivate::consistentTime - t1;
5585         t1 = QQuickItemPrivate::consistentTime;
5586         t2 = 0;
5587         return val;
5588     }
5589
5590 private:
5591     qint64 t1;
5592     qint64 t2;
5593 };
5594
5595 void QQuickItemPrivate::start(QElapsedTimer &t)
5596 {
5597     if (QQuickItemPrivate::consistentTime == -1)
5598         t.start();
5599     else
5600         ((QElapsedTimerConsistentTimeHack*)&t)->start();
5601 }
5602
5603 qint64 QQuickItemPrivate::elapsed(QElapsedTimer &t)
5604 {
5605     if (QQuickItemPrivate::consistentTime == -1)
5606         return t.elapsed();
5607     else
5608         return ((QElapsedTimerConsistentTimeHack*)&t)->elapsed();
5609 }
5610
5611 qint64 QQuickItemPrivate::restart(QElapsedTimer &t)
5612 {
5613     if (QQuickItemPrivate::consistentTime == -1)
5614         return t.restart();
5615     else
5616         return ((QElapsedTimerConsistentTimeHack*)&t)->restart();
5617 }
5618
5619 /*!
5620     \fn bool QQuickItem::isTextureProvider() const
5621
5622     Returns true if this item is a texture provider. The default
5623     implementation returns false.
5624
5625     This function can be called from any thread.
5626  */
5627
5628 bool QQuickItem::isTextureProvider() const
5629 {
5630     Q_D(const QQuickItem);
5631     return d->extra.isAllocated() && d->extra->layer && d->extra->layer->effectSource() ?
5632            d->extra->layer->effectSource()->isTextureProvider() : false;
5633 }
5634
5635 /*!
5636     \fn QSGTextureProvider *QQuickItem::textureProvider() const
5637
5638     Returns the texture provider for an item. The default implementation
5639     returns 0.
5640
5641     This function may only be called on the rendering thread.
5642  */
5643
5644 QSGTextureProvider *QQuickItem::textureProvider() const
5645 {
5646     Q_D(const QQuickItem);
5647     return d->extra.isAllocated() && d->extra->layer && d->extra->layer->effectSource() ?
5648            d->extra->layer->effectSource()->textureProvider() : 0;
5649 }
5650
5651 QQuickItemLayer *QQuickItemPrivate::layer() const
5652 {
5653     if (!extra.isAllocated() || !extra->layer) {
5654         extra.value().layer = new QQuickItemLayer(const_cast<QQuickItem *>(q_func()));
5655         if (!componentComplete)
5656             extra->layer->classBegin();
5657     }
5658     return extra->layer;
5659 }
5660
5661 QQuickItemLayer::QQuickItemLayer(QQuickItem *item)
5662     : m_item(item)
5663     , m_enabled(false)
5664     , m_mipmap(false)
5665     , m_smooth(false)
5666     , m_componentComplete(true)
5667     , m_wrapMode(QQuickShaderEffectSource::ClampToEdge)
5668     , m_format(QQuickShaderEffectSource::RGBA)
5669     , m_name("source")
5670     , m_effectComponent(0)
5671     , m_effect(0)
5672     , m_effectSource(0)
5673 {
5674 }
5675
5676 QQuickItemLayer::~QQuickItemLayer()
5677 {
5678     delete m_effectSource;
5679     delete m_effect;
5680 }
5681
5682
5683
5684 /*!
5685     \qmlproperty bool QtQuick2::Item::layer.enabled
5686
5687     Holds wether the item is layered or not. Layering is disabled by default.
5688
5689     A layered item is rendered into an offscreen surface and cached until
5690     it is changed. Enabling layering for complex QML item hierarchies can
5691     some times be an optimization.
5692
5693     None of the other layer properties have any effect when the layer
5694     is disabled.
5695  */
5696
5697 void QQuickItemLayer::setEnabled(bool e)
5698 {
5699     if (e == m_enabled)
5700         return;
5701     m_enabled = e;
5702     if (m_componentComplete) {
5703         if (m_enabled)
5704             activate();
5705         else
5706             deactivate();
5707     }
5708
5709     emit enabledChanged(e);
5710 }
5711
5712 void QQuickItemLayer::classBegin()
5713 {
5714     Q_ASSERT(!m_effectSource);
5715     Q_ASSERT(!m_effect);
5716     m_componentComplete = false;
5717 }
5718
5719 void QQuickItemLayer::componentComplete()
5720 {
5721     Q_ASSERT(!m_componentComplete);
5722     m_componentComplete = true;
5723     if (m_enabled)
5724         activate();
5725 }
5726
5727 void QQuickItemLayer::activate()
5728 {
5729     Q_ASSERT(!m_effectSource);
5730     m_effectSource = new QQuickShaderEffectSource();
5731
5732     QQuickItem *parentItem = m_item->parentItem();
5733     if (parentItem) {
5734         m_effectSource->setParentItem(parentItem);
5735         m_effectSource->stackAfter(m_item);
5736     }
5737
5738     m_effectSource->setSourceItem(m_item);
5739     m_effectSource->setHideSource(true);
5740     m_effectSource->setSmooth(m_smooth);
5741     m_effectSource->setTextureSize(m_size);
5742     m_effectSource->setSourceRect(m_sourceRect);
5743     m_effectSource->setMipmap(m_mipmap);
5744     m_effectSource->setWrapMode(m_wrapMode);
5745     m_effectSource->setFormat(m_format);
5746
5747     if (m_effectComponent)
5748         activateEffect();
5749
5750     m_effectSource->setVisible(m_item->isVisible() && !m_effect);
5751
5752     updateZ();
5753     updateGeometry();
5754     updateOpacity();
5755     updateMatrix();
5756
5757     QQuickItemPrivate *id = QQuickItemPrivate::get(m_item);
5758     id->addItemChangeListener(this, QQuickItemPrivate::Geometry | QQuickItemPrivate::Opacity | QQuickItemPrivate::Parent | QQuickItemPrivate::Visibility | QQuickItemPrivate::SiblingOrder);
5759 }
5760
5761 void QQuickItemLayer::deactivate()
5762 {
5763     Q_ASSERT(m_effectSource);
5764
5765     if (m_effectComponent)
5766         deactivateEffect();
5767
5768     delete m_effectSource;
5769     m_effectSource = 0;
5770
5771     QQuickItemPrivate *id = QQuickItemPrivate::get(m_item);
5772     id->removeItemChangeListener(this,  QQuickItemPrivate::Geometry | QQuickItemPrivate::Opacity | QQuickItemPrivate::Parent | QQuickItemPrivate::Visibility | QQuickItemPrivate::SiblingOrder);
5773 }
5774
5775 void QQuickItemLayer::activateEffect()
5776 {
5777     Q_ASSERT(m_effectSource);
5778     Q_ASSERT(m_effectComponent);
5779     Q_ASSERT(!m_effect);
5780
5781     QObject *created = m_effectComponent->beginCreate(m_effectComponent->creationContext());
5782     m_effect = qobject_cast<QQuickItem *>(created);
5783     if (!m_effect) {
5784         qWarning("Item: layer.effect is not a QML Item.");
5785         m_effectComponent->completeCreate();
5786         delete created;
5787         return;
5788     }
5789     QQuickItem *parentItem = m_item->parentItem();
5790     if (parentItem) {
5791         m_effect->setParentItem(parentItem);
5792         m_effect->stackAfter(m_effectSource);
5793     }
5794     m_effect->setVisible(m_item->isVisible());
5795     m_effect->setProperty(m_name, qVariantFromValue<QObject *>(m_effectSource));
5796     m_effectComponent->completeCreate();
5797 }
5798
5799 void QQuickItemLayer::deactivateEffect()
5800 {
5801     Q_ASSERT(m_effectSource);
5802     Q_ASSERT(m_effectComponent);
5803
5804     delete m_effect;
5805     m_effect = 0;
5806 }
5807
5808
5809 /*!
5810     \qmlproperty Component QtQuick2::Item::layer.effect
5811
5812     Holds the effect that is applied to this layer.
5813
5814     The effect is typically a \l ShaderEffect component, although any \l Item component can be
5815     assigned. The effect should have a source texture property with a name matching \l samplerName.
5816
5817     \sa samplerName
5818  */
5819
5820 void QQuickItemLayer::setEffect(QQmlComponent *component)
5821 {
5822     if (component == m_effectComponent)
5823         return;
5824
5825     bool updateNeeded = false;
5826     if (m_effectSource && m_effectComponent) {
5827         deactivateEffect();
5828         updateNeeded = true;
5829     }
5830
5831     m_effectComponent = component;
5832
5833     if (m_effectSource && m_effectComponent) {
5834         activateEffect();
5835         updateNeeded = true;
5836     }
5837
5838     if (updateNeeded) {
5839         updateZ();
5840         updateGeometry();
5841         updateOpacity();
5842         updateMatrix();
5843         m_effectSource->setVisible(m_item->isVisible() && !m_effect);
5844     }
5845
5846     emit effectChanged(component);
5847 }
5848
5849
5850 /*!
5851     \qmlproperty bool QtQuick2::Item::layer.mipmap
5852
5853     If this property is true, mipmaps are generated for the texture.
5854
5855     \note Some OpenGL ES 2 implementations do not support mipmapping of
5856     non-power-of-two textures.
5857  */
5858
5859 void QQuickItemLayer::setMipmap(bool mipmap)
5860 {
5861     if (mipmap == m_mipmap)
5862         return;
5863     m_mipmap = mipmap;
5864
5865     if (m_effectSource)
5866         m_effectSource->setMipmap(m_mipmap);
5867
5868     emit mipmapChanged(mipmap);
5869 }
5870
5871
5872 /*!
5873     \qmlproperty enumeration QtQuick2::Item::layer.format
5874
5875     This property defines the internal OpenGL format of the texture.
5876     Modifying this property makes most sense when the \a layer.effect is also
5877     specified. Depending on the OpenGL implementation, this property might
5878     allow you to save some texture memory.
5879
5880     \list
5881     \li ShaderEffectSource.Alpha - GL_ALPHA
5882     \li ShaderEffectSource.RGB - GL_RGB
5883     \li ShaderEffectSource.RGBA - GL_RGBA
5884     \endlist
5885
5886     \note Some OpenGL implementations do not support the GL_ALPHA format.
5887  */
5888
5889 void QQuickItemLayer::setFormat(QQuickShaderEffectSource::Format f)
5890 {
5891     if (f == m_format)
5892         return;
5893     m_format = f;
5894
5895     if (m_effectSource)
5896         m_effectSource->setFormat(m_format);
5897
5898     emit formatChanged(m_format);
5899 }
5900
5901
5902 /*!
5903     \qmlproperty enumeration QtQuick2::Item::layer.sourceRect
5904
5905     This property defines which rectangular area of the \l sourceItem to
5906     render into the texture. The source rectangle can be larger than
5907     \l sourceItem itself. If the rectangle is null, which is the default,
5908     the whole \l sourceItem is rendered to texture.
5909  */
5910
5911 void QQuickItemLayer::setSourceRect(const QRectF &sourceRect)
5912 {
5913     if (sourceRect == m_sourceRect)
5914         return;
5915     m_sourceRect = sourceRect;
5916
5917     if (m_effectSource)
5918         m_effectSource->setSourceRect(m_sourceRect);
5919
5920     emit sourceRectChanged(sourceRect);
5921 }
5922
5923
5924
5925 /*!
5926     \qmlproperty bool QtQuick2::Item::layer.smooth
5927
5928     Holds whether the layer is smoothly transformed.
5929  */
5930
5931 void QQuickItemLayer::setSmooth(bool s)
5932 {
5933     if (m_smooth == s)
5934         return;
5935     m_smooth = s;
5936
5937     if (m_effectSource)
5938         m_effectSource->setSmooth(m_smooth);
5939
5940     emit smoothChanged(s);
5941 }
5942
5943
5944
5945 /*!
5946     \qmlproperty size QtQuick2::Item::layer.textureSize
5947
5948     This property holds the requested pixel size of the layers texture. If it is empty,
5949     which is the default, the size of the item is used.
5950
5951     \note Some platforms have a limit on how small framebuffer objects can be,
5952     which means the actual texture size might be larger than the requested
5953     size.
5954  */
5955
5956 void QQuickItemLayer::setSize(const QSize &size)
5957 {
5958     if (size == m_size)
5959         return;
5960     m_size = size;
5961
5962     if (m_effectSource)
5963         m_effectSource->setTextureSize(size);
5964
5965     emit sizeChanged(size);
5966 }
5967
5968
5969
5970 /*!
5971     \qmlproperty enumeration QtQuick2::Item::layer.wrapMode
5972
5973     This property defines the OpenGL wrap modes associated with the texture.
5974     Modifying this property makes most sense when the \a layer.effect is
5975     specified.
5976
5977     \list
5978     \li ShaderEffectSource.ClampToEdge - GL_CLAMP_TO_EDGE both horizontally and vertically
5979     \li ShaderEffectSource.RepeatHorizontally - GL_REPEAT horizontally, GL_CLAMP_TO_EDGE vertically
5980     \li ShaderEffectSource.RepeatVertically - GL_CLAMP_TO_EDGE horizontally, GL_REPEAT vertically
5981     \li ShaderEffectSource.Repeat - GL_REPEAT both horizontally and vertically
5982     \endlist
5983
5984     \note Some OpenGL ES 2 implementations do not support the GL_REPEAT
5985     wrap mode with non-power-of-two textures.
5986  */
5987
5988 void QQuickItemLayer::setWrapMode(QQuickShaderEffectSource::WrapMode mode)
5989 {
5990     if (mode == m_wrapMode)
5991         return;
5992     m_wrapMode = mode;
5993
5994     if (m_effectSource)
5995         m_effectSource->setWrapMode(m_wrapMode);
5996
5997     emit wrapModeChanged(mode);
5998 }
5999
6000 /*!
6001     \qmlproperty string QtQuick2::Item::layer.samplerName
6002
6003     Holds the name of the effect's source texture property.
6004
6005     samplerName needs to match the name of the effect's source texture property
6006     so that the Item can pass the layer's offscreen surface to the effect correctly.
6007
6008     \sa effect, ShaderEffect
6009  */
6010
6011 void QQuickItemLayer::setName(const QByteArray &name) {
6012     if (m_name == name)
6013         return;
6014     if (m_effect) {
6015         m_effect->setProperty(m_name, QVariant());
6016         m_effect->setProperty(name, qVariantFromValue<QObject *>(m_effectSource));
6017     }
6018     m_name = name;
6019     emit nameChanged(name);
6020 }
6021
6022 void QQuickItemLayer::itemOpacityChanged(QQuickItem *item)
6023 {
6024     Q_UNUSED(item)
6025     updateOpacity();
6026 }
6027
6028 void QQuickItemLayer::itemGeometryChanged(QQuickItem *, const QRectF &, const QRectF &)
6029 {
6030     updateGeometry();
6031 }
6032
6033 void QQuickItemLayer::itemParentChanged(QQuickItem *item, QQuickItem *parent)
6034 {
6035     Q_UNUSED(item)
6036     Q_ASSERT(item == m_item);
6037     Q_ASSERT(parent != m_effectSource);
6038     Q_ASSERT(parent == 0 || parent != m_effect);
6039
6040     m_effectSource->setParentItem(parent);
6041     if (parent)
6042         m_effectSource->stackAfter(m_item);
6043
6044     if (m_effect) {
6045         m_effect->setParentItem(parent);
6046         if (parent)
6047             m_effect->stackAfter(m_effectSource);
6048     }
6049 }
6050
6051 void QQuickItemLayer::itemSiblingOrderChanged(QQuickItem *)
6052 {
6053     m_effectSource->stackAfter(m_item);
6054     if (m_effect)
6055         m_effect->stackAfter(m_effectSource);
6056 }
6057
6058 void QQuickItemLayer::itemVisibilityChanged(QQuickItem *)
6059 {
6060     QQuickItem *l = m_effect ? (QQuickItem *) m_effect : (QQuickItem *) m_effectSource;
6061     Q_ASSERT(l);
6062     l->setVisible(m_item->isVisible());
6063 }
6064
6065 void QQuickItemLayer::updateZ()
6066 {
6067     if (!m_componentComplete || !m_enabled)
6068         return;
6069     QQuickItem *l = m_effect ? (QQuickItem *) m_effect : (QQuickItem *) m_effectSource;
6070     Q_ASSERT(l);
6071     l->setZ(m_item->z());
6072 }
6073
6074 void QQuickItemLayer::updateOpacity()
6075 {
6076     QQuickItem *l = m_effect ? (QQuickItem *) m_effect : (QQuickItem *) m_effectSource;
6077     Q_ASSERT(l);
6078     l->setOpacity(m_item->opacity());
6079 }
6080
6081 void QQuickItemLayer::updateGeometry()
6082 {
6083     QQuickItem *l = m_effect ? (QQuickItem *) m_effect : (QQuickItem *) m_effectSource;
6084     Q_ASSERT(l);
6085     QRectF bounds = m_item->clipRect();
6086     l->setWidth(bounds.width());
6087     l->setHeight(bounds.height());
6088     l->setX(bounds.x() + m_item->x());
6089     l->setY(bounds.y() + m_item->y());
6090 }
6091
6092 void QQuickItemLayer::updateMatrix()
6093 {
6094     // Called directly from transformChanged(), so needs some extra
6095     // checks.
6096     if (!m_componentComplete || !m_enabled)
6097         return;
6098     QQuickItem *l = m_effect ? (QQuickItem *) m_effect : (QQuickItem *) m_effectSource;
6099     Q_ASSERT(l);
6100     QQuickItemPrivate *ld = QQuickItemPrivate::get(l);
6101     l->setScale(m_item->scale());
6102     l->setRotation(m_item->rotation());
6103     ld->transforms = QQuickItemPrivate::get(m_item)->transforms;
6104     if (ld->origin() != QQuickItemPrivate::get(m_item)->origin())
6105         ld->extra.value().origin = QQuickItemPrivate::get(m_item)->origin();
6106     ld->dirty(QQuickItemPrivate::Transform);
6107 }
6108
6109 QQuickItemPrivate::ExtraData::ExtraData()
6110 : z(0), scale(1), rotation(0), opacity(1),
6111   contents(0), screenAttached(0), layoutDirectionAttached(0),
6112   keyHandler(0), layer(0), effectRefCount(0), hideRefCount(0),
6113   opacityNode(0), clipNode(0), rootNode(0), beforePaintNode(0),
6114   acceptedMouseButtons(0), origin(QQuickItem::Center)
6115 {
6116 }
6117
6118 QT_END_NAMESPACE
6119
6120 #include <moc_qquickitem.cpp>