added android components
[mardrone] / mardrone / imports / com / nokia / android.1.1 / ToolButton.qml
diff --git a/mardrone/imports/com/nokia/android.1.1/ToolButton.qml b/mardrone/imports/com/nokia/android.1.1/ToolButton.qml
new file mode 100644 (file)
index 0000000..65857e6
--- /dev/null
@@ -0,0 +1,385 @@
+/****************************************************************************
+**
+** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the Qt Components project.
+**
+** $QT_BEGIN_LICENSE:BSD$
+** You may use this file under the terms of the BSD license as follows:
+**
+** "Redistribution and use in source and binary forms, with or without
+** modification, are permitted provided that the following conditions are
+** met:
+**   * Redistributions of source code must retain the above copyright
+**     notice, this list of conditions and the following disclaimer.
+**   * Redistributions in binary form must reproduce the above copyright
+**     notice, this list of conditions and the following disclaimer in
+**     the documentation and/or other materials provided with the
+**     distribution.
+**   * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
+**     the names of its contributors may be used to endorse or promote
+**     products derived from this software without specific prior written
+**     permission.
+**
+** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+import QtQuick 1.1
+import Qt.labs.components 1.1
+import "." 1.1
+
+Item {
+    id: root
+
+    // Common API
+    property alias checkable: checkableItem.enabled
+    property alias checked: checkableItem.checked
+    property bool enabled: true // overridden from base class
+    property alias text: label.text
+    property url iconSource
+    property bool flat: (!text && iconSource != "" && parent && !internal.isButtonRow(parent))
+    property bool pressed: mouseArea.containsMouse && (stateGroup.state == "Pressed" || stateGroup.state == "PressAndHold")
+
+    // Platform API
+    property alias platformExclusiveGroup: checkableItem.exclusiveGroup
+    property bool platformInverted: false
+
+    // Common API
+    signal clicked
+
+    // Platform API
+    signal platformReleased
+    signal platformPressAndHold
+
+    onFlatChanged: {
+        background.visible = !flat || (checkableItem.enabled && checkableItem.checked && !internal.isButtonRow(parent))
+    }
+
+    implicitWidth: {
+        if (!text)
+            return internal.iconButtonWidth()
+        else if (iconSource == "")
+            return Math.max(internal.iconButtonWidth(), internal.textButtonWidth())
+        else
+            return internal.iconButtonWidth() + internal.textButtonWidth()
+    }
+    implicitHeight: {
+        if ((iconSource != "") && !text)
+            // if there is just an icon, then it's full button height
+            return internal.iconButtonWidth()
+        else
+            // Otherwise frame height is always tool bar's height in landscape, regardless of the current orientation
+            return privateStyle.toolBarHeightLandscape
+    }
+
+    BorderImage {
+        id: background
+
+        source: privateStyle.imagePath(internal.imageName() + internal.modeName(), root.platformInverted)
+        border {
+            left: internal.isFrameGraphic ? platformStyle.borderSizeMedium : 0;
+            top: internal.isFrameGraphic ? platformStyle.borderSizeMedium : 0;
+            right: internal.isFrameGraphic ? platformStyle.borderSizeMedium : 0;
+            bottom: internal.isFrameGraphic ? platformStyle.borderSizeMedium : 0;
+        }
+        smooth: true
+        anchors.fill: parent
+        visible: !flat
+
+        BorderImage {
+            id: highlight
+            border {
+                left: internal.isFrameGraphic ? platformStyle.borderSizeMedium : 0;
+                top: internal.isFrameGraphic ? platformStyle.borderSizeMedium : 0;
+                right: internal.isFrameGraphic ? platformStyle.borderSizeMedium : 0;
+                bottom: internal.isFrameGraphic ? platformStyle.borderSizeMedium : 0;
+            }
+            smooth: true
+            anchors.fill: background
+            opacity: 0
+        }
+    }
+
+    Image {
+        id: contentIcon
+        source: privateStyle.toolBarIconPath(iconSource, root.platformInverted)
+        visible: iconSource != ""
+        sourceSize.width: platformStyle.graphicSizeSmall
+        sourceSize.height: platformStyle.graphicSizeSmall
+        anchors {
+            centerIn: !text ? parent : undefined
+            verticalCenter: !text ? undefined : parent.verticalCenter
+            left: !text ? undefined : parent.left
+            leftMargin: !text ? 0 : 2 * platformStyle.paddingMedium
+        }
+        smooth: true
+    }
+
+    Text {
+        id: label
+        clip: true
+        horizontalAlignment: Text.AlignHCenter
+        verticalAlignment: Text.AlignVCenter
+        elide: Text.ElideRight
+        font { family: platformStyle.fontFamilyRegular; pixelSize: platformStyle.fontSizeLarge }
+        color: {
+            if (!root.enabled)
+                return root.platformInverted ? platformStyle.colorDisabledLightInverted
+                                             : platformStyle.colorDisabledLight
+            else if (stateGroup.state == "Pressed" || stateGroup.state == "PressAndHold")
+                return root.platformInverted ? platformStyle.colorPressedInverted
+                                             : platformStyle.colorPressed
+            else
+                return root.platformInverted ? platformStyle.colorNormalLightInverted
+                                             : platformStyle.colorNormalLight
+        }
+        visible: text
+        anchors {
+            top: parent.top; bottom: parent.bottom
+            left: iconSource != "" ? contentIcon.right : parent.left; right: parent.right
+            leftMargin: iconSource != "" ? platformStyle.paddingSmall : platformStyle.paddingMedium
+            rightMargin: platformStyle.paddingMedium
+        }
+        smooth: true
+    }
+
+    MouseArea {
+        id: mouseArea
+        anchors.fill: parent
+
+        onPressed: if (root.enabled) stateGroup.state = "Pressed"
+        onReleased: if (root.enabled) stateGroup.state = ""
+        onCanceled: {
+            if (root.enabled) {
+                // Mark as canceled
+                stateGroup.state = "Canceled"
+                // Reset state. Can't expect a release since mouse was ungrabbed
+                stateGroup.state = ""
+            }
+        }
+        onPressAndHold: if (stateGroup.state != "Canceled" && root.enabled) stateGroup.state = "PressAndHold"
+        onExited: if (root.enabled) stateGroup.state = "Canceled"
+    }
+
+    QtObject {
+        id: internal
+
+        property bool isFrameGraphic : imageName().search("_fr") > 0
+
+        function belongsToExclusiveGroup() {
+            return checkableItem.exclusiveGroup
+                   || (root.parent
+                   && root.parent.hasOwnProperty("checkedButton")
+                   && root.parent.exclusive)
+        }
+
+        function modeName() {
+            if (isButtonRow(parent))
+                return parent.privateModeName(root, 1)
+            else if (!enabled)
+                return "disabled"
+            else if (flat && checkableItem.checked && !internal.isButtonRow(parent))
+                return "latched"
+            else
+                return "normal"
+        }
+
+        function iconButtonWidth() {
+            return (screen.width < screen.height) ? privateStyle.toolBarHeightPortrait : privateStyle.toolBarHeightLandscape
+        }
+
+        function textButtonWidth() {
+            return platformStyle.paddingMedium * ((screen.width < screen.height) ? 15 : 25)
+        }
+
+        function press() {
+            if (!belongsToExclusiveGroup()) {
+                if (checkableItem.enabled && checkableItem.checked)
+                    privateStyle.play(Android.SensitiveButton)
+                else
+                    privateStyle.play(Android.BasicButton)
+            } else if (checkableItem.enabled && !checkableItem.checked) {
+                privateStyle.play(Android.BasicButton)
+            }
+
+            if (flat)
+                background.visible = true
+            highlight.source = privateStyle.imagePath(internal.imageName() + "pressed", root.platformInverted)
+            label.scale = 0.95
+            contentIcon.scale = 0.95
+            highlight.opacity = 1
+        }
+
+        function release() {
+            label.scale = 1
+            contentIcon.scale = 1
+            highlight.opacity = 0
+
+            if (((checkableItem.enabled && checkableItem.checked && !belongsToExclusiveGroup())
+                || !checkableItem.enabled) && stateGroup.state != "Canceled")
+                privateStyle.play(Android.BasicButton)
+
+            if (flat && isButtonRow(parent))
+                visibleEffect.restart() //Background invisible
+            else if (flat && !checkableItem.enabled)
+                visibleEffect.restart() //Background invisible
+            else
+                clickedEffect.restart() //Background stays visible
+
+            root.platformReleased()
+        }
+
+        function click() {
+            checkableItem.toggle()
+            root.clicked()
+        }
+
+        function hold() {
+            root.platformPressAndHold()
+        }
+
+        function isButtonRow(item) {
+            return (item &&
+                    item.hasOwnProperty("checkedButton") &&
+                    item.hasOwnProperty("privateDirection") &&
+                    item.privateDirection == Qt.Horizontal)
+        }
+
+        // The function imageName() handles fetching correct graphics for the ToolButton.
+        // If the parent of a ToolButton is ButtonRow, segmented-style graphics are used to create a
+        // seamless row of buttons. Otherwise normal ToolButton graphics are utilized.
+        function imageName() {
+            var mirror = root.LayoutMirroring.enabled // To create binding
+            if (isButtonRow(parent))
+                return parent.privateGraphicsName(root, 1)
+            else
+                return (!flat || text || iconSource == "") ? "qtg_fr_toolbutton_text_" : "qtg_graf_toolbutton_"
+        }
+    }
+
+    StateGroup {
+        id: stateGroup
+
+        states: [
+            State { name: "Pressed" },
+            State { name: "PressAndHold" },
+            State { name: "Canceled" }
+        ]
+
+        transitions: [
+            Transition {
+                to: "Pressed"
+                ScriptAction { script: internal.press() }
+            },
+            Transition {
+                from: "Pressed"
+                to: "PressAndHold"
+                ScriptAction { script: internal.hold() }
+            },
+            Transition {
+                from: "Pressed"
+                to: ""
+                ScriptAction { script: internal.release() }
+                ScriptAction { script: internal.click() }
+            },
+            Transition {
+                from: "PressAndHold"
+                to: ""
+                ScriptAction { script: internal.release() }
+                ScriptAction { script: internal.click() }
+            },
+            Transition {
+                from: "Pressed"
+                to: "Canceled"
+                ScriptAction { script: internal.release() }
+            },
+            Transition {
+                from: "PressAndHold"
+                to: "Canceled"
+                ScriptAction { script: internal.release() }
+            }
+        ]
+    }
+
+    ParallelAnimation {
+        id: clickedEffect
+        PropertyAnimation {
+            target: label
+            property: "scale"
+            from: 0.95
+            to: 1.0
+            easing.type: Easing.Linear
+            duration: 100
+        }
+        PropertyAnimation {
+            target: contentIcon
+            property: "scale"
+            from: 0.95
+            to: 1.0
+            easing.type: Easing.Linear
+            duration: 100
+        }
+        PropertyAnimation {
+            target: highlight
+            property: "opacity"
+            from: 1
+            to: 0
+            easing.type: Easing.Linear
+            duration: 150
+        }
+    }
+
+    SequentialAnimation {
+        id: visibleEffect
+        ParallelAnimation {
+            PropertyAnimation {
+                target: label
+                property: "scale"
+                from: 0.95
+                to: 1.0
+                easing.type: Easing.Linear
+                duration: 100
+            }
+            PropertyAnimation {
+                target: contentIcon
+                property: "scale"
+                from: 0.95
+                to: 1.0
+                easing.type: Easing.Linear
+                duration: 100
+            }
+            PropertyAnimation {
+                target: highlight
+                property: "opacity"
+                from: 1
+                to: 0
+                easing.type: Easing.Linear
+                duration: 150
+            }
+        }
+        PropertyAction {
+            target: background
+            property: "visible"
+            value: false
+        }
+    }
+
+    Checkable {
+        id: checkableItem
+        value: root.text
+    }
+}