1 /****************************************************************************
3 ** Copyright (C) 2011 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 Qt Components project.
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 The Switch component is similar to the CheckBox component but instead of
46 selecting items it should be used when setting options to On/Off.
56 * [bool=false] The checked state of switch
58 property bool checked: false
60 // Styling for the Switch
61 property Style platformStyle: SwitchStyle {}
63 //Deprecated, TODO Remove this on w13
64 property alias style: root.platformStyle
66 property alias platformMouseAnchors: mouseArea.anchors
70 * [bool=true] Enables/Disables the component. Notice that the disable state is not Toolkit compliant
71 * and not present inside the qt-components
80 state: root.checked ? "checked" : "unchecked"
82 property real knobPos: (knob.x - platformStyle.minKnobX) / (platformStyle.maxKnobX - platformStyle.minKnobX)
85 source: platformStyle.switchOn
86 opacity: slider.knobPos
89 source: platformStyle.switchOff
90 opacity: 1.0 - slider.knobPos
96 PropertyChanges { target: knob; x: platformStyle.minKnobX }
100 PropertyChanges { target: knob; x: platformStyle.maxKnobX }
106 SmoothedAnimation { properties: "x"; velocity: 500; maximumEasingTime: 0 }
120 source: (slider.enabled ? (mouseArea.pressed ? platformStyle.thumbPressed : platformStyle.thumb) : platformStyle.thumbDisabled)
123 source: platformStyle.shadow
133 property int downMouseX
134 property int downKnobX
137 rightMargin: platformStyle.mouseMarginRight
138 leftMargin: platformStyle.mouseMarginLeft
139 topMargin: platformStyle.mouseMarginTop
140 bottomMargin: platformStyle.mouseMarginBottom
144 if (knob.x < (platformStyle.maxKnobX + platformStyle.minKnobX) / 2) {
146 root.checked = false;
148 knob.x = platformStyle.minKnobX;
154 knob.x = platformStyle.maxKnobX;
165 var newKnobX = downKnobX - (downMouseX - mouseX);
166 knob.x = newKnobX < platformStyle.minKnobX ? platformStyle.minKnobX : newKnobX > platformStyle.maxKnobX ? platformStyle.maxKnobX : newKnobX;
170 if (Math.abs(downMouseX - mouseX) < 5)
171 root.checked = !root.checked;