Add Window attached property on Item
authorShawn Rutledge <shawn.rutledge@digia.com>
Thu, 7 Aug 2014 11:57:50 +0000 (13:57 +0200)
committerJ-P Nurmi <jpnurmi@digia.com>
Fri, 8 Aug 2014 17:28:34 +0000 (19:28 +0200)
commit60ed6a433a1d51d5ca7ccdeff3fce55e2350d20c
tree494b2eced9e2665aa0fc8e3546d2fc1230fc1663
parentb4b27168ac03d61f6dfa146c9262df44097eadfe
Add Window attached property on Item

An Item sometimes needs to know a few things about the window
in which it is being displayed; this attached property can expose
them without needing to go up the heirarchy to find the window.
Instead of adding the QQuickWindow pointer as a property on Item
as in 8f49f50a169db85401eb37daf4fe3a0fc3280603, having an attached
property means that it will not be found by introspection; and
it solves the problem that Window is in the QtQuick.Window module:
you must import the module to use the attached property, instead
of having access to a pointer whose type might not be defined
if you didn't import it.  The Window attached property is created
on-demand (so the memory cost adds up if you use it in too many
places); the tradeoff is that it can exist even when the item
is not yet being shown in a window, so bindings at startup work.
The API is purposely incomplete compared to that in QQuickWindow
so that we can introduce what is needed in a controlled fasion
over time.  For now we know of use cases for visibility, active
and activeFocusItem.

[ChangeLog][QtQuick][Window] Added Item.Window attached property

Change-Id: I649404cbd1383326678aa2144f790b2f2542dbbc
Reviewed-by: J-P Nurmi <jpnurmi@digia.com>
src/quick/items/items.pri
src/quick/items/qquickwindow.cpp
src/quick/items/qquickwindow.h
src/quick/items/qquickwindowattached.cpp [new file with mode: 0644]
src/quick/items/qquickwindowattached_p.h [new file with mode: 0644]
src/quick/items/qquickwindowmodule.cpp
tests/auto/quick/qquickwindow/data/windowattached.qml [new file with mode: 0644]
tests/auto/quick/qquickwindow/tst_qquickwindow.cpp