1 /****************************************************************************
3 ** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
4 ** Contact: http://www.qt-project.org/legal
6 ** This file is part of the QtQml module of the Qt Toolkit.
8 ** $QT_BEGIN_LICENSE:BSD$
9 ** You may use this file under the terms of the BSD license as follows:
11 ** "Redistribution and use in source and binary forms, with or without
12 ** modification, are permitted provided that the following conditions are
14 ** * Redistributions of source code must retain the above copyright
15 ** notice, this list of conditions and the following disclaimer.
16 ** * Redistributions in binary form must reproduce the above copyright
17 ** notice, this list of conditions and the following disclaimer in
18 ** the documentation and/or other materials provided with the
20 ** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names
21 ** of its contributors may be used to endorse or promote products derived
22 ** from this software without specific prior written permission.
25 ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
26 ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
27 ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
28 ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
29 ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
30 ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
31 ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
32 ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
33 ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
34 ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
35 ** 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
65 //set appearance properties
68 border { width: 2; 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
98 //change the color of the button when pressed
99 color: buttonMouseArea.pressed ? Qt.darker(buttonColor, 1.5) : buttonColor
100 //animate the color whenever the color property changes
101 Behavior on color { ColorAnimation{ duration: 55 } }
103 //scale the button when pressed
104 scale: buttonMouseArea.pressed ? 1.1 : 1.00
105 //Animate the scale property change
106 Behavior on scale { NumberAnimation{ duration: 55 } }