U Peڰ@sdZdZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m Z ddlmZmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlm Z ddl!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3Gddde,Z4Gddde Z5Gddde5Z6Gddde5Z7Gd d!d!e5Z8Gd"d#d#e5Z9Gd$d%d%e7Z:Gd&d'd'e5Z;Gd(d)d)e$ZGd.d/d/eZ?Gd0d1d1eZ@Gd2d3d3eZAGd4d5d5eAZBGd6d7d7eAZCGd8d9d9eAZDGd:d;d;eAZEGdd?d?e ZGGd@dAdAeZHGdBdCdCe ZIGdDdEdEe$ZJeKdFkrddGlLmMZMGdHdIdIeMZNeNOdS)Ja Settings ======== .. versionadded:: 1.0.7 This module provides a complete and extensible framework for adding a Settings interface to your application. By default, the interface uses a :class:`SettingsWithSpinner`, which consists of a :class:`~kivy.uix.spinner.Spinner` (top) to switch between individual settings panels (bottom). See :ref:`differentlayouts` for some alternatives. .. image:: images/settingswithspinner_kivy.jpg :align: center A :class:`SettingsPanel` represents a group of configurable options. The :attr:`SettingsPanel.title` property is used by :class:`Settings` when a panel is added: it determines the name of the sidebar button. SettingsPanel controls a :class:`~kivy.config.ConfigParser` instance. The panel can be automatically constructed from a JSON definition file: you describe the settings you want and corresponding sections/keys in the ConfigParser instance... and you're done! Settings are also integrated into the :class:`~kivy.app.App` class. Use :meth:`Settings.add_kivy_panel` to configure the Kivy core settings in a panel. .. _settings_json: Create a panel from JSON ------------------------ To create a panel from a JSON-file, you need two things: * a :class:`~kivy.config.ConfigParser` instance with default values * a JSON file .. warning:: The :class:`kivy.config.ConfigParser` is required. You cannot use the default ConfigParser from Python libraries. You must create and handle the :class:`~kivy.config.ConfigParser` object. SettingsPanel will read the values from the associated ConfigParser instance. Make sure you have set default values (using :attr:`~kivy.config.ConfigParser.setdefaults`) for all the sections/keys in your JSON file! The JSON file contains structured information to describe the available settings. Here is an example:: [ { "type": "title", "title": "Windows" }, { "type": "bool", "title": "Fullscreen", "desc": "Set the window in windowed or fullscreen", "section": "graphics", "key": "fullscreen" } ] Each element in the root list represents a setting that the user can configure. Only the "type" key is mandatory: an instance of the associated class will be created and used for the setting - other keys are assigned to corresponding properties of that class. ============== ================================================= Type Associated class -------------- ------------------------------------------------- title :class:`SettingTitle` bool :class:`SettingBoolean` numeric :class:`SettingNumeric` options :class:`SettingOptions` string :class:`SettingString` path :class:`SettingPath` color :class:`SettingColor` ============== ================================================= .. versionadded:: 1.1.0 Added :attr:`SettingPath` type .. versionadded:: 2.1.0 Added :attr:`SettingColor` type In the JSON example above, the first element is of type "title". It will create a new instance of :class:`SettingTitle` and apply the rest of the key-value pairs to the properties of that class, i.e. "title": "Windows" sets the :attr:`~SettingsPanel.title` property of the panel to "Windows". To load the JSON example to a :class:`Settings` instance, use the :meth:`Settings.add_json_panel` method. It will automatically instantiate a :class:`SettingsPanel` and add it to :class:`Settings`:: from kivy.config import ConfigParser config = ConfigParser() config.read('myconfig.ini') s = Settings() s.add_json_panel('My custom panel', config, 'settings_custom.json') s.add_json_panel('Another panel', config, 'settings_test2.json') # then use the s as a widget... .. _differentlayouts: Different panel layouts ----------------------- A kivy :class:`~kivy.app.App` can automatically create and display a :class:`Settings` instance. See the :attr:`~kivy.app.App.settings_cls` documentation for details on how to choose which settings class to display. Several pre-built settings widgets are available. All except :class:`SettingsWithNoMenu` include close buttons triggering the on_close event. - :class:`Settings`: Displays settings with a sidebar at the left to switch between json panels. - :class:`SettingsWithSidebar`: A trivial subclass of :class:`Settings`. - :class:`SettingsWithSpinner`: Displays settings with a spinner at the top, which can be used to switch between json panels. Uses :class:`InterfaceWithSpinner` as the :attr:`~Settings.interface_cls`. This is the default behavior from Kivy 1.8.0. - :class:`SettingsWithTabbedPanel`: Displays json panels as individual tabs in a :class:`~kivy.uix.tabbedpanel.TabbedPanel`. Uses :class:`InterfaceWithTabbedPanel` as the :attr:`~Settings.interface_cls`. - :class:`SettingsWithNoMenu`: Displays a single json panel, with no way to switch to other panels and no close button. This makes it impossible for the user to exit unless :meth:`~kivy.app.App.close_settings` is overridden with a different close trigger! Uses :class:`InterfaceWithNoMenu` as the :attr:`~Settings.interface_cls`. You can construct your own settings panels with any layout you choose by setting :attr:`Settings.interface_cls`. This should be a widget that displays a json settings panel with some way to switch between panels. An instance will be automatically created by :class:`Settings`. Interface widgets may be anything you like, but *must* have a method add_panel that receives newly created json settings panels for the interface to display. See the documentation for :class:`InterfaceWithSidebar` for more information. They may optionally dispatch an on_close event, for instance if a close button is clicked. This event is used by :class:`Settings` to trigger its own on_close event. For a complete, working example, please see :file:`kivy/examples/settings/main.py`. )Settings SettingsPanel SettingItem SettingString SettingPathSettingBooleanSettingNumericSettingOptions SettingTitleSettingsWithSidebarSettingsWithSpinnerSettingsWithTabbedPanelSettingsWithNoMenuInterfaceWithSidebar ContentPanel MenuSidebarN)Factory)dp) ConfigParser) Animation) string_types text_type)Window) BoxLayout)TabbedPanelHeader)Button)FileChooserListView) ColorPicker) ScrollView) FloatLayout) GridLayout)Label)Popup) TextInput) ToggleButton)Widget)ObjectPropertyStringProperty ListPropertyBooleanPropertyNumericProperty DictPropertyc@s eZdZdS) SettingSpacerN)__name__ __module__ __qualname__r0r05/tmp/pip-unpacked-wheel-xzebddm3/kivy/uix/settings.pyr,sr,cseZdZdZedZedddZedZedZ edZ e dZ e dZ e dZedZdZfd d Zfd d Zfd dZfddZddZddZZS)raBase class for individual settings (within a panel). This class cannot be used directly; it is used for implementing the other setting classes. It builds a row with a title/description (left) and a setting control (right). Look at :class:`SettingBoolean`, :class:`SettingNumeric` and :class:`SettingOptions` for usage examples. :Events: `on_release` Fired when the item is touched and then released. zNTZ allownoneFr on_releasec s*tt|jf||j|j|j|_dSN)superr__init__panel get_valuesectionkeyvalueselfkwargs __class__r0r1r7%szSettingItem.__init__cs*|jdkrtt|j||S|jj||Sr5)contentr6r add_widgetr>argsr?r@r0r1rC)s zSettingItem.add_widgetcs:|j|jsdS|jrdS||d|_tt||S)N) collide_pointposdisabledZgrabselected_alphar6r on_touch_downr>touchr@r0r1rK.s  zSettingItem.on_touch_downcsF|j|kr6|||dtdddd|dStt||S)Nr4rg?Zout_quad)rJdtT)Z grab_currentZungrabdispatchrstartr6r on_touch_uprLr@r0r1rR7s    zSettingItem.on_touch_upcCsdSr5r0r>r0r0r1r4?szSettingItem.on_releasecCs>|jr |jsdS|j}t|ts(t|}||j|j|dSr5)r:r;r8 isinstancerstr set_value)r>instancer<r8r0r0r1on_valueBs   zSettingItem.on_value)r-r.r/__doc__r'titledescr)rIr:r;r&r<r8rBr*rJ __events__r7rCrKrRr4rX __classcell__r0r0r@r1rs"      rc@seZdZdZeddgZdS)rzImplementation of a boolean setting on top of a :class:`SettingItem`. It is visualized with a :class:`~kivy.uix.switch.Switch` widget. By default, 0 and 1 are used for values: you can change them by setting :attr:`values`. 01N)r-r.r/rYr(valuesr0r0r0r1rLs rc@sDeZdZdZedddZedZddZddZd d Z d d Z dS) ra*Implementation of a string setting on top of a :class:`SettingItem`. It is visualized with a :class:`~kivy.uix.label.Label` widget that, when clicked, will open a :class:`~kivy.uix.popup.Popup` with a :class:`~kivy.uix.textinput.Textinput` so the user can enter a custom value. NTr2cCs|dkr dS|d|jdSNr4Zfbind _create_popupr>rWr<r0r0r1on_panelzszSettingString.on_panelcGs(|jrd|j_|jr|jd|_dSNF textinputZfocuspopupdismissr>largsr0r0r1_dismisss  zSettingString._dismisscCs||jj}||_dSr5)rmrhtextstripr<rdr0r0r1 _validates zSettingString._validatecCstddd}tdtjtd}t|j|d|dfd|_}t|j d d dd d |_ }|j |j d ||_ | t| || t| ttdddd}tdd}|j |j d| |tdd}|j |jd| || ||dS)Nvertical5dpZ orientationspacingffffff?NNZ250dp)rZrB size_hintsizeZ24spFZ42sp)rnZ font_size multiline size_hint_yheight)Zon_text_validate50dpr{r|rtOkrnr3Cancel)rminrwidthrr"rZrir#r<rhbindrprCr%r,rrmopen)r>rWrB popup_widthrirh btnlayoutbtnr0r0r1rcs<            zSettingString._create_popup) r-r.r/rYr&rirhrermrprcr0r0r0r1rcs rc@sTeZdZdZedddZedZedZedZ ddZ dd Z d d Z d d Z dS)raQImplementation of a Path setting on top of a :class:`SettingItem`. It is visualized with a :class:`~kivy.uix.label.Label` widget that, when clicked, will open a :class:`~kivy.uix.popup.Popup` with a :class:`~kivy.uix.filechooser.FileChooserListView` so the user can enter a custom value. .. versionadded:: 1.1.0 NTr2FcCs|dkr dS|d|jdSrarbrdr0r0r1reszSettingPath.on_panelcGs(|jrd|j_|jr|jd|_dSrfrgrkr0r0r1rms  zSettingPath._dismisscCs.||jj}|sdStj|d|_dS)Nr)rmrhZ selectionospathrealpathr<rdr0r0r1rps zSettingPath._validatec Cstddd}tdtjtd}t|j|d|d|_}|jpDt }t |d|j |j d |_}|j|jd |||ttdd d d }tdd}|j|jd||tdd}|j|jd|||||dS)NrqrsrurvNg?rZrBrxr)rFrF)rrx dirselect show_hidden)Zon_pathr}rrr~rrr3r)rrrrrr"rZrir<rgetcwdrrrrhrrprCr,rrmr) r>rWrBrriZ initial_pathrhrrr0r0r1rcs6          zSettingPath._create_popup)r-r.r/rYr&rirhr)rrrermrprcr0r0r0r1rs    rc@s<eZdZdZedddZddZddZd d Zd d Z dS) SettingColoracImplementation of a color setting on top of a :class:`SettingItem`. It is visualized with a :class:`~kivy.uix.label.Label` widget and a colored canvas rectangle that, when clicked, will open a :class:`~kivy.uix.popup.Popup` with a :class:`~kivy.uix.colorpicker.ColorPicker` so the user can choose a color. .. versionadded:: 2.0.1 NTr2cCs|dkr dS|j|jddS)Nr3)rrcrdr0r0r1re!szSettingColor.on_panelcGs|jr|jd|_dSr5)rirjrkr0r0r1rm&s zSettingColor._dismisscCs |t|jj}||_dSr5)rmutilsZget_hex_from_color colorpickercolorr<rdr0r0r1rp+szSettingColor._validatecCstddd}tdtjtd}t|j|d|d|_}tt |j d|_ }|j |jd ||_ |||ttdd dd }td d }|j |jd||tdd }|j |jd|||||dS)Nrqrrrsrurvrr)r)Zon_colorr}r~rrr3r)rrrrrr"rZrirrZget_color_from_hexr<rrrprCr,rrmr)r>rWrBrrirrrr0r0r1rc0s.         zSettingColor._create_popup) r-r.r/rYr&rirermrprcr0r0r0r1rs  rc@seZdZdZddZdS)ra-Implementation of a numeric setting on top of a :class:`SettingString`. It is visualized with a :class:`~kivy.uix.label.Label` widget that, when clicked, will open a :class:`~kivy.uix.popup.Popup` with a :class:`~kivy.uix.textinput.Textinput` so the user can enter a custom value. cCs`dt|jk}|z.|r0tt|jj|_ntt|jj|_Wntk rZYdSXdS)N.) rUr<rmrfloatrhrnint ValueError)r>rWZis_floatr0r0r1rpVszSettingNumeric._validateN)r-r.r/rYrpr0r0r0r1rNsrc@s<eZdZdZegZedddZddZddZ d d Z dS) raImplementation of an option list on top of a :class:`SettingItem`. It is visualized with a :class:`~kivy.uix.label.Label` widget that, when clicked, will open a :class:`~kivy.uix.popup.Popup` with a list of options from which the user can select. NTr2cCs|dkr dS|d|jdSrarbrdr0r0r1rezszSettingOptions.on_panelcCs|j|_|jdSr5)rnr<rirj)r>rWr0r0r1 _set_optionszSettingOptions._set_optionc Cstddd}tdtjtd}t||jd|dfd|_}t|j td td |_ | t dd d t |j}|j D]<}||jkrd nd}t|||d}|j|jd| |qz| ttddtdd}|j|jd| ||dS)NrqrrrsrurvrwZ400dp)rBrZrxry7rF)r{r|Zdownnormal)rnstategroupr3r2)rnr{r|)rrrrrr"rZrilenoptionsr|rCr%rUuidr<r$rrr,rrjr) r>rWrBrriroptionrrr0r0r1rcs*       zSettingOptions._create_popup) r-r.r/rYr(rr&rirerrcr0r0r0r1rds  rc@seZdZdZejZedZdS)r zEA simple title label, used to organize the settings in sections. N) r-r.r/rYr!rnrZr&r8r0r0r0r1r sr csTeZdZdZedZedddZedZfddZ dd Z d d Z d d Z Z S)rzoThis class is used to construct panel settings, for use with a :class:`Settings` instance or subclass. z Default titleNTr2c s"|ddtt|jf|dS)NcolsrF) setdefaultr6rr7r=r@r0r1r7s zSettingsPanel.__init__cCs"|dkr dSt|tstddS)NzPInvalid config object, you must use akivy.config.ConfigParser, not another one !)rTr Exceptionrdr0r0r1 on_configs zSettingsPanel.on_configcCs|j}|sdS|||S)a0Return the value of the section/key from the :attr:`config` ConfigParser instance. This function is used by :class:`SettingItem` to get the value for a given section/key. If you don't want to use a ConfigParser instance, you might want to override this function. N)configget)r>r:r;rr0r0r1r9szSettingsPanel.get_valuecCsX|||}||krdS|j}|r8||||||j}|rT|d||||dS)Non_config_change)r9rsetwritesettingsrP)r>r:r;r<currentrrr0r0r1rVs zSettingsPanel.set_value)r-r.r/rYr'rZr&rrr7rr9rVr]r0r0r@r1rs   rcs@eZdZdZeZeZdZfddZddZ ddZ Z S) raxThe default Settings interface class. It displays a sidebar menu with names of available settings panels, which may be used to switch which one is currently displayed. See :meth:`~InterfaceWithSidebar.add_panel` for information on the method you must implement if creating your own interface. This class also dispatches an event 'on_close', which is triggered when the sidebar menu's close button is released. If creating your own interface widget, it should also dispatch such an event which will automatically be caught by :class:`Settings` and used to trigger its own 'on_close' event. on_closecs.ttj||jjjfddddS)Ncs dSNrrPjrSr0r1z/InterfaceWithSidebar.__init__..r3)r6rr7menu close_buttonrrDr@rSr1r7s zInterfaceWithSidebar.__init__cCs"|j|||j|||dS)aThis method is used by Settings to add new panels for possible display. Any replacement for ContentPanel *must* implement this method. :Parameters: `panel`: :class:`SettingsPanel` It should be stored and the interface should provide a way to switch between panels. `name`: The name of the panel as a string. It may be used to represent the panel but isn't necessarily unique. `uid`: A unique int identifying the panel. It should be used to identify and switch between panels. N)radd_itemrB add_panelr>r8namerr0r0r1r szInterfaceWithSidebar.add_panelcGsdSr5r0r>rEr0r0r1rszInterfaceWithSidebar.on_close) r-r.r/rYr&rrBr\r7rrr]r0r0r@r1rs  rcs@eZdZdZdZeZeZfddZddZ ddZ Z S) InterfaceWithSpinneraA settings interface that displays a spinner at the top for switching between panels. The workings of this class are considered internal and are not documented. See :meth:`InterfaceWithSidebar` for information on implementing your own interface class. rcs.ttj||jjjfddddS)Ncs dSrrrrSr0r1r@rz/InterfaceWithSpinner.__init__..r3)r6rr7rrrrDr@rSr1r7=s zInterfaceWithSpinner.__init__cCs"|j||||j||dS)a{This method is used by Settings to add new panels for possible display. Any replacement for ContentPanel *must* implement this method. :Parameters: `panel`: :class:`SettingsPanel` It should be stored and the interface should provide a way to switch between panels. `name`: The name of the panel as a string. It may be used to represent the panel but may not be unique. `uid`: A unique int identifying the panel. It should be used to identify and switch between panels. N)rBrrrrr0r0r1rBszInterfaceWithSpinner.add_panelcGsdSr5r0rr0r0r1rVszInterfaceWithSpinner.on_close) r-r.r/rYr\r&rrBr7rrr]r0r0r@r1r!s  rcsVeZdZdZeiZeZedZe dZ ddZ ddZ fdd Z d d ZZS) raA class for displaying settings panels. It displays a single settings panel at a time, taking up the full size and shape of the ContentPanel. It is used by :class:`InterfaceWithSidebar` and :class:`InterfaceWithSpinner` to display settings. NrcCs||j|<|js||_dS)a9This method is used by Settings to add new panels for possible display. Any replacement for ContentPanel *must* implement this method. :Parameters: `panel`: :class:`SettingsPanel` It should be stored and displayed when requested. `name`: The name of the panel as a string. It may be used to represent the panel. `uid`: A unique int identifying the panel. It should be stored and used to identify panels when switching. N)panels current_uidrr0r0r1rs zContentPanel.add_panelcGsH|j}||jkrD|jdk r&||j|j|}||||_dSdS)aPThe uid of the currently displayed panel. Changing this will automatically change the displayed panel. :Parameters: `uid`: A panel uid. It should be used to retrieve and display a settings panel that has previously been added with :meth:`add_panel`. NTF)rr current_panel remove_widgetrC)r>rErZ new_panelr0r0r1on_current_uids      zContentPanel.on_current_uidcs0|jdkrtt|j||n|jj||dSr5) containerr6rrCrDr@r0r1rCs zContentPanel.add_widgetcOs|jj||dSr5)rrrDr0r0r1rszContentPanel.remove_widget)r-r.r/rYr+rr&rrr*rrrrCrr]r0r0r@r1rZs  rcs|eZdZdZedZeeZdZfddZ fddZ dd Z d d Z d d Z ddZdddZdddZddZZS)raSettings UI. Check module documentation for more information on how to use this class. :Events: `on_config_change`: ConfigParser instance, section, key, value Fired when the section's key-value pair of a ConfigParser changes. .. warning: value will be str/unicode type, regardless of the setting type (numeric, boolean, etc) `on_close` Fired by the default panel when the Close button is pressed. N)rrcsxi|_tt|j||||dt|dt|dt|dt |dt |dt |dt dS)NstringboolnumericrrZrr) _typesr6rr7 add_interface register_typerrrrr rr)r>rEZkargsr@r0r1r7s      zSettings.__init__cs$|j|jr tt||dSdSNT)rGrHr6rrKrLr@r0r1rKs zSettings.on_touch_downcCs||j|<dS)zERegister a new type that can be used in the JSON definition. N)r)r>tpclsr0r0r1rszSettings.register_typecGsdSr5r0rr0r0r1rszSettings.on_closecsJj}t|trt|}|}|_|jjfddddS)z(Internal) creates an instance of :attr:`Settings.interface_cls`, and sets it to :attr:`~Settings.interface`. When json panels are created, they will be added to this interface which will display them to the user. cs dSrrrrSr0r1rrz(Settings.add_interface..rN) interface_clsrTrrr interfacerCr)r>rrr0rSr1rs   zSettings.add_interfacecCsdSr5r0)r>rr:r;r<r0r0r1r szSettings.on_config_changecCs4|||||}|j}|jdk r0|j|||dS)a|Create and add a new :class:`SettingsPanel` using the configuration `config` with the JSON definition `filename`. If `filename` is not set, then the JSON definition is read from the `data` parameter instead. Check the :ref:`settings_json` section in the documentation for more information about JSON format and the usage of this function. N)create_json_panelrrr)r>rZrfilenamedatar8rr0r0r1add_json_panel s zSettings.add_json_panelc Cs|dkr|dkrtd|dk rFt|d}t|}W5QRXn t|}t|tkrdtdt|||d}|D]}d|krtd|d}|j |} | dkrtd|d|d=i} | D]\} } | | t | <q| fd |i| } | | qv|S) zCreate new :class:`SettingsPanel`. .. versionadded:: 1.5.0 Check the documentation of :meth:`add_json_panel` for more information. Nz,You must specify either the filename or datarz The first element must be a list)rZrrtypez*One setting are missing the "type" elementz+No class registered to handle the <%s> typer8)rrjsonloadsreadrlistrrrritemsrUrC)r>rZrrrfdr8ZsettingttyperZ str_settingsr;itemrWr0r0r1rs6     zSettings.create_json_panelcCs<ddlm}ddlm}ddlm}|d|||ddS)a&Add a panel for configuring Kivy. This panel acts directly on the kivy configuration. Feel free to include or exclude it in your configuration. See :meth:`~kivy.app.App.use_kivy_settings` for information on enabling/disabling the automatic kivy panel. r) kivy_data_dir)Config)joinZKivyzsettings_kivy.jsonN)Zkivyr kivy.configros.pathrr)r>rrrr0r0r1add_kivy_panelCs   zSettings.add_kivy_panel)NN)NN)r-r.r/rYr&rrrr\r7rKrrrrrrrr]r0r0r@r1rs   *rc@seZdZdZdS)r zA settings widget that displays settings panels with a sidebar to switch between them. This is the default behaviour of :class:`Settings`, and this widget is a trivial wrapper subclass. N)r-r.r/rYr0r0r0r1r Ssr cs eZdZdZfddZZS)r zxA settings widget that displays one settings panel at a time with a spinner at the top to switch between them. cst|_tt|j||dSr5)rrr6r r7rDr@r0r1r7`szSettingsWithSpinner.__init__r-r.r/rYr7r]r0r0r@r1r [sr cs,eZdZdZdZfddZddZZS)r zrA settings widget that displays settings panels as pages in a :class:`~kivy.uix.tabbedpanel.TabbedPanel`. rcst|_tt|j||dSr5)InterfaceWithTabbedPanelrr6r r7rDr@r0r1r7lsz SettingsWithTabbedPanel.__init__cGsdSr5r0rr0r0r1rpsz SettingsWithTabbedPanel.on_close)r-r.r/rYr\r7rr]r0r0r@r1r es r cs eZdZdZfddZZS)r a A settings widget that displays a single settings panel with *no* Close button. It will not accept more than one Settings panel. It is intended for use in programs with few enough settings that a full panel switcher is not useful. .. warning:: This Settings panel does *not* provide a Close button, and so it is impossible to leave the settings screen unless you also add other behaviour or override :meth:`~kivy.app.App.display_settings` and :meth:`~kivy.app.App.close_settings`. cst|_tt|j||dSr5)InterfaceWithNoMenurr6r r7rDr@r0r1r7szSettingsWithNoMenu.__init__rr0r0r@r1r tsr cs eZdZdZfddZZS)ra The interface widget used by :class:`SettingsWithNoMenu`. It stores and displays a single settings panel. This widget is considered internal and is not documented. See the :class:`ContentPanel` for information on defining your own content widget. cs8|jdk r"t|jjdkr"tdtt|j||dS)Nrz8ContentNoMenu cannot accept more than one settings panel)rrchildrenrr6rrCrDr@r0r1rCs zInterfaceWithNoMenu.add_widget)r-r.r/rYrCr]r0r0r@r1rsrcs@eZdZdZeZeZdZfddZddZ ddZ Z S) ra'The content widget used by :class:`SettingsWithTabbedPanel`. It stores and displays Settings panels in tabs of a TabbedPanel. This widget is considered internal and is not documented. See :class:`InterfaceWithSidebar` for information on defining your own interface widget. rcs,ttj||jjfddddS)Ncs dSrrrrSr0r1rrz3InterfaceWithTabbedPanel.__init__..r3)r6rr7rrrDr@rSr1r7sz!InterfaceWithTabbedPanel.__init__cCsFt}|||jjs*||j_||j_nt||d}|j|dS)N)rnrB)rrC tabbedpanelZdefault_tab_contentZdefault_tab_textr)r>r8rrZ scrollviewZ panelitemr0r0r1rs   z"InterfaceWithTabbedPanel.add_panelcGsdSr5r0rr0r0r1rsz!InterfaceWithTabbedPanel.on_close) r-r.r/rYr&rrr\r7rrr]r0r0r@r1rs  rc@sJeZdZdZedZedZeZe iZ e Z eZddZ ddZdS) MenuSpinneraThe menu class used by :class:`SettingsWithSpinner`. It provides a sidebar with an entry for each settings panel. This widget is considered internal and is not documented. See :class:`MenuSidebar` for information on menus and creating your own menu class. rcCsj|jj}||kr>d}|d||kr0|d7}q|d|}||j|<|jj||jjsf||j_dS)Nz {}rF)spinnerr`format panel_namesappendrn)r>rrr`ir0r0r1rs  zMenuSpinner.add_itemcGs|j}|j||_dSr5) spinner_textr selected_uid)r>rErnr0r0r1on_spinner_textszMenuSpinner.on_spinner_textN)r-r.r/rYr*rr&rrr+rr'rrrr0r0r0r1rs rc@s8eZdZdZedZedZedZddZ ddZ dS)rzThe menu used by :class:`InterfaceWithSidebar`. It provides a sidebar with an entry for each settings panel, which the user may click to select. rNcCs>t|||d}t|jjdkr$d|_|jdk r:|j|dS)aThis method is used to add new panels to the menu. :Parameters: `name`: The name (a string) of the panel. It should be used to represent the panel in the menu. `uid`: The name (an int) of the panel. It should be used internally to represent the panel and used to set self.selected_uid when the panel is changed. )rnrrrTN)SettingSidebarLabelrbuttons_layoutrselectedrC)r>rrlabelr0r0r1rs  zMenuSidebar.add_itemcGs$|jjD]}|j|jkrd|_qdS)zt(internal) unselects any currently selected menu buttons, unless they represent the current panel. FN)rrrrr)r>rEbuttonr0r0r1on_selected_uids  zMenuSidebar.on_selected_uid) r-r.r/rYr*rr&rrrrr0r0r0r1rs   rc@s,eZdZedZedZedZddZ dS)rFrNcCs$|j|jsdSd|_|j|j_dSr)rGrHrrrrrLr0r0r1rKs z!SettingSidebarLabel.on_touch_down) r-r.r/r)rr*rr&rrKr0r0r0r1rsr__main__)Appc@s4eZdZeddddddgZddZd d Zd S) SettingsApprz Test colorzYour chosen Colorcolorselection testcolor)rrZr[r:r;cCs4t}||jd|j|jd|j|jd|S)NzColor settings)rr)rrrrdemo_json_settingsrstop)r>sr0r0r1build3szSettingsApp.buildcCs|dddidS)Nrrz#FF0000)Z setdefaults)r>rr0r0r1 build_config<szSettingsApp.build_configN)r-r.r/rdumpsrrrr0r0r0r1r)s  r)PrY__all__rrZ kivy.utilsrZ kivy.factoryrZ kivy.metricsrrrZkivy.animationrZ kivy.compatrrZkivy.core.windowrZkivy.uix.boxlayoutrZkivy.uix.tabbedpanelrZkivy.uix.buttonrZkivy.uix.filechooserrZkivy.uix.colorpickerrZkivy.uix.scrollviewrZkivy.uix.floatlayoutrZkivy.uix.gridlayoutr Zkivy.uix.labelr!Zkivy.uix.popupr"Zkivy.uix.textinputr#Zkivy.uix.togglebuttonr$Zkivy.uix.widgetr%Zkivy.propertiesr&r'r(r)r*r+r,rrrrrrrr rrrrrr r r r rrrrrr-Zkivy.apprrrunr0r0r0r1sl'                    Kb>; :?9\  !@