123 lines
3.5 KiB
Python
123 lines
3.5 KiB
Python
|
'''
|
||
|
|
Anchor Layout
|
||
|
|
=============
|
||
|
|
|
||
|
|
.. only:: html
|
||
|
|
|
||
|
|
.. image:: images/anchorlayout.gif
|
||
|
|
:align: right
|
||
|
|
|
||
|
|
.. only:: latex
|
||
|
|
|
||
|
|
.. image:: images/anchorlayout.png
|
||
|
|
:align: right
|
||
|
|
|
||
|
|
The :class:`AnchorLayout` aligns its children to a border (top, bottom,
|
||
|
|
left, right) or center.
|
||
|
|
|
||
|
|
|
||
|
|
To draw a button in the lower-right corner::
|
||
|
|
|
||
|
|
layout = AnchorLayout(
|
||
|
|
anchor_x='right', anchor_y='bottom')
|
||
|
|
btn = Button(text='Hello World')
|
||
|
|
layout.add_widget(btn)
|
||
|
|
|
||
|
|
'''
|
||
|
|
|
||
|
|
__all__ = ('AnchorLayout', )
|
||
|
|
|
||
|
|
from kivy.uix.layout import Layout
|
||
|
|
from kivy.properties import OptionProperty, VariableListProperty
|
||
|
|
|
||
|
|
|
||
|
|
class AnchorLayout(Layout):
|
||
|
|
'''Anchor layout class. See the module documentation for more information.
|
||
|
|
'''
|
||
|
|
|
||
|
|
padding = VariableListProperty([0, 0, 0, 0])
|
||
|
|
'''Padding between the widget box and its children, in pixels:
|
||
|
|
[padding_left, padding_top, padding_right, padding_bottom].
|
||
|
|
|
||
|
|
padding also accepts a two argument form [padding_horizontal,
|
||
|
|
padding_vertical] and a one argument form [padding].
|
||
|
|
|
||
|
|
:attr:`padding` is a :class:`~kivy.properties.VariableListProperty` and
|
||
|
|
defaults to [0, 0, 0, 0].
|
||
|
|
'''
|
||
|
|
|
||
|
|
anchor_x = OptionProperty('center', options=(
|
||
|
|
'left', 'center', 'right'))
|
||
|
|
'''Horizontal anchor.
|
||
|
|
|
||
|
|
:attr:`anchor_x` is an :class:`~kivy.properties.OptionProperty` and
|
||
|
|
defaults to 'center'. It accepts values of 'left', 'center' or
|
||
|
|
'right'.
|
||
|
|
'''
|
||
|
|
|
||
|
|
anchor_y = OptionProperty('center', options=(
|
||
|
|
'top', 'center', 'bottom'))
|
||
|
|
'''Vertical anchor.
|
||
|
|
|
||
|
|
:attr:`anchor_y` is an :class:`~kivy.properties.OptionProperty` and
|
||
|
|
defaults to 'center'. It accepts values of 'top', 'center' or
|
||
|
|
'bottom'.
|
||
|
|
'''
|
||
|
|
|
||
|
|
def __init__(self, **kwargs):
|
||
|
|
super(AnchorLayout, self).__init__(**kwargs)
|
||
|
|
fbind = self.fbind
|
||
|
|
update = self._trigger_layout
|
||
|
|
fbind('children', update)
|
||
|
|
fbind('parent', update)
|
||
|
|
fbind('padding', update)
|
||
|
|
fbind('anchor_x', update)
|
||
|
|
fbind('anchor_y', update)
|
||
|
|
fbind('size', update)
|
||
|
|
fbind('pos', update)
|
||
|
|
|
||
|
|
def do_layout(self, *largs):
|
||
|
|
_x, _y = self.pos
|
||
|
|
width = self.width
|
||
|
|
height = self.height
|
||
|
|
anchor_x = self.anchor_x
|
||
|
|
anchor_y = self.anchor_y
|
||
|
|
pad_left, pad_top, pad_right, pad_bottom = self.padding
|
||
|
|
|
||
|
|
for c in self.children:
|
||
|
|
x, y = _x, _y
|
||
|
|
cw, ch = c.size
|
||
|
|
shw, shh = c.size_hint
|
||
|
|
shw_min, shh_min = c.size_hint_min
|
||
|
|
shw_max, shh_max = c.size_hint_max
|
||
|
|
|
||
|
|
if shw is not None:
|
||
|
|
cw = shw * (width - pad_left - pad_right)
|
||
|
|
if shw_min is not None and cw < shw_min:
|
||
|
|
cw = shw_min
|
||
|
|
elif shw_max is not None and cw > shw_max:
|
||
|
|
cw = shw_max
|
||
|
|
|
||
|
|
if shh is not None:
|
||
|
|
ch = shh * (height - pad_top - pad_bottom)
|
||
|
|
if shh_min is not None and ch < shh_min:
|
||
|
|
ch = shh_min
|
||
|
|
elif shh_max is not None and ch > shh_max:
|
||
|
|
ch = shh_max
|
||
|
|
|
||
|
|
if anchor_x == 'left':
|
||
|
|
x = x + pad_left
|
||
|
|
elif anchor_x == 'right':
|
||
|
|
x = x + width - (cw + pad_right)
|
||
|
|
else:
|
||
|
|
x = x + (width - pad_right + pad_left - cw) / 2
|
||
|
|
if anchor_y == 'bottom':
|
||
|
|
y = y + pad_bottom
|
||
|
|
elif anchor_y == 'top':
|
||
|
|
y = y + height - (ch + pad_top)
|
||
|
|
else:
|
||
|
|
y = y + (height - pad_top + pad_bottom - ch) / 2
|
||
|
|
|
||
|
|
c.pos = x, y
|
||
|
|
c.size = cw, ch
|