ó ø`9Sc@sêdZddlTddlTddlmZddlmZddddgZd efd „ƒYZdefd „ƒYZ defd „ƒYZ d e fd„ƒYZ defd„ƒYZ defd„ƒYZdefd„ƒYZdS(s<Editing widgets with built-in error and constraint checking.iÿÿÿÿ(t*(tgui(ttxttNumberEditWidgettStringEditWidgettComboBoxEditWidgettBoolEditWidgett EditWidgetcBseZdZeƒZeƒZd d„Zd„Zd„Z d„Z d„Z d„Z d„Z d„Zd „Zd „Zd „Zd „ZRS(sBase class defining interface and layout for an edit widget capable of displaying an error message and having a built-in mechanism for constraint checking. Signals: - 'valueChanged': the value being edited has been modified or became unavailable due to syntax or constraint checking errors. - 'returnPressed': Return or Enter key has been pressed by the user. Use 'setValue' to manually set the value to be displayed in the widget and 'getValue' to retrieve the modified value edited by the user, unless some constraints are not met or a custom error message has been set on the widget. Redefine 'updateEditWidget' method to provide the functionlality to pass a value from the outside world to the actual edit widget. Use 'updateValue' for the inverse operation, calling this method from the editing slots to be connected in 'createEditWidget' whenever the value has been interactively modified by the user. Redefine 'getErrorMessage' to provide the functionality for constraint checking. You don't have to manually call the 'valueChanged' signal from any of the methods to be redefined. However, responsibility for implementation of the 'returnPressed' signal lies completely on the derived class.cCsÐtj||ƒd|_t|_tƒ}|jƒ|_|j |jƒt j dƒ}t |jj ƒƒjƒ}tƒ|_|jj|j|ƒƒ|j |jƒ|jddddƒ|j|ƒdS(Ntwarningi(tQWidgett__init__tNonetvaluetFalsethasCustomErrorMessaget QHBoxLayouttcreateEditWidgetteditt addWidgetRtloadIcont QFontMetricstfonttheighttQLabelt errorLabelt setPixmaptpixmaptsetContentsMarginst setLayout(tselftparenttlayoutt errorIconterrorIconHeight((scode\common\EditWidgets.pyR =s    cCs|jS(s0Return the widget that actually edits the value.(R(R((scode\common\EditWidgets.pyt getEditWidgetXscCs|jjƒ S(svCheck if the value being currently displayed by the widget is valid and meets any of the required constraints.(Rt isVisible(R((scode\common\EditWidgets.pythasValue]scCs|jƒr|jSdSdS(sÄReturn the current widget value converted to its genuine data type (e.g. 'int' for an integer editor) or 'None' if the current value is invalid or does not satisfy the constraints.N(R$R R (R((scode\common\EditWidgets.pytgetValuecs cCs|j|ƒ|j|ƒdS(sManually set the value to be displayed by the widget. If the value is 'None' or does not meet the constraints, still modify the edit widget in a suitable way, but turn the error status on (so that an error icon is displayed and 'hasValue' returns 'False').N(tupdateEditWidgett updateValue(RR ((scode\common\EditWidgets.pytsetValuems cCs-|jjtƒ|jj|ƒt|_dS(sAssign to the widget an error message that is not related to any of the built-in constraint checking failures. Custom error messages have greater priority than the ordinary ones. Use 'clearCustomErrorMessage' to return to normal constraint checking.N(Rt setVisibletTruet setToolTipR(Rtmessage((scode\common\EditWidgets.pytsetCustomErrorMessagewscCst|_|jƒdS(s?Clear the error message set by 'setCustomErrorMessage', if any.N(R RtupdateErrorMessage(R((scode\common\EditWidgets.pytclearCustomErrorMessageƒs cCstƒS(sCreate a widget capable of actually editing a value of the required type and connect the required slots to it, so that interactive modifications of the widget's content, as well as Enter key presses, could be tracked. Return the created edit widget.(R (R((scode\common\EditWidgets.pyRŠscCsdS(s¼Modify the widget content displayed to the user so that it matches the given 'value' of the genuine data type associated with the widget (e.g. 'int' for an integer editor).N((RR ((scode\common\EditWidgets.pyR&”scCsdS(sÏCheck if the given 'value' (of the genuine widget data type) violates any of the constraints defined by the widget and return an appropriate error string if it does. Otherwise, return 'None'.N(R (RR ((scode\common\EditWidgets.pytgetErrorMessage›scCs$||_|jƒ|jjƒdS(sJAssign a value (of the genuine widget data type) to the widget and check it against the constraints (by means of a 'getErrorMessage' call), but don't modify the widget content displayed to the user. This function has to be called in response to interactive modifications of the value being edited.N(R R.t valueChangedtemit(RR ((scode\common\EditWidgets.pyR'£s  cCsr|jr dS|j|jƒ}|dk rN|jjtƒ|jj|ƒn |jjtƒ|jjdƒdS(smShow the error label if 'self.value' does not satisfy some of the constraints, and hide it otherwise.Nt( RR0R R RR)R*R+R (Rt errorMessage((scode\common\EditWidgets.pyR.°s  N(t__name__t __module__t__doc__t pyqtSignalR1t returnPressedR R R"R$R%R(R-R/RR&R0R'R.(((scode\common\EditWidgets.pyRs         cBsVeZdZddeeedd„Zd„Zd„Zd„Z d„Z d„Z RS(sÌFloating point or integer value editor with built-in error and constraint checking. Attributes: - 'minValue', 'maxValue': constraints defining lower and upper boundaries for the number being edited. - 'isMinStrict', 'isMaxStrict': 'True' if the respective boundary values themselves are not acceptable. - 'isFloatingPoint': 'True' if the value being edited is a floating point and 'False' if it is an integer.cCsÎtj||ƒ|r[|dks7t|tƒs7t‚|dkst|tƒst‚nB|dks|t|tƒs|t‚|dkst|tƒst‚||_||_||_ ||_ ||_ dS(N( RR R t isinstancetfloattAssertionErrortinttminValuetmaxValuet isMinStrictt isMaxStricttisFloatingPoint(RR>R?R@RARBR((scode\common\EditWidgets.pyR Ïs!$!!    cCs3tƒ}|jj|jƒ|jj|jƒ|S(N(t QLineEditt textEditedtconnectt onTextEditedR9tonReturnPressed(RR((scode\common\EditWidgets.pyRãs cCs9|dkr|jjdƒn|jjt|ƒƒdS(NR3(R RtsetTexttstr(RR ((scode\common\EditWidgets.pyR&ës cCs|dkr |jrdSdSn|jrAt|tƒsVt‚nt|tƒsVt‚|jdk rˆ|jrˆ||jkrˆd|jS|jdk r±||jkr±d|jS|jdk rã|j rã||jkrãd|jS|jdk r ||jkr d|jSdS(Ns6The value entered is not a valid floating point numbers#The value entered is not an integers"This value must be greater than %gs.This value must be greater than or equal to %gsThis value must be less than %gs+This value must be less than or equal to %g( R RBR:R;R<R=R>R@R?RA(RR ((scode\common\EditWidgets.pyR0ôs(     cCs;|jrtj|ƒ}ntj|ƒ}|j|ƒdS(N(RBRt stringToFloatt stringToIntR'(RttextR ((scode\common\EditWidgets.pyRFs cCs|jjƒdS(N(R9R2(R((scode\common\EditWidgets.pyRG sN( R5R6R7R R R*R RR&R0RFRG(((scode\common\EditWidgets.pyRÂs    " cBsMeZdZdddd„Zd„Zd„Zd„Zd„Zd„Z RS(sêASCII string editor with built-in error and constraint checking. Attributes: - 'minLength', 'maxLength': minimal and maximal character counts for the string being edited or 'None' if string length is not restricted.cCsŒtj||ƒ|dks.|dks.t‚|dksL|dksLt‚|dksv|dksv||ksvt‚||_||_dS(Ni(RR R R<t minLengtht maxLength(RRMRNR((scode\common\EditWidgets.pyR ,s * cCs3tƒ}|jj|jƒ|jj|jƒ|S(N(RCRDRERFR9RG(RR((scode\common\EditWidgets.pyR9s cCsH|dkr|jjdƒn%t|tƒs4t‚|jj|ƒdS(NR3(R RRHR:RIR<(RR ((scode\common\EditWidgets.pyR&As cCs|dkrdSt|tƒs%t‚|jdk rjt|ƒ|jkrj|jdkr\dSd|jSn|jdk r™t|ƒ|jkr™d|jSdS(Ns-The value entered is not a valid ASCII stringis%This value must be a non-empty strings.This string may contain at least %d characterss-This string may contain at most %d characters(R R:RIR<RMtlenRN(RR ((scode\common\EditWidgets.pyR0Js $ $cCs;yt|ƒ}Wntk r)d}nX|j|ƒdS(N(RIt ValueErrorR R'(RRLR ((scode\common\EditWidgets.pyRFbs   cCs|jjƒdS(N(R9R2(R((scode\common\EditWidgets.pyRGlsN( R5R6R7R R RR&R0RFRG(((scode\common\EditWidgets.pyR$s   tReturnSignallingComboBoxcBs eZdZeƒZd„ZRS(sŠA 'QComboBox' capable of detecting Enter key presses (passing these events to the outer world by means of the 'returnPressed' signal).cCsBtj||ƒ|jƒtjtjfkr>|jjƒndS(N(t QComboBoxt keyPressEventtkeytQtt Key_Returnt Key_EnterR9R2(Rtevent((scode\common\EditWidgets.pyRSxs(R5R6R7R8R9RS(((scode\common\EditWidgets.pyRQps cBsAeZdZdd„Zd„Zd„Zedƒd„ƒZRS(s­An 'EditWidget' capable of selecting an item from the given fixed list of strings. Attributes: - 'admissibleValues': list of strings to select the value from.cCshtj|ddƒ||_xE|jD]:}t|tƒsPt|tƒsPt‚|jj |ƒq&WdS(NR( RR R tadmissibleValuesR:RItunicodeR<RtaddItem(RRYRR ((scode\common\EditWidgets.pyR ‰s  $cCs3tƒ}|jj|jƒ|jj|jƒ|S(N(RQtcurrentIndexChangedREtonIndexChangedR9(RR((scode\common\EditWidgets.pyR–s cCs5||jkst‚|jj|jj|ƒƒdS(N(RYR<RtsetCurrentIndextfindText(RR ((scode\common\EditWidgets.pyR&ŸsR=cCs9|j|}||jjƒks(t‚|j|ƒdS(N(RYRt currentTextR<R'(RtindexR ((scode\common\EditWidgets.pyR]¥s N( R5R6R7R R RR&tpyqtSlotR](((scode\common\EditWidgets.pyRs  tReturnSignallingCheckBoxcBs eZdZeƒZd„ZRS(sŠA 'QCheckBox' capable of detecting Enter key presses (passing these events to the outer world by means of the 'returnPressed' signal).cCsBtj||ƒ|jƒtjtjfkr>|jjƒndS(N(t QCheckBoxRSRTRURVRWR9R2(RRX((scode\common\EditWidgets.pyRSµs(R5R6R7R8R9RS(((scode\common\EditWidgets.pyRc­s cBsAeZdZdd„Zd„Zd„Zedƒd„ƒZRS(s)An 'EditWidget' for the 'bool' data type.cCs'tj|ddƒ|jj|ƒdS(slParameters: - 'label': text to be displayed along the checkbox implementing the edit.RN(RR R RRH(RtlabelR((scode\common\EditWidgets.pyR ÂscCs3tƒ}|jj|jƒ|jj|jƒ|S(N(Rct stateChangedREtonStateChangedR9(RR((scode\common\EditWidgets.pyRÎs cCs&|jj|rtjntjƒdS(N(Rt setCheckStateRUtCheckedt Unchecked(RR ((scode\common\EditWidgets.pyR&×sR=cCsD|tjkrt}n|tjks-t‚t}|j|ƒdS(N(RURjR RiR<R*R'(RtstateR ((scode\common\EditWidgets.pyRgÜs  N( R5R6R7R R RR&RbRg(((scode\common\EditWidgets.pyR¾s  N(R7t PyQt4.QtCoret PyQt4.QtGuit common.utilsRRt__all__R RRRRRRQRRdRcR(((scode\common\EditWidgets.pyts    ¤bL,