Web   ·   Wiki   ·   Activities   ·   Blog   ·   Lists   ·   Chat   ·   Meeting   ·   Bugs   ·   Git   ·   Translate   ·   Archive   ·   People   ·   Donate
summaryrefslogtreecommitdiffstats
path: root/pgu/gui/group.py
blob: bcb231a69a070c62fc15744ebf9d237da7d57c1a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
"""
"""
from const import *
import widget

class Group(widget.Widget):
    """An object for grouping together Form elements.
    
    <pre>Group(name=None,value=None)</pre>
    
    <dl>
    <dt>name<dd>name as used in the Form
    <dt>value<dd>values that are currently selected in the group
    </dl>
    
    <p>See [[gui-button]] for several examples.</p>
    
    <p>When the value changes, an <tt>gui.CHANGE</tt> event is sent.
    Although note, that when the value is a list, it may have to be sent by hand via
    <tt>g.send(gui.CHANGE)</tt></p>
    """
    
    def __init__(self,name=None,value=None):
        widget.Widget.__init__(self,name=name,value=value)
        self.widgets = []
    
    def add(self,w):
        """Add a widget to this group.
        
        <pre>Group.add(w)</pre>
        """
        self.widgets.append(w)
    
    def __setattr__(self,k,v):
        _v = self.__dict__.get(k,NOATTR)
        self.__dict__[k] = v
        if k == 'value' and _v != NOATTR and _v != v:
            self._change()
    
    def _change(self):
        self.send(CHANGE)
        for w in self.widgets:
            w.repaint()