U Pe1$@s|dZddlmZddlmZddlmZmZddlm Z ddl m Z m Z Gddde ZGd d d e ZGd d d eZd S)a4 RecycleView Layouts =================== .. versionadded:: 1.10.0 The Layouts handle the presentation of views for the :class:`~kivy.uix.recycleview.RecycleView`. .. warning:: This module is highly experimental, its API may change in the future and the documentation is not complete at this time. ) string_types)Factory)StringPropertyObjectProperty)CompoundSelectionBehavior)RecycleDataViewBehavior_view_base_cachec@s eZdZdS)LayoutChangeExceptionN)__name__ __module__ __qualname__r r ?/tmp/pip-unpacked-wheel-xzebddm3/kivy/uix/recycleview/layout.pyr sr cseZdZdZedddZgZiZfddZfddZ d d Z d d Z fd dZ fddZ fddZddZfddZZS)LayoutSelectionBehavioraThe :class:`LayoutSelectionBehavior` can be combined with :class:`RecycleLayoutManagerBehavior` to allow its derived classes selection behaviors similarly to how :class:`~kivy.uix.behaviors.compoundselection.CompoundSelectionBehavior` can be used to add selection behaviors to normal layout. :class:`RecycleLayoutManagerBehavior` manages its children differently than normal layouts or widgets so this class adapts :class:`~kivy.uix.behaviors.compoundselection.CompoundSelectionBehavior` based selection to work with :class:`RecycleLayoutManagerBehavior` as well. Similarly to :class:`~kivy.uix.behaviors.compoundselection.CompoundSelectionBehavior`, one can select using the keyboard or touch, which calls :meth:`select_node` or :meth:`deselect_node`, or one can call these methods directly. When a item is selected or deselected :meth:`apply_selection` is called. See :meth:`apply_selection`. NTZ allownonec sd|_tt|jf|dSNF)Znodes_order_reversedsuperr__init__)selfkwargs __class__r rrBsz LayoutSelectionBehavior.__init__cs\|jdkrg}|_nfddt|D}|_ddt|D|_tt|||S)Ncsg|]\}}|r|qSr )get).0idkeyr r Ms zCLayoutSelectionBehavior.compute_sizes_from_data..cSsi|]\}}||qSr r )rkvr r r PszCLayoutSelectionBehavior.compute_sizes_from_data..) key_selection_selectable_nodes enumerate _nodes_maprrcompute_sizes_from_data)rdataflagsZnodesrrrr&Fs    z/LayoutSelectionBehavior.compute_sizes_from_datacCs|jSN)r#)rr r rget_selectable_nodesTsz,LayoutSelectionBehavior.get_selectable_nodescCs |j|Sr))r%)rnodeZselectable_nodesr r rget_index_of_nodeXsz)LayoutSelectionBehavior.get_index_of_nodecs2tt||||\}}||k r*||||fSr))rr goto_node goto_view)rrZ last_nodeZ last_node_idxr+idxrr rr-\s  z!LayoutSelectionBehavior.goto_nodecs8tt||r4|jj|}|dk r4|||ddS)NT)rr select_node recycleview view_adapterget_visible_viewapply_selectionrr+viewrr rr0csz#LayoutSelectionBehavior.select_nodecs8tt||r4|jj|}|dk r4|||ddSr)rr deselect_noder1r2r3r4r5rr rr7isz%LayoutSelectionBehavior.deselect_nodecCs8|j}|tkrt|tt|<t|r4||j||dS)aoApplies the selection to the view. This is called internally when a view is displayed and it needs to be shown as selected or as not selected. It is called when :meth:`select_node` or :meth:`deselect_node` is called or when a view needs to be refreshed. Its function is purely to update the view to reflect the selection state. So the function may be called multiple times even if the selection state may not have changed. If the view is a instance of :class:`~kivy.uix.recycleview.views.RecycleDataViewBehavior`, its :meth:`~kivy.uix.recycleview.views.RecycleDataViewBehavior.apply_selection` method will be called every time the view needs to refresh the selection state. Otherwise, the this method is responsible for applying the selection. :Parameters: `index`: int The index of the data item that is associated with the view. `view`: widget The widget that is the view of this data item. `is_selected`: bool Whether the item is selected. N)rr isinstancerr4r1)rindexr6Z is_selected viewclassr r rr4osz'LayoutSelectionBehavior.apply_selectioncs.tt||||||||||jkdSr))rrrefresh_view_layoutr4Zselected_nodesrr9Zlayoutr6viewportrr rr;s z+LayoutSelectionBehavior.refresh_view_layout)r r r __doc__rr"r#r%rr&r*r,r-r0r7r4r; __classcell__r r rrrs      "rc@seZdZdZedZedZedddZdZ ddZ ddZ d d Z d d Z d dZddZddZddZddZddZddZddZddZdS)RecycleLayoutManagerBehaviora A RecycleLayoutManagerBehavior is responsible for positioning views into the :attr:`RecycleView.data` within a :class:`RecycleView`. It adds new views into the data when it becomes visible to the user, and removes them when they leave the visible area. NTrcCsH||_|rD|j}|d|j|d|j|d|jd|d|jddSNr: key_viewclass)r1fbindrefresh_from_data_dispatch_prop_on_source)rrvrCr r rattach_recycleviews  z/RecycleLayoutManagerBehavior.attach_recycleviewcCsV||j}|rL|j}|d|j|d|j|d|jd|d|jdd|_dSrA) clear_layoutr1funbindrDrE)rrFrIr r rdetach_recycleviews  z/RecycleLayoutManagerBehavior.detach_recycleviewcCsdSr)r rr'r(r r rr&sz4RecycleLayoutManagerBehavior.compute_sizes_from_datacCsdSr)r rKr r rcompute_layoutsz+RecycleLayoutManagerBehavior.compute_layoutcCsdSz<`viewport` is in coordinates of the layout manager. Nr )rr'r=r r rcompute_visible_viewssz2RecycleLayoutManagerBehavior.compute_visible_viewscCsdSrMr )rindicesr'r=r r rset_visible_viewssz.RecycleLayoutManagerBehavior.set_visible_viewscCs|jj||||dS)zY`See :meth:`~kivy.uix.recycleview.views.RecycleDataAdapter.refresh_view_layout`. N)r1r2r;r<r r rr;s z0RecycleLayoutManagerBehavior.refresh_view_layoutcCsdS)zyReturn the view `index` on which position, `pos`, falls. `pos` is in coordinates of the layout manager. Nr )rposr r rget_view_index_atsz.RecycleLayoutManagerBehavior.get_view_index_atcCs |j}|r|j}|r|dSr))r1r2Zmake_views_dirtyrrFadapterr r r remove_viewss z)RecycleLayoutManagerBehavior.remove_viewscCs$|j}|r |j}|r |||dSr))r1r2Zmake_view_dirty)rr6r9rFrTr r r remove_views z(RecycleLayoutManagerBehavior.remove_viewcCs |j}|r|j}|r|dSr))r1r2Z invalidaterSr r rrHs z)RecycleLayoutManagerBehavior.clear_layoutcCsdS)zVMoves the views so that the view corresponding to `index` is visible. Nr )rr9r r rr.sz&RecycleLayoutManagerBehavior.goto_viewcCst|trtt||_dSr))r8rgetattrrr:)rinstancevaluer r r on_viewclasss z)RecycleLayoutManagerBehavior.on_viewclass)r r r r>rr:rrBr1Z asked_sizesrGrJr&rLrNrPr;rRrUrVrHr.rZr r r rr@s$   r@N)r>Z kivy.compatrZ kivy.factoryrZkivy.propertiesrrZkivy.uix.behaviorsrZkivy.uix.recycleview.viewsrr Exceptionr robjectr@r r r rs   }