1 /****************************************************************************
3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
4 ** All rights reserved.
5 ** Contact: Nokia Corporation (qt-info@nokia.com)
7 ** This file is part of the QtDeclarative module of the Qt Toolkit.
9 ** $QT_BEGIN_LICENSE:BSD$
10 ** You may use this file under the terms of the BSD license as follows:
12 ** "Redistribution and use in source and binary forms, with or without
13 ** modification, are permitted provided that the following conditions are
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
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
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."
39 ****************************************************************************/
45 //identifier of the item
48 //these properties act as constants, useable outside this QML file
49 property int buttonHeight: 75
50 property int buttonWidth: 150
52 //attaches to the Text element's text content
54 property color textColor: buttonLabel.color
56 //the color highlight when the mouse hovers on the rectangle
57 property color onHoverColor: "lightsteelblue"
58 property color borderColor: "transparent"
60 //buttonColor is set to the button's main color
61 property color buttonColor: "lightblue"
63 property real labelSize: 14
64 //set appearance properties
68 border.color: borderColor
69 width: buttonWidth; height: buttonHeight
73 anchors.centerIn: parent
74 text: label //bind the text to the parent's text
76 font.pointSize: labelSize
79 //buttonClick() is callable and a signal handler, onButtonClick is automatically created
82 //define the clickable area to be the whole rectangle
85 anchors.fill: parent //stretch the area to the parent's dimension
86 onClicked: buttonClick()
88 //if true, then onEntered and onExited called if mouse hovers in the mouse area
89 //if false, a button must be clicked to detect the mouse hover
92 //display a border if the mouse hovers on the button mouse area
93 onEntered: parent.border.color = onHoverColor
94 //remove the border if the mouse exits the button mouse area
95 onExited: parent.border.color = borderColor
99 //change the color of the button when pressed
100 color: buttonMouseArea.pressed ? Qt.darker(buttonColor, 1.5) : buttonColor
101 //animate the color whenever the color property changes
102 Behavior on color { ColorAnimation{ duration: 55} }
104 //scale the button when pressed
105 scale: buttonMouseArea.pressed ? 1.1 : 1.00
106 //Animate the scale property change
107 Behavior on scale { NumberAnimation{ duration: 55} }