U Pe 3@sdZdZddlmZddlmZmZmZddlm Z ddl m Z ddl m Z ddlmZd ZGd d d eZGd d d eZedkrddlmZddlmZddZddZeddddZejeedeedS)a Drop-Down List ============== .. image:: images/dropdown.gif :align: right .. versionadded:: 1.4.0 A versatile drop-down list that can be used with custom widgets. It allows you to display a list of widgets under a displayed widget. Unlike other toolkits, the list of widgets can contain any type of widget: simple buttons, images etc. The positioning of the drop-down list is fully automatic: we will always try to place the dropdown list in a way that the user can select an item in the list. Basic example ------------- A button with a dropdown list of 10 possible values. All the buttons within the dropdown list will trigger the dropdown :meth:`DropDown.select` method. After being called, the main button text will display the selection of the dropdown. :: from kivy.uix.dropdown import DropDown from kivy.uix.button import Button from kivy.base import runTouchApp # create a dropdown with 10 buttons dropdown = DropDown() for index in range(10): # When adding widgets, we need to specify the height manually # (disabling the size_hint_y) so the dropdown can calculate # the area it needs. btn = Button(text='Value %d' % index, size_hint_y=None, height=44) # for each button, attach a callback that will call the select() method # on the dropdown. We'll pass the text of the button as the data of the # selection. btn.bind(on_release=lambda btn: dropdown.select(btn.text)) # then add the button inside the dropdown dropdown.add_widget(btn) # create a big main button mainbutton = Button(text='Hello', size_hint=(None, None)) # show the dropdown menu when the main button is released # note: all the bind() calls pass the instance of the caller (here, the # mainbutton instance) as the first argument of the callback (here, # dropdown.open.). mainbutton.bind(on_release=dropdown.open) # one last thing, listen for the selection in the dropdown list and # assign the data to the button text. dropdown.bind(on_select=lambda instance, x: setattr(mainbutton, 'text', x)) runTouchApp(mainbutton) Extending dropdown in Kv ------------------------ You could create a dropdown directly from your kv:: #:kivy 1.4.0 : Button: text: 'My first Item' size_hint_y: None height: 44 on_release: root.select('item1') Label: text: 'Unselectable item' size_hint_y: None height: 44 Button: text: 'My second Item' size_hint_y: None height: 44 on_release: root.select('item2') And then, create the associated python class and use it:: class CustomDropDown(DropDown): pass dropdown = CustomDropDown() mainbutton = Button(text='Hello', size_hint=(None, None)) mainbutton.bind(on_release=dropdown.open) dropdown.bind(on_select=lambda instance, x: setattr(mainbutton, 'text', x)) )DropDown) ScrollView)ObjectPropertyNumericPropertyBooleanProperty)Window)Builder)Clock)ConfigzP GridLayout: size_hint_y: None height: self.minimum_size[1] cols: 1 c@seZdZdZdS)DropDownExceptionzDropDownException class. N)__name__ __module__ __qualname____doc__rr5/tmp/pip-unpacked-wheel-xzebddm3/kivy/uix/dropdown.pyr psr cseZdZdZedZedddZedZedZ edZ e ddZ e Z dZdZfddZd d Zd d Zd dZddZddZddZddZddZfddZfddZfddZfdd Zfd!d"Zfd#d$Zfd%d&Zd'd(Z Z!S))raDropDown class. See module documentation for more information. :Events: `on_select`: data Fired when a selection is done. The data of the selection is passed in as the first argument and is what you pass in the :meth:`select` method as the first argument. `on_dismiss`: .. versionadded:: 1.8.0 Fired when the DropDown is dismissed, either on selection or on touching outside the widget. TN)Z allownoner) on_select on_dismissc sd|_d|kr ttdd|_d|kr:tt}|_nd}d|krLd|_ d|krpd|krbd|_ d|krpd|_ t t |jf||dk rt t |||||tj|j|jd |d |jdS) Nmin_state_timeZgraphics container do_scroll_xF size_hint size_hint_x size_hint_y) on_key_downsizer)_winfloatr getrr load_string_grid_kvrrrrsuperr__init__ add_widget on_containerrbindr _repositionZfbind)selfkwargsc __class__rrr"s0  zDropDown.__init__cCs |dkr|r|dSdS)NT)get_parent_windowdismiss)r'instancekeyZscancode codepoint modifiersrrrrszDropDown.on_key_downcCs|dk r|jj|jddS)N)Z minimum_size)rr%r&)r'r/valuerrrr$szDropDown.on_containercCs^|jdk r|||_|jdkr.td||_|j|j|jd||j|dS)zOpen the dropdown list and attach it to a specific widget. Depending on the position of the widget within the window and the height of the dropdown, the dropdown might be above or below that widget. Nz.Cannot open a dropdown list on a hidden widgetposr) attach_tor.r-rr r%r&r#)r'widgetrrropens   z DropDown.opencGst|j|jdS)zcRemove the dropdown widget from the window and detach it from the attached widget. N)r Z schedule_once _real_dismissrr'largsrrrr.szDropDown.dismisscGs@|jr|j||jr2|jj|j|jdd|_|ddS)Nr4r)parent remove_widgetr6Zunbindr&dispatchr:rrrr9s  zDropDown._real_dismisscCsdSNr)r'rrrrszDropDown.on_dismisscCs|d||jr|dS)zCall this method to trigger the `on_select` event with the `data` selection. The `data` can be anything you want. rN)r>dismiss_on_selectr.r'datarrrselects zDropDown.selectcCsdSr?rrArrrrszDropDown.on_selectcs&|jr|jj||Stt|j||Sr?)rr#r!rr'argsr(r*rrr#szDropDown.add_widgetcs&|jr|jj||Stt|j||Sr?)rr=r!rrDr*rrr=!szDropDown.remove_widgetcs&|jr|jj||Stt|j||Sr?)r clear_widgetsr!rrDr*rrrF&szDropDown.clear_widgetscst||dSNT)r! on_motion)r'etypemer*rrrH+szDropDown.on_motioncs.|j|j|_|jr|jr*tt||dSrG)Z collide_pointr5_touch_started_inside auto_dismissr!r on_touch_downr'touchr*rrrM/s zDropDown.on_touch_downcs |jr |jrtt||dSrG)rLrKr!r on_touch_moverNr*rrrP5s zDropDown.on_touch_movecs4|jr|jdkr|ntt||d|_dS)NFT)rLrKr.r!r on_touch_uprNr*rrrQ:s  zDropDown.on_touch_upc Gs|j}|sdS|j}|r |s$dS|j|j\}}||j|j\}}|jrX|||_|}||j|jkrx|j|j}|dkrd}||_ |j dk rt |j |j j } n|j j } || } |j|| } | dkr||_| |_n@| dkr||_| |_n*| | kr||_|_n||_|j||_dS)Nr)rr6r-Z to_windowr5righttop auto_widthwidthx max_heightminrZminimum_heightheighty) r'r;winr7ZwxZwyZwrightZwtoprVrYZh_bottomZh_toprrrr&Cs>     zDropDown._reposition)"r r rrrrTrrWr@rLrrr6rrKZ __events__r"rr$r8r.r9rrCrr#r=rFrHrMrPrQr& __classcell__rrr*rrvs6           r__main__)Button) runTouchAppcsftjfdddtdD]4}td|ddd}|jfddd |q"dS) Ncs td|S)Ntext)setattr)r/rV)buttonrrzzshow_dropdown..)r zhello %d,)r`rrYcs |jSr?)rCr`)btn)dprrrc}rd) on_release)rr%ranger^r#r8)rbr;iitemr)rbrhr show_dropdownxs  rmcCs |j|_dSr?)r5center)r/rOrrr touch_movesroZSHOW)NN)i,)r`rr5)rirPN)r__all__Zkivy.uix.scrollviewrZkivy.propertiesrrrZkivy.core.windowrZ kivy.langrZ kivy.clockr Z kivy.configr r Exceptionr rr Zkivy.uix.buttonr^Z kivy.baser_rmrorgr%rrrrs(^