From: Alan Alpert <alan.alpert@nokia.com>
Date: Thu, 19 Jul 2012 01:05:30 +0000 (+1000)
Subject: Mention opacity property change in porting.qdoc
X-Git-Tag: upstream/5.2.1~1400
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=b8c80243abc4f96e31243bf04dc29318fae61864;p=platform%2Fupstream%2Fqtdeclarative.git

Mention opacity property change in porting.qdoc

Change-Id: I09343469bebcd7324ae1596d408cafea69c5dc60
Reviewed-by: Bea Lam <bea.lam@nokia.com>
---

diff --git a/src/quick/doc/src/appdevguide/porting.qdoc b/src/quick/doc/src/appdevguide/porting.qdoc
index 2f27880..eb1bb63 100644
--- a/src/quick/doc/src/appdevguide/porting.qdoc
+++ b/src/quick/doc/src/appdevguide/porting.qdoc
@@ -73,6 +73,20 @@ for examples.
 Graphics View framework backend used in QtQuick 1.
 \endlist
 
+\section 2 Behavioral Changes
+
+There are many behavioral changes caused in the transition and you should thoroughly test your applications after
+porting. These changes will not necessarily lead to run-time errors, but may break certain assumptions in your code.
+Here is a list of some more prominent changes:
+
+\list
+\li The input handling details of \l{Item::}{opacity} and \l{Item::}{visible} have changed. An opacity of zero no
+longer affects input handling, where previously it stopped mouse input. A visibility of false no longer affects
+keyboard input, but still stops mouse input. The new \l{Item::}{enabled} property stops mouse and keyboard input, but does not affect how or whether
+the item is rendered. A workaround for applying the old behavior in most cases is to bind enabled to (visible &&
+opacity > 0.0).
+\endlist
+
 \section2 Changes to experimental Qt.labs modules
 
 \list
diff --git a/src/quick/doc/src/whatsnew.qdoc b/src/quick/doc/src/whatsnew.qdoc
index d04e590..c82ddf7 100644
--- a/src/quick/doc/src/whatsnew.qdoc
+++ b/src/quick/doc/src/whatsnew.qdoc
@@ -101,6 +101,7 @@ Below are the additions and changes in QtQuick 2.0.
     \li New \l{Item::}{contains()} method returns whether an item contains a specified point.
     \li New \l{Item::}{anchors.alignWhenCentered} property can force centered anchors to align on a
         whole pixel.
+    \li New \l{Item::}{enabled} property is available, which stops input event delivery and removes active focus.
     \endlist
 \li \l Image:
     \list