aboutsummaryrefslogtreecommitdiff
path: root/lib/Abstract.py
blob: 385e6e57ae1a470c6713dd0ed24d93cd2a48e1a4 (plain)
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
# Abstract classes for parents and children.
#
# Do not use as base class -- this is for documentation only.
#
# Note that the tree must be built top down (create the parent,
# then add the children).
#
# Also note that the creation methods are not standardized --
# these have extra parameters dependent on the widget type.
# For historical reasons, button creation methods are called
# define() while split creation methods are called create().

class AbstractParent():
 #
 # Upcalls from child to parent
 #
 def addchild(self, child): unimpl()
 def delchild(self, child): unimpl()
 #
 def need_mouse(self, child): unimpl()
 def no_mouse(self, child): unimpl()
 #
 def need_timer(self, child): unimpl()
 def no_timer(self, child): unimpl()
 #
 # XXX need_kbd, no_kbd; focus???
 #
 def begindrawing(self): return unimpl()
 def beginmeasuring(self): return unimpl()
 #
 def change(self, area): unimpl()
 def scroll(self, (area, (dh, dv))): unimpl()
 def settimer(self, itimer): unimpl()

class AbstractChild():
 #
 # Downcalls from parent to child
 #
 def destroy(self): unimpl()
 #
 def minsize(self, m): return unimpl()
 def getbounds(self): return unimpl()
 def setbounds(self, bounds): unimpl()
 def draw(self, (d, area)): unimpl()
 #
 # Downcalls only made after certain upcalls
 #
 def mouse_down(self, detail): unimpl()
 def mouse_move(self, detail): unimpl()
 def mouse_up(self, detail): unimpl()
 #
 def timer(self): unimpl()

# A "Split" is a child that manages one or more children.
# (This terminology is due to DEC SRC, except for CSplits.)
# A child of a split may be another split, a button, a slider, etc.
# Certain upcalls and downcalls can be handled transparently, but
# for others (e.g., all geometry related calls) this is not possible.

class AbstractSplit() = AbstractChild(), AbstractParent():
 pass