components for android added
[mardrone] / mardrone / imports / com / nokia / extras / RatingIndicator.qml
diff --git a/mardrone/imports/com/nokia/extras/RatingIndicator.qml b/mardrone/imports/com/nokia/extras/RatingIndicator.qml
new file mode 100644 (file)
index 0000000..e5bcbd2
--- /dev/null
@@ -0,0 +1,134 @@
+/****************************************************************************
+**
+** 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 com.nokia.meego 1.0
+import Qt.labs.components 1.1 as QtComponents
+
+/*
+   Class: RatingIndicator
+   Component to indicate user specified ratings.
+
+   A rating indicator is a component that shows the rating value within the maximum allowed range according
+   to the user's specification.  The user can also specify the display type to select the positive/negative
+   visual.  Optionally, the user can also specify a count value that will be displayed next to the images.
+*/
+ImplicitSizeItem {
+    id: root
+
+    /*
+     * Property: maximumValue
+     * [double] The maximum rating.  The number should be larger or equal to 0.
+     */
+    property alias maximumValue: model.maximumValue
+
+    /*
+     * Property: ratingValue
+     * [double] The rating value.  The number should be larger or equal to 0.
+     */
+    property alias ratingValue: model.value
+
+    /*
+     * Property: count
+     * [int] A number to be displayed next to the rating images.  It is usually used to count the number of
+     * votes cast. It is only displayed if a number larger or equal to 0 is specified.
+     */
+    property int count: -1
+
+    /*
+     * Property: inverted
+     * [string] Specify whether the visual for the rating indicator uses the inverted color.  The value is
+     * false for use with a light background and true for use with a dark background.
+     */
+    property bool inverted: theme.inverted
+
+    implicitHeight: Math.max(background.height, text.paintedHeight);
+    implicitWidth: background.width + (count >= 0 ? internal.textSpacing + text.paintedWidth : 0);
+
+    QtComponents.RangeModel {
+        id: model
+        value: 0.0
+        minimumValue: 0.0
+        maximumValue: 0.0
+    }
+
+    QtObject {
+        id: internal
+
+        property int imageWidth: 16
+        property int imageHeight: 16
+        property int indicatorSpacing: 5  // spacing between images
+        property int textSpacing: 8  // spacing between image and text
+        property url backgroundImageSource: inverted ?
+                                                 "image://theme/meegotouch-indicator-rating-inverted-background-star" :
+                                                 "image://theme/meegotouch-indicator-rating-background-star"
+        property url indicatorImageSource: inverted ?
+                                             "image://theme/meegotouch-indicator-rating-inverted-star" :
+                                             "image://theme/meegotouch-indicator-rating-star"
+        property string textColor: inverted ? "#fafafa" : "#505050"
+    }
+
+    Image {
+        id: background
+        width: internal.imageWidth * maximumValue + (Math.max(Math.ceil(maximumValue-1), 0)) * internal.indicatorSpacing;
+        height: internal.imageHeight
+        anchors.verticalCenter: height < text.paintedHeight ? text.verticalCenter : undefined
+        fillMode: Image.Tile
+        source: internal.backgroundImageSource
+
+        Image {
+            id: indicator
+            width: internal.imageWidth * ratingValue + Math.max((Math.ceil(ratingValue) - 1), 0) * internal.indicatorSpacing
+            height: internal.imageHeight
+            fillMode: Image.Tile
+            source: internal.indicatorImageSource
+        }
+    }
+
+    Text {
+        id: text
+        visible: count >= 0
+        text: "(" + count + ")"
+        color: internal.textColor
+        font { family: "Nokia Standard Light"; pixelSize: 18 }
+        anchors.left: background.right
+        anchors.leftMargin: internal.textSpacing
+    }
+}