U P’“eS2ã@s@dZdZddlmZddlmZddlmZGdd„deƒZdS) aM Layout ====== Layouts are used to calculate and assign widget positions. The :class:`Layout` class itself cannot be used directly. You should use one of the following layout classes: - Anchor layout: :class:`kivy.uix.anchorlayout.AnchorLayout` - Box layout: :class:`kivy.uix.boxlayout.BoxLayout` - Float layout: :class:`kivy.uix.floatlayout.FloatLayout` - Grid layout: :class:`kivy.uix.gridlayout.GridLayout` - Page Layout: :class:`kivy.uix.pagelayout.PageLayout` - Relative layout: :class:`kivy.uix.relativelayout.RelativeLayout` - Scatter layout: :class:`kivy.uix.scatterlayout.ScatterLayout` - Stack layout: :class:`kivy.uix.stacklayout.StackLayout` Understanding the `size_hint` Property in `Widget` -------------------------------------------------- The :attr:`~kivy.uix.Widget.size_hint` is a tuple of values used by layouts to manage the sizes of their children. It indicates the size relative to the layout's size instead of an absolute size (in pixels/points/cm/etc). The format is:: widget.size_hint = (width_proportion, height_proportion) The proportions are specified as floating point numbers in the range 0-1. For example, 0.5 represents 50%, 1 represents 100%. If you want a widget's width to be half of the parent's width and the height to be identical to the parent's height, you would do:: widget.size_hint = (0.5, 1.0) If you don't want to use a size_hint for either the width or height, set the value to None. For example, to make a widget that is 250px wide and 30% of the parent's height, do:: widget.size_hint = (None, 0.3) widget.width = 250 Being :class:`Kivy properties `, these can also be set via constructor arguments:: widget = Widget(size_hint=(None, 0.3), width=250) .. versionchanged:: 1.4.1 The `reposition_child` internal method (made public by mistake) has been removed. )ÚLayouté)ÚClock)ÚWidget)ÚisclosecsLeZdZdZdZ‡fdd„Zdd„Z‡fdd„Z‡fd d „Zd d „Z ‡Z S) rzoLayout interface class, used to implement every layout. See module documentation for more information. Nc sB|jtkrtdƒ‚|jdkr,t |jd¡|_tt|ƒjf|ŽdS)NzIThe Layout class is abstract and cannot be used directly.éÿÿÿÿ) Ú __class__rÚ ExceptionÚ_trigger_layoutrZcreate_triggerÚ do_layoutÚsuperÚ__init__)ÚselfÚkwargs©r©ú3/tmp/pip-unpacked-wheel-xzebddm3/kivy/uix/layout.pyr Fs   zLayout.__init__cGs tdƒ‚dS)aÍThis function is called when a layout is called by a trigger. If you are writing a new Layout subclass, don't call this function directly but use :meth:`_trigger_layout` instead. The function is by default called *before* the next frame, therefore the layout isn't updated immediately. Anything depending on the positions of e.g. children should be scheduled for the next frame. .. versionadded:: 1.0.8 z"Must be implemented in subclasses.N)ÚNotImplementedError)r Úlargsrrrr Ns zLayout.do_layoutcsR|j}|d|jƒ|d|jƒ|d|jƒ|d|jƒtt|ƒj|f|ž|ŽdS©NÚsizeZ size_hintZ size_hint_maxZ size_hint_min)Úfbindr r rÚ add_widget)r ÚwidgetÚargsrrrrrr[s     zLayout.add_widgetcsR|j}|d|jƒ|d|jƒ|d|jƒ|d|jƒtt|ƒj|f|ž|ŽdSr)Úfunbindr r rÚ remove_widget)r rrrrrrrrcs     zLayout.remove_widgetc&sª|sdS|t|ƒ}||ks&t||ƒrntt||ƒƒD]4\}\} } | dkrJq4| dk r`| |||<q4d||<q4dSi} i} i} i}d}}|dd…}tt|||ƒƒD]\}\} } }| dkr¼q¢d}| dk r| |9} | | }|dkrô| ||<||7}nd| |<||| | |<nd| |<||| |<|dk rr||9}| |}|dkrX|||<||7}nd| |<|||||<nd| |<|||||<|| kr¢td|ƒ| |<|| kr¢td|ƒ| |<q¢||}t||ddrÖdS|dkrò| }|}d}|‰nx|dkrj|d9}| }| }d}td d „|Dƒƒ}td d „|Dƒƒ}||krP|rLd |ndn||‰‡fd d„|Dƒ‰tt‡fdd „|Dƒƒƒ‰ˆdkr |dksœt‚dS‡‡fdd„| ¡Dƒ‰t dd „|Dƒ‡fdd„d}|d}||}ˆ|}|||i}ˆ|}t |ƒ} d}d| kr(|d}ˆ|}!d}"|"sL|| krL|| kr||!kr||}|||7}|ˆ|7}||||<ˆ|}!|d7}q<|!}|"s,|||ˆ}#|#|!dkrÆ|| krÆq,d}"t | ¡ƒD]b\}$}%|#|%ˆ|$ˆdkrÖ||$=|||$8}|ˆ|$8}||%8}||$||%7<d}"qÖ|s”q,q”q,|r¦|r^|sbt‚|||ˆ}#|D].}||||#ˆ|ˆ||7<qvdS)a(internal) Computes the appropriate (size) hint for all the widgets given (potential) min or max bounds on the widgets' size. The ``hint`` list is updated with appropriate sizes. It walks through the hints and for any widgets whose hint will result in violating min or max constraints, it fixes the hint. Any remaining or missing space after all the widgets are fixed get distributed to the widgets making them smaller or larger according to their size hint. This algorithms knows nothing about the widgets other than what is passed through the input params, so it's fairly generic for laying things out according to constraints using size hints. :Parameters: `sh_sum`: float The sum of the size hints (basically ``sum(size_hint)``). `available_space`: float The amount of pixels available for all the widgets whose size hint is not None. Cannot be zero. `min_bounded_size`: float The minimum amount of space required according to the `size_hint_min` of the widgets (basically ``sum(size_hint_min)``). `sh_min_vals`: list or iterable Items in the iterable are the size_hint_min for each widget. Can be None. The length should be the same as ``hint`` `sh_max_vals`: list or iterable Items in the iterable are the size_hint_max for each widget. Can be None. The length should be the same as ``hint`` `hint`: list A list whose size is the same as the length of ``sh_min_vals`` and ``sh_min_vals`` whose each element is the corresponding size hint value of that element. This list is updated in place with correct size hints that ensure the constraints are not violated. :returns: Nothing. ``hint`` is updated in place. NgrgV瞯Ò<)Zabs_tolgð?gV瞯Ò¼gð¿css|]}|r|VqdS©Nr©Ú.0ÚhrrrÚ ùsz1Layout.layout_hint_with_bounds..css|]}|dk r|VqdSrrrrrrr úsg@cs g|]}|dkrdnˆ|‘qSrrr)Úhint_toprrÚ üsÿz2Layout.layout_hint_with_bounds..c3s|]}ˆ|VqdSrr©rÚi)Úcontrib_proportionrrr sg•Ö&è .>cs"i|]\}}||ˆ|ˆ“qSrr)rr$Úval)Úcontrib_prop_sumr%rrÚ sÿz2Layout.layout_hint_with_bounds..css|] }|VqdSrrr#rrrr scsˆ|Srr)Úx)Úcontrib_heightrrÚóz0Layout.layout_hint_with_bounds..)ÚkeyéFT) ÚfloatrÚ enumerateÚzipÚmaxÚminÚsumÚAssertionErrorÚitemsÚsortedÚlenÚlist)&r Zsh_sumZavailable_spaceZmin_bounded_sizeZ sh_min_valsZ sh_max_valsÚhintZ stretch_ratior$ÚshZsh_minZnot_mined_contribZnot_maxed_contribZ sh_mins_availZ sh_maxs_availZ oversize_amtZ undersize_amtZ hint_origZsh_maxZdiffÚmarginZ contrib_amtZ sh_availableZmultÚmnZmxr6ÚjZsum_i_contributedZ last_heightZsh_available_iZcontrib_prop_sum_iÚnZ curr_heightÚdoneZ margin_heightÚkZ available_shr)r*r'r%r!rÚlayout_hint_with_boundsks , ÿ   ÿ         $ ÿÿ  þ  þ      ÿ ÿÿ   ÿ ÿÿzLayout.layout_hint_with_bounds) Ú__name__Ú __module__Ú __qualname__Ú__doc__r r r rrrBÚ __classcell__rrrrr?s   rN) rFÚ__all__Z kivy.clockrZkivy.uix.widgetrZ kivy.compatrrrrrrÚs 7