ó X–Tc@s]dZddlZddlZddlZdefd„ƒYZdejfd„ƒYZdS(sPThis module defines the Form class, a subclass of Views that can manage widgets.iÿÿÿÿNt_FormFieldMetacBseZdZd„ZRS(s÷ Black magic for wrapping widgets defined as class attributes. See python documentation on overriding Python `__metaclass__ `_ for more information. cCsItj||||ƒ}d„}ttj||ƒdd„ƒ|_|S(NcSst|tjjƒS(N(t isinstancetspyraltwidgetst_WidgetWrapper(tobj((s//usr/lib/python2.7/site-packages/spyral/form.pytstkeycSs |djS(Ni(tcreation_counter(ti((s//usr/lib/python2.7/site-packages/spyral/form.pyRs(ttypet__new__tsortedtinspectt getmemberstfields(tmetatnametbasestdicttclst is_wrapper((s//usr/lib/python2.7/site-packages/spyral/form.pyR s  (t__name__t __module__t__doc__R (((s//usr/lib/python2.7/site-packages/spyral/form.pyRstFormcBsªeZdZeZd„Zd„Zd„Zd„Zd„Z d„Z d„Z dd„Z d „ZeeƒZd „Zdd „Zd „Zed „Zed„ZRS(sÎ Forms are a subclass of :class:`Views ` that hold a set of :ref:`Widgets `. Forms will manage focus and event delegation between the widgets, ensuring that only one widget is active at a given time. Forms are defined using a special class-based syntax:: class MyForm(spyral.Form): name = spyral.widgets.TextInput(100, "Current Name") remember_me = spyral.widgets.Checkbox() save = spyral.widgets.ToggleButton("Save") my_form = MyForm() When referencing widgets in this way, the "Widget" part of the widget's name is dropped: ``spyral.widgets.ButtonWidget`` becomes ``spyral.widgets.Button``. Every widget in a form is accessible as an attribute of the form: >>> print my_form.remember_me.value "up" :param scene: The Scene or View that this Form belongs to. :type scene: :class:`Scene ` or :class:`View `. cCs“tjj||ƒdtfd„ƒY}g|_i|_d|_d|_d|_ tj j d|j d|ƒtj j d|j d|ƒtj j d|jd|ƒtj j d|jd|ƒtj j d|jd|ƒtj j d |jd|ƒtj j d |jd|ƒ|j}|ƒ|_xS|D]K\}}|||ƒ}t|d |ƒt|||ƒ|j||ƒq6W|jƒdS( NtFieldscBseZRS((RR(((s//usr/lib/python2.7/site-packages/spyral/form.pyR2ssinput.mouse.up.lefttscenesinput.mouse.down.leftsinput.mouse.motionsinput.keyboard.down.tabsinput.keyboard.up.tabsinput.keyboard.upsinput.keyboard.downR(RtViewt__init__tobjectt_widgetst _tab_orderstNonet_current_focust_mouse_currently_overt_mouse_down_onteventtregistert_handle_mouse_upt_handle_mouse_downt_handle_mouse_motiont _handle_tabt_handle_key_upt_handle_key_downRtsetattrt add_widgettfocus(tselfRRRRtwidgettw((s//usr/lib/python2.7/site-packages/spyral/form.pyR0s:       cCs0|jdkrtS|jj|ƒd|_dS(sÏ Delegate the mouse being released to the widget that is currently being clicked. :param event: The associated event data. :type event: :class:`Event ` N(R$R!tFalseR'(R0R%((s//usr/lib/python2.7/site-packages/spyral/form.pyR'XscCsQxJ|jD]?}|j|jƒr |j|ƒ||_|j|ƒtSq WtS(sÖ Delegate the mouse being clicked down to any widget that it is currently hovering over. :param event: The associated event data. :type event: :class:`Event ` (Rt collide_pointtposR/R$R(tTrueR3(R0R%R1((s//usr/lib/python2.7/site-packages/spyral/form.pyR(es   cCsÁ|jdk r"|jj|ƒnd}x9|jD].}|j|jƒr2|j|ƒ|}q2q2W||jkr½|jdk r•|jj|ƒn||_|dk r½|j|ƒq½ndS(s– Delegate the mouse being hovered over any widget that it is currently hovering over. If the widget being hovered over is no longer the previous widget that was being hovered over, it notifies the old widget (mouse out event) and the new widget (mouse over event). :param event: The associated event data. :type event: :class:`Event ` N( R$R!R)RR4R5R#t_handle_mouse_outt_handle_mouse_over(R0R%t now_hoverR1((s//usr/lib/python2.7/site-packages/spyral/form.pyR)us     cCsU|jdkrdS|jdkr&tS|jtjj@rG|jƒtS|j ƒtS(s If this form has focus, advances to the next widget in the tab order. Unless the shift key is held, in which case the previous widget is focused. :param event: The associated event data. :type event: :class:`Event ` Ntdown( R"R!R R6tmodRtmodstshifttprevioustnext(R0R%((s//usr/lib/python2.7/site-packages/spyral/form.pyR*s   cCs&|jdk r"|jj|ƒndS(s¹ Notifies the currently focused widget that a key has been pressed. :param event: The associated event data. :type event: :class:`Event ` N(R"R!R,(R0R%((s//usr/lib/python2.7/site-packages/spyral/form.pyR, scCs&|jdk r"|jj|ƒndS(sº Notifies the currently focused widget that a key has been released. :param event: The associated event data. :type event: :class:`Event ` N(R"R!R+(R0R%((s//usr/lib/python2.7/site-packages/spyral/form.pyR+ªscCsz|dkrSt|jƒdkr=t|jjƒƒd}nd}||j|>> my_widget = spyral.widgets.ButtonWidget(my_form, "save") >>> my_form.add_widget("save", my_widget) :param str name: A unique name for this widget. :param widget: The new Widget. :type widget: :ref:`Widget ` :param int tab_order: Sets the tab order for this widget explicitly. If tab-order is None, it is set to one higher than the highest tab order. iiN( R!tlenR tmaxt itervaluesRtappendR-R(R0RR1t tab_order((s//usr/lib/python2.7/site-packages/spyral/form.pyR.µs cCstd„|jDƒƒS(sŸ A dictionary of the values for all the fields, mapping the name of each widget with the value associated with that widget. Read-only. css!|]}|j|jfVqdS(N(Rtvalue(t.0R1((s//usr/lib/python2.7/site-packages/spyral/form.pys Ös(RR(R0((s//usr/lib/python2.7/site-packages/spyral/form.pyt _get_valuesÑscCs]tjddd|d|ƒ}|jjdi|jjd6|jd6|ƒ|j|ƒdS(sµ Queues an event indicating that a widget has lost focus. :param widget: The widget that is losing focus. :type widget: :ref:`Widget ` RtblurredR1tforms%form.%(form_name)s.%(widget)s.blurredt form_nameN(RtEventRt _queue_eventt __class__RRt _handle_blur(R0R1te((s//usr/lib/python2.7/site-packages/spyral/form.pyt_blurÚs   cCsÌ|dkrD|jsdSt|jjƒdtjdƒƒd}n|jdk rf|j|jƒn||_t j ddd|d|ƒ}|j j d i|j jd 6|jd6|ƒ|j|ƒdS( s0 Sets the focus to be on a specific widget. Focus by default goes to the first widget added to the form. :param widget: The widget that is gaining focus; if None, then the first widget gains focus. :type widget: :ref:`Widget ` NRiiRtfocusedR1RIs%form.%(form_name)s.%(widget)s.focusedRJ(R!RtminR t iteritemstoperatort itemgetterR"RPRRKRRLRMRRt _handle_focus(R0R1RO((s//usr/lib/python2.7/site-packages/spyral/form.pyR/ès      cCs/|jdk r+|j|jƒd|_ndS(s, Defocuses the entire form. N(R"R!RP(R0((s//usr/lib/python2.7/site-packages/spyral/form.pytblurscCsâ|jdkr|jƒdS|js*dS|j|j}g|jjƒD]$\}}||krJ||f^qJ}t|ƒdkr™|sdSd}nt|dtj dƒƒd}|j |jƒd|_|j|ƒdS(sÁ Focuses on the next widget in tab order. :param bool wrap: Whether to continue to the first widget when the end of the tab order is reached. NiRi( R"R!R/RR RSR@RRRTRURP(R0twraptcurR1tordert candidates((s//usr/lib/python2.7/site-packages/spyral/form.pyR?s"    cCs|jdkr|jƒdS|js*dS|j|j}g|jjƒD]$\}}||krJ||f^qJ}t|ƒdkr»|sdSt|jjƒdtj dƒƒd}nt|dtj dƒƒd}|j |jƒd|_|j|ƒdS(sà Focuses the previous widget in tab order. :param bool wrap: Whether to continue to the last widget when the first of the tab order is reached. NiRi( R"R!R/RR RSR@RARTRURP(R0RXRYR1RZR[((s//usr/lib/python2.7/site-packages/spyral/form.pyR>+s$   N(RRRRt __metaclass__RR'R(R)R*R,R+R!R.RGtpropertytvaluesRPR/RWR6R?R>(((s//usr/lib/python2.7/site-packages/spyral/form.pyRs" (         (RRRTR R RRR(((s//usr/lib/python2.7/site-packages/spyral/form.pyts