/usr/share/pyshared/kivy/uix/switch.py is in python-kivy 1.7.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 | '''
Switch
======
.. versionadded:: 1.0.7
.. image:: images/switch-on.jpg
:align: right
.. image:: images/switch-off.jpg
:align: right
The :class:`Switch` widget is active or inactive, like a mechanical light
switch. The user can swipe to the left/right to activate/deactivate it::
switch = Switch(active=True)
To attach a callback that listens to activation state::
def callback(instance, value):
print 'the switch', instance, 'is', value
switch = Switch()
switch.bind(active=callback)
By default, the representation of the widget is static. The minimum size
required is 83x32 pixels (defined by the background image). The image is
centered within the widget.
The entire widget is active, not just the part with graphics. As long as you
swipe over the widget's bounding box, it will work.
.. note::
If you want to control the state with a single touch instead of swipe,
use :class:`ToggleButton` instead.
'''
from kivy.uix.widget import Widget
from kivy.animation import Animation
from kivy.properties import BooleanProperty, ObjectProperty, NumericProperty
class Switch(Widget):
'''Switch class. See module documentation for more information.
'''
active = BooleanProperty(False)
'''Indicate if the switch is active or inactive.
:data:`active` is a :class:`~kivy.properties.BooleanProperty`, default to
False.
'''
touch_control = ObjectProperty(None, allownone=True)
'''(internal) Contains the touch that currently interacts with the switch.
:data:`touch_control` is a :class:`~kivy.properties.ObjectProperty`, default
to None.
'''
touch_distance = NumericProperty(0)
'''(internal) Contains the distance between the initial position of the
touch and the current position to determine if the swipe is from left or
right.
:data:`touch_distance` is a :class:`~kivy.properties.NumericProperty`,
default to 0.
'''
active_norm_pos = NumericProperty(0)
'''(internal) Contains the normalized position of the movable element
inside the switch, in the 0-1 range.
:data:`active_norm_pos` is a :class:`~kivy.properties.NumericProperty`,
default to 0.
'''
def on_touch_down(self, touch):
if self.touch_control is not None:
return
if not self.collide_point(*touch.pos):
return
touch.grab(self)
self.touch_distance = 0
self.touch_control = touch
return True
def on_touch_move(self, touch):
if touch.grab_current is not self:
return
self.touch_distance = touch.x - touch.ox
return True
def on_touch_up(self, touch):
if touch.grab_current is not self:
return
touch.ungrab(self)
# depending of the distance, activate by norm pos or invert
if abs(touch.ox - touch.x) < 5:
self.active = not self.active
else:
self.active = self.active_norm_pos > 0.5
Animation(active_norm_pos=int(self.active), t='out_quad',
d=.2).start(self)
self.touch_control = None
return True
if __name__ == '__main__':
from kivy.base import runTouchApp
runTouchApp(Switch())
|