ó ø`9Sc@sddlTddlTddlmZddlmZddlTddlTddgZdd d„ƒYZde fd„ƒYZ dS( iÿÿÿÿ(t*(tgui(ttxtt ParamsDialogtParameterGroupInfocBseZdZed„ZRS(sŽDescription of appearance of a group of parameters of a 'ParamsCollection' instance in a settings dialog box. Attributes: - 'groupName': INI file group name (the same value as that specified in the respective 'ParameterInfo' instances describing the parameters). - 'groupBoxCaption': caption of the group box to hold the parameter edit widgets in a dialog box. - 'startsNewColumn': 'True' if this group box should be placed in a new column with respect to the previous one. Group boxes (corresponding to the INI file parameters groups) are arranged into columns in settings dialog boxes.cCs||_||_||_dS(N(t groupNametgroupBoxCaptiontstartsNewColumn(tselfRRR((scode\common\ParamsDialog.pyt__init__,s  (t__name__t __module__t__doc__tFalseR (((scode\common\ParamsDialog.pyRs cBs°eZdZd„Zed„ƒZed„ƒZed„ƒZd„Zd„Z d„Z d„Z d „Z d „Z d „Zd „Zd „Zd„Zd„Zd„ZRS(sBase class for dialogs intended for interactive modification of 'ParamsCollection' instances. Redefine 'getGroupInfoList' method to specify which INI file groups should be represented in the dialog. Redefine 'updateCustomErrorMessages' to implement any constraint checking procedures that involve several parameter values at once (and hence may not be implemented at the level of a single editing widget). Redefine 'updateEditEnableStatus' to restrict availability of certain edit controls under certain circumstances. Redefine 'checkSavePossibility' to perform some additional checkings when the 'Save' button is pressed, if required. Use 'getValue' to access current values of the parameters being edited, and 'setErrorMessage' to inform the user of problems with these additional constraints. Use 'setEnabled' to dynamically alter availability to the user of edit controls associated with certain parameters. Pass an instance of a class derived from 'ParamsCollection' to the constructor, then run the dialog with 'exec_'. When (and only if) the user presses the 'Save' button (and 'checkSavePossibility' returns 'True'), the passed parameters instance is modified, and its 'saveToFile' method is invoked.cCs×tj||ƒt|tƒs%t‚||_i|_tƒ}tƒ}xb|j ƒD]T}|j r‹|j ƒ|j |dƒtƒ}n|j |j|j|jƒƒqVW|j ƒt|jƒƒ|_|jjtƒ|jjj|jƒtdƒ|_|jjtƒ|jjj|jƒtƒ}|j ƒ|j |jƒ|j |jƒ|j |ƒ|j |dƒ|j|ƒ|j|jƒƒ|jtj dƒƒ|j!|j"ƒt#j$@ƒ|j%ƒdS(NitCancelt parameters(&tQDialogR t isinstancetParamsCollectiontAssertionErrortparamst editWidgetst QHBoxLayoutt QVBoxLayouttgetGroupInfoListRt addStretcht addLayoutt addWidgettcreateParameterGroupBoxRRt QPushButtontgetSaveButtonNamet saveButtontsetAutoDefaultR tclickedtconnecttonSaveButtonClickedt cancelButtontonCancelButtonClickedt setLayouttsetWindowTitletgetWindowTitlet setWindowIconRtloadIcontsetWindowFlagst windowFlagstQttWindowContextHelpButtonHinttonValueChanged(RtparentRtlayouttlastColumnLayouttgrouptbuttonBoxLayout((scode\common\ParamsDialog.pyR Ls@             cCsgS(s¸Return a list of 'ParameterGroupInfo' instances enumerating parameter groups that have to be present in the dialog box, along with the corresponding group box captions.((tcls((scode\common\ParamsDialog.pyRscCsdS(s1Return a string to be used as the dialog's title.t Parameters((R5((scode\common\ParamsDialog.pyR(˜scCsdS(s3Return a string to be displayed on the save button.s&Save((R5((scode\common\ParamsDialog.pyRscCsdS(N((R((scode\common\ParamsDialog.pytupdateCustomErrorMessages¢scCsdS(N((R((scode\common\ParamsDialog.pytupdateEditEnableStatus¥scCstS(N(tTrue(R((scode\common\ParamsDialog.pytcheckSavePossibility¨scCs|j|jƒS(sÄReturn the current value (as displayed in the corresponding edit widget) for a parameter with the given attribute name or 'None' if the value does not meet some of the constraints.(RtgetValue(Rt attributeName((scode\common\ParamsDialog.pyR;¬scCs8|dk r#|j|j|ƒn|j|jƒdS(s¶Set or clear custom error message for a parameter with the given attribute name. 'message' has to be a string to set the error message or 'None' to clear it.N(tNoneRtsetCustomErrorMessagetclearCustomErrorMessage(RR<tmessage((scode\common\ParamsDialog.pytsetErrorMessage³s cCs|j|j|ƒdS(s\Enable or disable interactive editing for a parameter with the given attribute name.N(Rt setEnabled(RR<t isEnabled((scode\common\ParamsDialog.pyRB¿sc Cs©t|ƒ}tƒ}x€|jjƒD]o}|j|kr@q%n|jƒ}t|tƒr–t|j ƒ}|j t j ƒ|j ||dddƒq%t|tƒrˆ|j|ƒ}|j dk r*|jtk r*t|j ƒ}|j t j ƒ|jt jƒ|j ||dƒ|j ||dƒn|j ||dddƒtj|ƒ!|jt|j|jƒƒWdQX||j|jKsN(RRAR=R7R8RRBtall(RR<((Rscode\common\ParamsDialog.pyR/?s    cCs_|jƒsdSx1|jD]&}t|j||j|jƒƒqW|jjƒ|jƒdS(sSave changes to the INI file, update the 'self.params' instance and close the dialog box, unless 'self.checkSavePossibility' returns 'False'.N(R:RtsetattrRR;t saveToFiletaccept(RR<((scode\common\ParamsDialog.pyR#Ns   cCs|jƒdS(N(treject(R((scode\common\ParamsDialog.pyR%^s(R R R R t classmethodRR(RR7R8R:R;RARBRRNRnR/R#R%(((scode\common\ParamsDialog.pyR3s" D      : %   N(( t PyQt4.QtCoret PyQt4.QtGuit common.utilsRRtcommon.EditWidgetstcommon.ParamsCollectiont__all__RRR(((scode\common\ParamsDialog.pyts