1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
#------------------------------------------------------------------------------
# Copyright (c) 2014-2024,, Nucleic Development Team.
#
# Distributed under the terms of the Modified BSD License.
#
# The full license is in the file LICENSE, distributed with this software.
#------------------------------------------------------------------------------
from atom.api import Int, Typed
from enaml.core.declarative import d_, observe
from enaml.layout.layout_helpers import align, vbox
from enaml.layout.spacers import Spacer
from .container import Container
class VGroup(Container):
""" A Container subclass which groups child widgets vertically.
User constraints are applied *in addition* to the vertical group
constraints. Widgets are aligned along their left edge.
"""
#: The vertical spacing to place between widgets.
spacing = d_(Int(10))
#: The optional spacer to add as the first layout item.
leading_spacer = d_(Typed(Spacer))
#: The optional spacer to add as the last layout item.
trailing_spacer = d_(Typed(Spacer))
#--------------------------------------------------------------------------
# Observers
#--------------------------------------------------------------------------
@observe('spacing', 'leading_spacer', 'trailing_spacer')
def _layout_invalidated(self, change):
""" A private observer which invalidates the layout.
"""
# The superclass handler is sufficient.
super(VGroup, self)._layout_invalidated(change)
#--------------------------------------------------------------------------
# Layout Constraints
#--------------------------------------------------------------------------
def layout_constraints(self):
""" The constraints generation for a VGroup.
This method supplies left-aligned vertical group constraints for
the children of the container in addition to any user-supplied
constraints.
This method cannot be overridden from Enaml syntax.
"""
widgets = self.visible_widgets()
items = [self.leading_spacer] + widgets + [self.trailing_spacer]
cns = self.constraints[:]
cns.append(vbox(*items, spacing=self.spacing))
cns.append(align('left', *widgets))
return cns
|
