fife-parpg: engine/extensions/pychan/widgets/widget.py annotate

annotate engine/extensions/pychan/widgets/widget.py @ 275:8a9cab8f8868

*fixed scons warnings part1

author	LinuxDonald@33b003aa-7bff-0310-803a-e67f0ece8222
date	Tue, 16 Jun 2009 17:58:37 +0000
parents	51cc05d862f2
children	aca5744f017a

rev	line source
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	1 # -- coding: utf-8 --
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	2
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	3 from pychan.widgets.common import *
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	4
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	5 class Widget(object):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	6 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	7 This is the common widget base class, which provides most of the wrapping
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	8 functionality.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	9
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	10 Attributes
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	11 ==========
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	12
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	13 Widgets are manipulated (mostly) through attributes - and these can all be set by XML attributes.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	14 Derived widgets will have other attributes. Please see their B{New Attributes} sections. The types of the
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	15 attributes are pretty straightforward, but note that Position and Color attribute types will also accept
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	16 C{fife.Point} and C{fife.Color} values.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	17
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	18 - name: String: The identification of the widget, most useful if it is unique within a given widget hiarachy.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	19 This is used to find widgets by L{mapEvents},L{distributeInitialData},L{distributeData} and L{collectData}.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	20 - position: Position: The position relative to the parent widget - or on screen, if this is the root widget.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	21 - size: Position: The real size of the widget (including border and margins). Usually you do not need to set this.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	22 A notable exception is the L{ScrollArea}.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	23 - min_size: Position: The minimal size this widget is allowed to have. This is enforced through the accessor methods
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	24 of the actual size attribute.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	25 - max_size: Position: The maximal size this widget is allowed to have. This is enforced through the accessor methods
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	26 of the actual size attribute.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	27 - base_color: Color
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	28 - background_color: Color
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	29 - foreground_color: Color
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	30 - selection_color: Color
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	31 - font: String: This should identify a font that was loaded via L{loadFonts} before.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	32 - helptext: Unicode: Text which can be used for e.g. tooltips.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	33 - border_size: Integer: The size of the border in pixels.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	34 - position_technique: This can be either "automatic" or "explicit" - only L{Window} has this set to "automatic" which
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	35 results in new windows being centered on screen (for now).
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	36 If it is set to "explicit" the position attribute will not be touched.
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	37 - vexpand: Integer: >= 0. Proportion to expand this widget vertically.
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	38 - hexpand: Integer: >= 0. Proportion to expand this widget horizontally.
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	39
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	40 Convenience Attributes
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	41 ======================
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	42
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	43 These attributes are convenience/shorthand versions of above mentioned attributes and assignment will reflect
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	44 the associated attributes values. E.g. the following is equivalent::
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	45 # Set X position, leave Y alone
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	46 widget.x = 10
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	47 # Same here
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	48 posi = widget.position
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	49 widget.position = (10, posi[1])
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	50
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	51 Here they are.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	52
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	53 - x: Integer: The horizontal part of the position attribute.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	54 - y: Integer: The vertical part of the position attribute.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	55 - width: Integer: The horizontal part of the size attribute.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	56 - height: Integer: The vertical part of the size attribute.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	57
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	58 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	59
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	60 ATTRIBUTES = [ Attr('name'), PointAttr('position'),
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	61 PointAttr('min_size'), PointAttr('size'), PointAttr('max_size'),
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	62 ColorAttr('base_color'),ColorAttr('background_color'),ColorAttr('foreground_color'),ColorAttr('selection_color'),
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	63 Attr('style'), Attr('font'),IntAttr('border_size'),Attr('position_technique'),
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	64 IntAttr('vexpand'),IntAttr('hexpand'),
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	65 UnicodeAttr('helptext'), BoolAttr('is_focusable')
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	66 ]
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	67
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	68 DEFAULT_NAME = '__unnamed__'
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	69 DEFAULT_HEXPAND = 0
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	70 DEFAULT_VEXPAND = 0
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	71 DEFAULT_MAX_SIZE = 500000, 500000
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	72
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	73 HIDE_SHOW_ERROR = """\
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	74 You can only show/hide the top widget of a hierachy.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	75 Use 'addChild' or 'removeChild' to add/remove labels for example.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	76 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	77
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	78
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	79 def __init__(self,parent = None, name = DEFAULT_NAME,
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	80 size = (-1,-1), min_size=(0,0), max_size=DEFAULT_MAX_SIZE,
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	81 helptext=u"",
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	82 position = (0,0),
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	83 style = None, **kwargs):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	84
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	85 assert( hasattr(self,'real_widget') )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	86 self.event_mapper = events.EventMapper(self)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	87 self._visible = False
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	88 self._extra_border = (0,0)
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	89 self.hexpand = kwargs.get("hexpand",self.DEFAULT_HEXPAND)
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	90 self.vexpand = kwargs.get("vexpand",self.DEFAULT_VEXPAND)
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	91 # Simple way to get at least some compat layout:
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	92 if get_manager().compat_layout:
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	93 self.hexpand, self.vexpand = 0,0
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	94
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	95 # Data distribution & retrieval settings
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	96 self.accepts_data = False
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	97 self.accepts_initial_data = False
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	98
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	99 # Parent attribute makes sure we only have one parent,
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	100 # that tests self.__parent - so make sure we have the attr here.
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	101 self.__parent = None
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	102 self.parent = parent
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	103
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	104 # This will also set the _event_id and call real_widget.setActionEventId
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	105 self.name = name
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	106
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	107 self.position = position
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	108 self.min_size = min_size
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	109 self.max_size = max_size
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	110 self.size = size
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	111 self.position_technique = "explicit"
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	112 self.font = 'default'
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	113
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	114 # Inherit style
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	115 if style is None and parent:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	116 style = parent.style
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	117 self.style = style or "default"
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	118
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	119 self.helptext = helptext
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	120 # Not needed as attrib assignment will trigger manager.stylize call
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	121 #manager.stylize(self,self.style)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	122
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	123 def execute(self,bind):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	124 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	125 Execute a dialog synchronously.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	126
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	127 As argument a dictionary mapping widget names to return values
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	128 is expected. Events from these widgets will cause this function
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	129 to return with the associated return value.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	130
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	131 This function will not return until such an event occurs.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	132 The widget will be shown before execution and hidden afterwards.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	133 You can only execute root widgets.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	134
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	135 Note: This feature is not tested well, and the API will probably
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	136 change. Otherwise have fun::
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	137 # Okay this a very condensed example :-)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	138 return pychan.loadXML("contents/gui/dialog.xml").execute({ 'okButton' : True, 'closeButton' : False })
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	139
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	140 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	141 if not get_manager().can_execute:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	142 raise RuntimeError("Synchronous execution is not set up!")
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	143 if self.__parent:
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	144 raise RuntimeError("You can only 'execute' root widgets, not %s!" % str(self))
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	145
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	146 for name,returnValue in bind.items():
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	147 def _quitThisDialog(returnValue = returnValue ):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	148 get_manager().breakFromMainLoop( returnValue )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	149 self.hide()
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	150 self.findChild(name=name).capture( _quitThisDialog , group_name = "__execute__" )
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	151 self.show()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	152 return get_manager().mainLoop()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	153
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	154 def match(self,**kwargs):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	155 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	156 Matches the widget against a list of key-value pairs.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	157 Only if all keys are attributes and their value is the same it returns True.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	158 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	159 for k,v in kwargs.items():
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	160 if v != getattr(self,k,None):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	161 return False
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	162 return True
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	163
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	164 def capture(self, callback, event_name="action", group_name="default"):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	165 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	166 Add a callback to be executed when the widget event occurs on this widget.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	167
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	168 The callback must be either a callable or None.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	169 The old event handler (if any) will be overridden by the callback.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	170 If None is given, the event will be disabled. You can query L{isCaptured}
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	171 wether this widgets events are currently captured.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	172
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	173 It might be useful to check out L{tools.callbackWithArguments}.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	174
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	175 @param callback: Event callback - may accept keyword arguments event and widget.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	176 @paran event_name: The event to capture - may be one of L{events.EVENTS} and defaults to "action"
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	177 @paran group_name: Event group.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	178
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	179 Event groups are used to have different B{channels} which don't interfere with each other.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	180 For derived widgets that need to capture events it's advised to use the group_name 'widget'.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	181 The 'default' group is used by default, and should be reserved for the application programmers.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	182 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	183 self.event_mapper.capture( event_name, callback, group_name )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	184
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	185 def isCaptured(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	186 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	187 Check whether this widgets events are captured
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	188 (a callback is installed) or not.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	189 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	190 return bool(self.event_mapper.getCapturedEvents())
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	191
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	192 def show(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	193 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	194 Show the widget and all contained widgets.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	195 """
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	196 if self.parent:
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	197 raise RuntimeError(Widget.HIDE_SHOW_ERROR)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	198 if self._visible: return
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	199 self.adaptLayout()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	200 self.beforeShow()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	201 get_manager().show(self)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	202 self._visible = True
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	203
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	204 def hide(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	205 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	206 Hide the widget and all contained widgets.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	207 """
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	208 if self.parent:
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	209 raise RuntimeError(Widget.HIDE_SHOW_ERROR)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	210 if not self._visible: return
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	211
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	212 get_manager().hide(self)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	213
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	214 self.afterHide()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	215 self._visible = False
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	216
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	217 def isVisible(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	218 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	219 Check whether the widget is currently shown,
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	220 either directly or as part of a container widget.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	221 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	222 widget = self
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	223 while widget.parent:
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	224 widget = widget.parent
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	225 return widget._visible
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	226
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	227 def adaptLayout(self,recurse=True):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	228 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	229 Execute the Layout engine. Automatically called by L{show}.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	230 In case you want to relayout a visible widget.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	231 This function will automatically perform the layout adaption
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	232 from the top-most layouted widget.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	233
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	234 To make this clear consider this arrangement::
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	235 VBox 1
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	236 - Container
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	237 - VBox 2
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	238 - HBox
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	239 - Label
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	240
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	241 If you call adaptLayout on the Label the layout from the VBox 2
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	242 will get recalculated, while the VBox 1 stays untouched.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	243
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	244 @param recurse Pass False here to force the layout to start from
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	245 this widget.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	246 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	247 widget = self
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	248 while widget.parent and recurse:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	249 if not isLayouted(widget.parent):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	250 break
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	251 widget = widget.parent
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	252 widget._recursiveResizeToContent()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	253 widget._recursiveExpandContent()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	254
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	255 def beforeShow(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	256 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	257 This method is called just before the widget is shown.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	258 You can override this in derived widgets to add finalization
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	259 behaviour.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	260 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	261
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	262 def afterHide(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	263 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	264 This method is called just before the widget is hidden.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	265 You can override this in derived widgets to add finalization
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	266 behaviour.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	267 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	268
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	269 def findChildren(self,**kwargs):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	270 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	271 Find all contained child widgets by attribute values.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	272
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	273 Usage::
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	274 closeButtons = root_widget.findChildren(name='close')
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	275 buttons = root_widget.findChildren(__class__=pychan.widgets.Button)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	276 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	277
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	278 children = []
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	279 def _childCollector(widget):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	280 if widget.match(**kwargs):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	281 children.append(widget)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	282 self.deepApply(_childCollector)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	283 return children
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	284
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	285 def findChild(self,**kwargs):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	286 """ Find the first contained child widgets by attribute values.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	287
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	288 Usage::
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	289 closeButton = root_widget.findChild(name='close')
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	290 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	291 children = self.findChildren(**kwargs)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	292 if children:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	293 return children[0]
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	294 return None
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	295
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	296 def addChild(self,widget):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	297 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	298 This function adds a widget as child widget and is only implemented
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	299 in container widgets.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	300
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	301 You'll need to call L{adaptLayout} if the container is already shown,
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	302 to adapt the layout to the new widget. This doesn't happen
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	303 automatically.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	304 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	305 raise RuntimeError("Trying to add a widget to %s, which doesn't allow this." % repr(self))
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	306
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	307 def insertChild(self, widget, position):
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	308 """
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	309 This function inserts a widget a given index in the child list.
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	310
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	311 See L{addChild} and L{insertChildBefore}
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	312 """
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	313 raise RuntimeError("Trying to insert a widget to %s, which doesn't allow this." % repr(self))
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	314
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	315 def insertChildBefore(self, widget, before):
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	316 """
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	317 Inserts a child widget before a given widget. If the widget isn't found,
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	318 the widget is appended to the children list.
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	319
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	320 See L{addChild} and L{insertChild}
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	321 """
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	322 raise RuntimeError("Trying to insert a widget to %s, which doesn't allow this." % repr(self))
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	323
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	324 def addChildren(self,*widgets):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	325 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	326 Add multiple widgets as children.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	327 Only implemented for container widgets. See also L{addChild}
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	328
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	329 Usage::
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	330 container.addChildren( widget1, widget2, ... )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	331 # or you can use this on a list
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	332 container.addChildren( [widget1,widget2,...] )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	333 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	334 if len(widgets) == 1 and not isinstance(widgets[0],Widget):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	335 widgets = widgets[0]
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	336 for widget in widgets:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	337 self.addChild(widget)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	338
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	339 def removeChild(self,widget):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	340 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	341 This function removes a direct child widget and is only implemented
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	342 in container widgets.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	343
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	344 You'll need to call L{adaptLayout} if the container is already shown,
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	345 to adapt the layout to the removed widget. This doesn't happen
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	346 automatically.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	347 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	348 raise RuntimeError("Trying to remove a widget from %s, which is not a container widget." % repr(self))
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	349
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	350 def removeChildren(self,*widgets):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	351 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	352 Remove a list of direct child widgets.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	353 All widgets have to be direct child widgets.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	354 To 'clear' a container take a look at L{removeAllChildren}.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	355 See also L{removeChild}.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	356
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	357 Usage::
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	358 container.removeChildren( widget1, widget2, ... )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	359 # or you can use this on a list
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	360 container.removeChildren( [widget1,widget2,...] )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	361 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	362 if len(widgets) == 1 and not isinstance(widgets[0],Widget):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	363 widgets = widgets[0]
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	364 for widget in widgets:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	365 self.removeChild(widget)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	366
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	367 def removeAllChildren(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	368 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	369 This function will remove all direct child widgets.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	370 This will work even for non-container widgets.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	371 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	372 children = self.findChildren(parent=self)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	373 for widget in children:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	374 self.removeChild(widget)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	375
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	376 def mapEvents(self,eventMap,ignoreMissing = False):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	377 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	378 Convenience function to map widget events to functions
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	379 in a batch.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	380
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	381 Subsequent calls of mapEvents will merge events with different
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	382 widget names and override the previously set callback.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	383 You can also pass C{None} instead of a callback, which will
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	384 disable the event completely.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	385
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	386 @param eventMap: A dictionary with widget/event names as keys and callbacks as values.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	387 @param ignoreMissing: Normally this method raises an RuntimeError, when a widget
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	388 can not be found - this behaviour can be overriden by passing True here.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	389
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	390 The keys in the dictionary are parsed as C{"widgetName/eventName"} with the slash
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	391 separating the two. If no slash is found the eventName is assumed to be "action".
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	392
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	393 Additionally you can supply a group name or channel C{"widgetName/eventName/groupName"}.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	394 Event handlers from one group are not overridden by handlers from another group.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	395 The default group name is C{"default"}.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	396
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	397 Example::
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	398 guiElement.mapEvents({
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	399 "button" : guiElement.hide,
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	400 "button/mouseEntered" : toggleButtonColorGreen,
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	401 "button/mouseExited" : toggleButtonColorBlue,
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	402 })
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	403
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	404 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	405 for descr,func in eventMap.items():
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	406 name, event_name, group_name = events.splitEventDescriptor(descr)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	407 #print name, event_name, group_name
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	408 widget = self.findChild(name=name)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	409 if widget:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	410 widget.capture( func, event_name = event_name, group_name = group_name )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	411 elif not ignoreMissing:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	412 raise RuntimeError("No widget with the name: %s" % name)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	413
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	414 def setInitialData(self,data):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	415 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	416 Set the initial data on a widget, what this means depends on the Widget.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	417 In case the widget does not accept initial data, a L{RuntimeError} is thrown.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	418 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	419 if not self.accepts_initial_data:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	420 raise RuntimeError("Trying to set data on a widget that does not accept initial data. Widget: %s Data: %s " % (repr(self),repr(data)))
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	421 self._realSetInitialData(data)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	422
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	423 def setData(self,data):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	424 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	425 Set the user-mutable data on a widget, what this means depends on the Widget.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	426 In case the widget does not accept data, a L{RuntimeError} is thrown.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	427 This is inverse to L{getData}.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	428 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	429 if not self.accepts_data:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	430 raise RuntimeError("Trying to set data on a widget that does not accept data.")
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	431 self._realSetData(data)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	432
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	433 def getData(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	434 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	435 Get the user-mutable data of a widget, what this means depends on the Widget.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	436 In case the widget does not have user mutable data, a L{RuntimeError} is thrown.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	437 This is inverse to L{setData}.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	438 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	439 if not self.accepts_data:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	440 raise RuntimeError("Trying to retrieve data from a widget that does not accept data.")
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	441 return self._realGetData()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	442
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	443 def distributeInitialData(self,initialDataMap):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	444 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	445 Distribute B{initial} (not mutable by the user) data from a dictionary over the widgets in the hierachy
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	446 using the keys as names and the values as the data (which is set via L{setInitialData}).
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	447 If more than one widget matches - the data is set on ALL matching widgets.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	448 By default a missing widget is just ignored.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	449
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	450 Use it like this::
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	451 guiElement.distributeInitialData({
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	452 'myTextField' : 'Hello World!',
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	453 'myListBox' : ["1","2","3"]
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	454 })
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	455
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	456 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	457 for name,data in initialDataMap.items():
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	458 widgetList = self.findChildren(name = name)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	459 for widget in widgetList:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	460 widget.setInitialData(data)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	461
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	462 def distributeData(self,dataMap):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	463 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	464 Distribute data from a dictionary over the widgets in the hierachy
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	465 using the keys as names and the values as the data (which is set via L{setData}).
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	466 This will only accept unique matches.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	467
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	468 Use it like this::
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	469 guiElement.distributeData({
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	470 'myTextField' : 'Hello World!',
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	471 'myListBox' : ["1","2","3"]
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	472 })
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	473
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	474 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	475 for name,data in dataMap.items():
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	476 widgetList = self.findChildren(name = name)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	477 if len(widgetList) != 1:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	478 if get_manager().debug:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	479 self.listNamedWidgets()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	480 raise RuntimeError("DistributeData can only handle widgets with unique names.")
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	481 widgetList[0].setData(data)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	482
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	483 def collectDataAsDict(self,widgetNames):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	484 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	485 Collect data from a widget hierachy by names into a dictionary.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	486 This can only handle UNIQUE widget names (in the hierachy)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	487 and will raise a RuntimeError if the number of matching widgets
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	488 is not equal to one.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	489
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	490 Usage::
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	491 data = guiElement.collectDataAsDict(['myTextField','myListBox'])
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	492 print "You entered:",data['myTextField']," and selected ",data['myListBox']
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	493
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	494 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	495 dataMap = {}
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	496 for name in widgetNames:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	497 widgetList = self.findChildren(name = name)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	498 if len(widgetList) != 1:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	499 if get_manager().debug:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	500 self.listNamedWidgets()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	501 raise RuntimeError("CollectData can only handle widgets with unique names.")
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	502
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	503 dataMap[name] = widgetList[0].getData()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	504 return dataMap
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	505
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	506 def collectData(self,*widgetNames):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	507 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	508 Collect data from a widget hierachy by names.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	509 This can only handle UNIQUE widget names (in the hierachy)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	510 and will raise a RuntimeError if the number of matching widgets
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	511 is not equal to one.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	512
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	513 This function takes an arbitrary number of widget names and
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	514 returns a list of the collected data in the same order.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	515
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	516 In case only one argument is given, it will return just the
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	517 data, with out putting it into a list.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	518
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	519 Usage::
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	520 # Multiple element extraction:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	521 text, selected = guiElement.collectData('myTextField','myListBox')
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	522 print "You entered:",text," and selected item nr",selected
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	523 # Single elements are handled gracefully, too:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	524 test = guiElement.collectData('testElement')
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	525
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	526 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	527 dataList = []
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	528 for name in widgetNames:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	529 widgetList = self.findChildren(name = name)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	530 if len(widgetList) != 1:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	531 if get_manager().debug:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	532 self.listNamedWidgets()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	533 raise RuntimeError("CollectData can only handle widgets with unique names.")
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	534 dataList.append( widgetList[0].getData() )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	535 if len(dataList) == 1:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	536 return dataList[0]
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	537 return dataList
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	538
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	539 def listNamedWidgets(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	540 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	541 This function will print a list of all currently named child-widgets
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	542 to the standard output. This is useful for debugging purposes.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	543 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	544 def _printNamedWidget(widget):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	545 if widget.name != Widget.DEFAULT_NAME:
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	546 print widget.name.ljust(20),repr(widget).ljust(50),repr(widget.__parent)
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	547 print "Named child widgets of ",repr(self)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	548 print "name".ljust(20),"widget".ljust(50),"parent"
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	549 self.deepApply(_printNamedWidget)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	550
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	551 def stylize(self,style,**kwargs):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	552 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	553 Recursively apply a style to all widgets.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	554 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	555 def _restyle(widget):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	556 get_manager().stylize(widget,style,**kwargs)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	557 self.deepApply(_restyle)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	558
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	559 def resizeToContent(self,recurse = True):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	560 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	561 Try to shrink the widget, so that it fits closely around its content.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	562 Do not call directly.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	563 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	564
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	565 def expandContent(self,recurse = True):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	566 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	567 Try to expand any spacer in the widget within the current size.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	568 Do not call directly.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	569 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	570
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	571
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	572 def _recursiveResizeToContent(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	573 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	574 Recursively call L{resizeToContent}. Uses L{deepApply}.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	575 Do not call directly.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	576 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	577 def _callResizeToContent(widget):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	578 #print "RTC:",widget
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	579 widget.resizeToContent()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	580 self.deepApply(_callResizeToContent)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	581
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	582 def _recursiveExpandContent(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	583 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	584 Recursively call L{expandContent}. Uses L{deepApply}.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	585 Do not call directly.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	586 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	587 def _callExpandContent(widget):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	588 #print "ETC:",widget
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	589 widget.expandContent()
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	590 self.deepApply(_callExpandContent, leaves_first=False)
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	591
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	592 def deepApply(self,visitorFunc, leaves_first = True):
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	593 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	594 Recursively apply a callable to all contained widgets and then the widget itself.
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	595 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	596 visitorFunc(self)
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	597
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	598 def getAbsolutePos(self):
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	599 """
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	600 Get absolute position on screen
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	601 """
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	602 absX = self.x
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	603 absY = self.y
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	604 parent = self.parent
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	605 while parent is not None:
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	606 absX += parent.x
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	607 absY += parent.y
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	608 parent = parent.parent
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	609 return (absX, absY)
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	610
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	611 def sizeChanged(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	612 pass
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	613
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	614 def __str__(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	615 return "%s(name='%s')" % (self.__class__.__name__,self.name)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	616
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	617 def __repr__(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	618 return "<%s(name='%s') at %x>" % (self.__class__.__name__,self.name,id(self))
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	619
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	620 def _setSize(self,size):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	621 if isinstance(size,fife.Point):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	622 self.width, self.height = size.x, size.y
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	623 else:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	624 self.width, self.height = size
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	625
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	626 def _getSize(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	627 return self.width, self.height
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	628
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	629 def _setPosition(self,size):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	630 if isinstance(size,fife.Point):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	631 self.x, self.y = size.x, size.y
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	632 else:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	633 self.x, self.y = size
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	634
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	635 def _getPosition(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	636 return self.x, self.y
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	637
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	638 def _setX(self,x):self.real_widget.setX(x)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	639 def _getX(self): return self.real_widget.getX()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	640 def _setY(self,y): self.real_widget.setY(y)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	641 def _getY(self): return self.real_widget.getY()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	642
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	643 def _setWidth(self,w):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	644 old_width = self.width
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	645 w = max(self.min_size[0],w)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	646 w = min(self.max_size[0],w)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	647 self.real_widget.setWidth(w)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	648 if w != old_width:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	649 self.sizeChanged()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	650
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	651 def _getWidth(self): return self.real_widget.getWidth()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	652 def _setHeight(self,h):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	653 old_height = self.height
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	654 h = max(self.min_size[1],h)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	655 h = min(self.max_size[1],h)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	656 self.real_widget.setHeight(h)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	657 if h != old_height:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	658 self.sizeChanged()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	659
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	660 def _getHeight(self): return self.real_widget.getHeight()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	661
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	662 def _getMinWidth(self): return self.min_size[0]
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	663 def _getMaxWidth(self): return self.max_size[0]
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	664 def _getMinHeight(self): return self.min_size[1]
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	665 def _getMaxHeight(self): return self.max_size[1]
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	666 def _setMinWidth(self,w):
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	667 self.min_size = w, self.min_size[1]
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	668 def _setMaxWidth(self,w):
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	669 self.max_size = w, self.max_size[1]
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	670 def _setMinHeight(self,h):
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	671 self.min_size = self.min_size[0],h
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	672 def _setMaxHeight(self,h):
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	673 self.max_size = self.max_size[0],h
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	674
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	675 def _setFont(self, font):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	676 self._font = font
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	677 self.real_font = get_manager().getFont(font)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	678 self.real_widget.setFont(self.real_font)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	679 def _getFont(self):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	680 return self._font
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	681
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	682 def _getBorderSize(self): return self.real_widget.getFrameSize()
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	683 def _setBorderSize(self,size): self.real_widget.setFrameSize(size)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	684
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	685 base_color = ColorProperty("BaseColor")
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	686 background_color = ColorProperty("BackgroundColor")
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	687 foreground_color = ColorProperty("ForegroundColor")
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	688 selection_color = ColorProperty("SelectionColor")
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	689
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	690 def _getStyle(self): return self._style
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	691 def _setStyle(self,style):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	692 self._style = style
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	693 get_manager().stylize(self,style)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	694 style = property(_getStyle,_setStyle)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	695
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	696 def _getParent(self): return self.__parent
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	697 def _setParent(self,parent):
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	698 if self.__parent is not parent:
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	699 if self.__parent and parent is not None:
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	700 print "Widget containment fumble:", self, self.__parent, parent
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	701 self.__parent.removeChild(self)
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	702 self.__parent = parent
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	703 parent = property(_getParent,_setParent)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	704
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	705 def _setName(self,name): self._name = name
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	706 def _getName(self):
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	707 # __str__ relies on self.name
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	708 return getattr(self,'_name','__no_name_yet__')
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	709 name = property(_getName,_setName)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	710
253 6ab09eb765a1 * Added patch by MadMonk that exposes the guichan focus functions to pychan nihathrael@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 249 diff changeset	711 def _setFocusable(self, b): self.real_widget.setFocusable(b)
6ab09eb765a1 * Added patch by MadMonk that exposes the guichan focus functions to pychan nihathrael@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 249 diff changeset	712 def _isFocusable(self):
6ab09eb765a1 * Added patch by MadMonk that exposes the guichan focus functions to pychan nihathrael@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 249 diff changeset	713 return self.real_widget.isFocusable()
6ab09eb765a1 * Added patch by MadMonk that exposes the guichan focus functions to pychan nihathrael@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 249 diff changeset	714
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	715 x = property(_getX,_setX)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	716 y = property(_getY,_setY)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	717 width = property(_getWidth,_setWidth)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	718 height = property(_getHeight,_setHeight)
255 51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	719 min_width = property(_getMinWidth,_setMinWidth)
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	720 min_height = property(_getMinHeight,_setMinHeight)
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	721 max_width = property(_getMaxWidth,_setMaxWidth)
51cc05d862f2 Merged editor_rewrite branch to trunk. cheesesucker@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 253 diff changeset	722 max_height = property(_getMaxHeight,_setMaxHeight)
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	723 size = property(_getSize,_setSize)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	724 position = property(_getPosition,_setPosition)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	725 font = property(_getFont,_setFont)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	726 border_size = property(_getBorderSize,_setBorderSize)
253 6ab09eb765a1 * Added patch by MadMonk that exposes the guichan focus functions to pychan nihathrael@33b003aa-7bff-0310-803a-e67f0ece8222 parents: 249 diff changeset	727 is_focusable = property(_isFocusable,_setFocusable)
248 a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	728
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	729 def setEnterCallback(self, cb):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	730 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	731 DEPRECATED
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	732
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	733 Callback is called when mouse enters the area of Widget
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	734 callback should have form of function(button)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	735 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	736 if cb is None:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	737 self.capture(None, event_name = "mouseEntered" )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	738 return
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	739
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	740 def callback(widget=None):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	741 return cb(widget)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	742 print "PyChan: You are using the DEPRECATED functionality: setEnterCallback."
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	743 self.capture(callback, event_name = "mouseEntered" )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	744
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	745 def setExitCallback(self, cb):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	746 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	747 DEPRECATED
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	748
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	749 Callback is called when mouse exits the area of Widget
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	750 callback should have form of function(button)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	751 """
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	752 if cb is None:
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	753 self.capture(None, event_name = "mouseExited" )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	754 return
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	755
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	756 def callback(widget=None):
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	757 return cb(widget)
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	758 print "PyChan: You are using the DEPRECATED functionality: setExitCallback."
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	759 self.capture(callback, event_name = "mouseExited" )
a2d5e2721489 widgets.py split up. phoku@33b003aa-7bff-0310-803a-e67f0ece8222 parents: diff changeset	760

Mercurial > fife-parpg

annotate engine/extensions/pychan/widgets/widget.py @ 275:8a9cab8f8868