1 /****************************************************************************
3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
4 ** Contact: http://www.qt-project.org/
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 Nokia Corporation and its Subsidiary(-ies) nor
21 ** the names of its contributors may be used to endorse or promote
22 ** products derived from this software without specific prior written
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 property string label: "button label"
50 //these properties act as constants, useable outside this QML file
51 property int buttonHeight: 75
52 property int buttonWidth: 150
54 //the color highlight when the mouse hovers on the rectangle
55 property color onHoverColor: "gold"
56 property color borderColor: "white"
58 //buttonColor is set to the button's main color
59 property color buttonColor: "lightblue"
61 //set appearance properties
64 border{color: "white"; width: 3}
65 width: buttonWidth; height: buttonHeight
69 anchors.centerIn: parent
73 //buttonClick() is callable and a signal handler, onButtonClick is automatically created
76 console.log(buttonLabel.text + " clicked" )
79 //define the clickable area to be the whole rectangle
82 anchors.fill: parent //stretch the area to the parent's dimension
83 onClicked: buttonClick()
85 //if true, then onEntered and onExited called if mouse hovers in the mouse area
86 //if false, a button must be clicked to detect the mouse hover
89 //display a border if the mouse hovers on the button mouse area
90 onEntered: parent.border.color = onHoverColor
91 //remove the border if the mouse exits the button mouse area
92 onExited: parent.border.color = borderColor
95 //change the color of the button when pressed
96 color: buttonMouseArea.pressed ? Qt.darker(buttonColor, 1.5) : buttonColor