git.maemo.org Git - mardrone/blob - mardrone/imports/com/nokia/android.1.1/Page.qml

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
   4 ** All rights reserved.
   5 ** Contact: Nokia Corporation (qt-info@nokia.com)
   6 **
   7 ** This file is part of the Qt Components project.
   8 **
   9 ** $QT_BEGIN_LICENSE:BSD$
  10 ** You may use this file under the terms of the BSD license as follows:
  11 **
  12 ** "Redistribution and use in source and binary forms, with or without
  13 ** modification, are permitted provided that the following conditions are
  14 ** met:
  15 **   * Redistributions of source code must retain the above copyright
  16 **     notice, this list of conditions and the following disclaimer.
  17 **   * Redistributions in binary form must reproduce the above copyright
  18 **     notice, this list of conditions and the following disclaimer in
  19 **     the documentation and/or other materials provided with the
  20 **     distribution.
  21 **   * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
  22 **     the names of its contributors may be used to endorse or promote
  23 **     products derived from this software without specific prior written
  24 **     permission.
  25 **
  26 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  27 ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  28 ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  29 ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  30 ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  31 ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  32 ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  33 ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  34 ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  35 ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  36 ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
  37 ** $QT_END_LICENSE$
  38 **
  39 ****************************************************************************/
  40
  41 import QtQuick 1.1
  42 import "." 1.1
  43
  44 Item {
  45     id: root
  46
  47     // The status of the page. One of the following:
  48     //      PageStatus.Inactive - the page is not visible
  49     //      PageStatus.Activating - the page is transitioning into becoming the active page
  50     //      PageStatus.Active - the page is the current active page
  51     //      PageStatus.Deactivating - the page is transitioning into becoming inactive
  52     property int status: PageStatus.Inactive
  53
  54     property PageStack pageStack
  55
  56     // Defines orientation lock for a page
  57     property int orientationLock: PageOrientation.Automatic
  58
  59     property Item tools: null
  60
  61     visible: false
  62
  63     width: visible && parent ? parent.width : internal.previousWidth
  64     height: visible && parent ? parent.height : internal.previousHeight
  65
  66     onWidthChanged: internal.previousWidth = visible ? width : internal.previousWidth
  67     onHeightChanged: internal.previousHeight = visible ? height : internal.previousHeight
  68
  69     onStatusChanged: {
  70         if (status == PageStatus.Activating)
  71             internal.orientationLockCheck();
  72     }
  73
  74     onOrientationLockChanged: {
  75         if (status == PageStatus.Activating || status == PageStatus.Active)
  76             internal.orientationLockCheck();
  77     }
  78
  79     // This is needed to make a parentless Page component visible in the Designer of QtCreator.
  80     // It's done here instead of binding the visible property because binding it to a script
  81     // block returning false would cause an element on the Page not to end up focused despite
  82     // specifying focus=true inside the active focus scope. The focus would be gained and lost
  83     // in createObject.
  84     Component.onCompleted: if (!parent) visible = true
  85
  86     QtObject {
  87         id: internal
  88         property int previousWidth: 0
  89         property int previousHeight: 0
  90
  91         function isScreenInPortrait() {
  92             return screen.currentOrientation == Screen.Portrait || screen.currentOrientation == Screen.PortraitInverted;
  93         }
  94
  95         function isScreenInLandscape() {
  96             return screen.currentOrientation == Screen.Landscape || screen.currentOrientation == Screen.LandscapeInverted;
  97         }
  98
  99         function orientationLockCheck() {
 100             switch (orientationLock) {
 101             case PageOrientation.Automatic:
 102                 screen.allowedOrientations = Screen.Default
 103                 break
 104             case PageOrientation.LockPortrait:
 105                 screen.allowedOrientations = Screen.Portrait
 106                 break
 107             case PageOrientation.LockLandscape:
 108                 screen.allowedOrientations = Screen.Landscape
 109                 break
 110             case PageOrientation.LockPrevious:
 111                 screen.allowedOrientations = screen.currentOrientation
 112                 break
 113             case PageOrientation.Manual:
 114             default:
 115                 // Do nothing
 116                 // In manual mode it is expected that orientation is set
 117                 // explicitly to "screen.allowedOrientations" by the user.
 118                 break
 119             }
 120         }
 121     }
 122 }