src/pgu/gui/group.py

   1 """
   2 """
   3 from const import *
   4 import widget
   5
   6 class Group(widget.Widget):
   7     """An object for grouping together Form elements.
   8
   9     <pre>Group(name=None,value=None)</pre>
  10
  11     <dl>
  12     <dt>name<dd>name as used in the Form
  13     <dt>value<dd>values that are currently selected in the group
  14     </dl>
  15
  16     <p>See [[gui-button]] for several examples.</p>
  17
  18     <p>When the value changes, an <tt>gui.CHANGE</tt> event is sent.
  19     Although note, that when the value is a list, it may have to be sent by hand via
  20     <tt>g.send(gui.CHANGE)</tt></p>
  21     """
  22
  23     def __init__(self,name=None,value=None):
  24         widget.Widget.__init__(self,name=name,value=value)
  25         self.widgets = []
  26
  27     def add(self,w):
  28         """Add a widget to this group.
  29
  30         <pre>Group.add(w)</pre>
  31         """
  32         self.widgets.append(w)
  33
  34     def __setattr__(self,k,v):
  35         _v = self.__dict__.get(k,NOATTR)
  36         self.__dict__[k] = v
  37         if k == 'value' and _v != NOATTR and _v != v:
  38             self._change()
  39
  40     def _change(self):
  41         self.send(CHANGE)
  42         for w in self.widgets:
  43             w.repaint()