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 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
96 //change the color of the button when pressed
97 color: buttonMouseArea.pressed ? Qt.darker(buttonColor, 1.5) : buttonColor