aboutsummaryrefslogtreecommitdiff
path: root/lib/python/Screens/Screen.py
blob: 989f90a9e6a5d9dfc6185ecf91955090bee06e2b (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
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
113
114
115
116
117
118
119
120
121
122
123
124
125
from Components.HTMLSkin import *
from Components.GUISkin import *
from Components.Sources.Source import Source

import sys

class Screen(dict, HTMLSkin, GUISkin):

	ALLOW_SUSPEND = False

	def __init__(self, session):
		self.skinName = self.__class__.__name__
		self.session = session
		GUISkin.__init__(self)
		
		self.onClose = [ ]
		self.onFirstExecBegin = [ ]
		self.onExecBegin = [ ]
		self.onShown = [ ]
		
		self.onShow = [ ]
		self.onHide = [ ]
		
		self.execing = False
		self.shown = False
		
		self.renderer = [ ]
		
		# in order to support screens *without* a help,
		# we need the list in every screen. how ironic.
		self.helpList = [ ]
		
	def execBegin(self):
		self.active_components = [ ]

		single = self.onFirstExecBegin
		self.onFirstExecBegin = []
		for x in self.onExecBegin + single:
			x()
			if self.session.current_dialog != self:
				return

#		assert self.session == None, "a screen can only exec once per time"
#		self.session = session

		for val in self.values() + self.renderer:
			val.execBegin()
			if self.session.current_dialog != self:
				return
			self.active_components.append(val)

		self.execing = True
	
		for x in self.onShown:
			x()
	
	def execEnd(self):
#		for (name, val) in self.items():
		for val in self.active_components:
			val.execEnd()
		del self.active_components
#		assert self.session != None, "execEnd on non-execing screen!"
#		self.session = None
		self.execing = False
	
	# never call this directly - it will be called from the session!
	def doClose(self):
		self.hide()
		for x in self.onClose:
			x()
		
		# fixup circular references
		del self.helpList
		GUISkin.close(self)

		# first disconnect all render from their sources.
		# we might split this out into a "unskin"-call,
		# but currently we destroy the screen afterwards
		# anyway.
		for val in self.renderer:
			val.disconnectAll()  # disconnected converter/sources and probably destroy them
		
		del self.session
		for (name, val) in self.items():
			val.destroy()
			del self[name]
		
		for val in self.renderer:
			val.destroy()
		
		self.renderer = [ ]
		
		# really delete all elements now
		self.__dict__.clear()
	
	def close(self, *retval):
		self.session.close(self, *retval)

	def setFocus(self, o):
		self.instance.setFocus(o.instance)

	def show(self):
		if self.shown:
			return
		self.shown = True
		self.instance.show()
		for x in self.onShow:
			x()
		for val in self.values() + self.renderer:
			if isinstance(val, GUIComponent) or isinstance(val, Source):
				val.onShow()

	def hide(self):
		if not self.shown:
			return
		self.shown = False
		self.instance.hide()
		for x in self.onHide:
			x()
		for val in self.values() + self.renderer:
			if isinstance(val, GUIComponent) or isinstance(val, Source):
				val.onHide()

	def __repr__(self):
		return str(type(self))