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
|
#------------------------------------------------------------------------------
# Copyright (c) 2013-2025, Nucleic Development Team.
#
# Distributed under the terms of the Modified BSD License.
#
# The full license is in the file LICENSE, distributed with this software.
#------------------------------------------------------------------------------
from atom.api import Bool, Event, Int, ForwardTyped, Typed
from enaml.core.declarative import d_, observe
from .toolkit_object import ToolkitObject, ProxyToolkitObject
class ProxyTimer(ProxyToolkitObject):
""" The abstract definition of a proxy Timer object.
"""
#: A reference to the Timer declaration.
declaration = ForwardTyped(lambda: Timer)
def set_interval(self, interval):
raise NotImplementedError
def set_single_shot(self, single_shot):
raise NotImplementedError
def start(self):
raise NotImplementedError
def stop(self):
raise NotImplementedError
def is_running(self):
raise NotImplementedError
class Timer(ToolkitObject):
""" An object which represents a toolkit independent timer.
"""
#: The interval of the timer, in milliseconds. The default is 0 and
#: indicates that the timer will fire as soon as the event queue is
#: emptied of all pending events.
interval = d_(Int(0))
#: Whether the timer fires only once, or repeatedly until stopped.
single_shot = d_(Bool(False))
#: An event fired when the timer times out.
timeout = d_(Event(), writable=False)
#: A reference to the ProxyTimer object.
proxy = Typed(ProxyTimer)
#--------------------------------------------------------------------------
# Observers
#--------------------------------------------------------------------------
@observe('single_shot', 'interval')
def _update_proxy(self, change):
""" An observer which updates the proxy when the state changes.
"""
# The superclass implementation is sufficient.
super(Timer, self)._update_proxy(change)
def start(self):
""" Start or restart the timer.
If the timer is already started, it will be stopped and
restarted.
"""
if self.proxy_is_active:
self.proxy.start()
def stop(self):
""" Stop the timer.
If the timer is already stopped, this is a no-op.
"""
if self.proxy_is_active:
self.proxy.stop()
def is_active(self):
""" Returns True if the timer is running, False otherwise.
"""
if self.proxy_is_active:
return self.proxy.is_running()
return False
|
