Alternative user interface for parameterization(参数化的替代用户界面)

Info

本节面向具有 wxPython 用户界面开发经验的用户。

../../../../../_images/EditTraceStepTemplateAlternativeGUI.png

通过 Parameters 区域中的 Edit user interface for parameterization (1) 按钮, 可以开发自定义用户界面,该界面会在分析中使用该 trace step 模板时显示。 如果某个 trace step 模板包含多个彼此直接相关的参数,此功能尤其有用。 例如,可以使用带固定值列表的 ComboBox 来简化用户输入。 用户界面开发者必须自行将输入值写回 trace step。 反过来,也可以读取现有参数值并显示在用户界面控件中。 还可以实现输入值校验,以防止无效的参数化数据。

该面板必须实现以下方法:

  • OnOk(self)

    按下 OK 按钮时会调用此方法。若要关闭对话框,它必须返回 ‘True’。 如果用户输入了无效值,该方法可返回 ‘False’ 以阻止关闭对话框。

  • SetupParams(self, trcStepData)

    在显示对话框之前会调用此方法。用户界面的控件会用 trace step 对象中的现有参数值填充。

  • StoreParams(self, trcStepData)

    用于将输入的参数值写入 trace step 对象的方法。

Info

对象 ‘trcStepData’ 的用法见 Trace Analysis API 文档。

Example

以下示例展示了一个包含两个参数 “Option” 和 “Switch” 的 trace step 模板实现。 参数仍按常规方式创建。 此外,还需在 Edit user interface for parameterization (1) 中提供以下 Python 代码示例。

#Head of function is generated, do not edit!
def GetParameterPanel(parent):
    return ParamPanel(parent)

import wx

class ParamPanel(wx.Panel):

    def __init__(self, parent):
        wx.Panel.__init__(self, parent)

        self.comboOptions = wx.ComboBox(self, wx.ID_ANY,
                                            choices=["Option 1", "Option 2", "Option 3"],
                                            style=wx.CB_READONLY)

        self.checkBoxSwith = wx.CheckBox(self, wx.ID_ANY,
                                              "Use extended Evaluation")

        sizer = wx.BoxSizer(wx.VERTICAL)
        sizer.Add(self.comboOptions, 0, wx.EXPAND | wx.ALL, 4)
        sizer.Add(self.checkBoxSwith, 0, wx.EXPAND | wx.ALL, 4)
        self.SetSizer(sizer)
        self.Fit()

    def OnOk(self):
        if self.comboOptions.GetSelection() == wx.NOT_FOUND:
            wx.MessageBox("Please choose an option!", "Error", wx.ICON_ERROR)
            return False
        return True

    def SetupParams(self, trcStepData):
        paramDesc = trcStepData.GetParameterDescription("Option")
        paramValue = trcStepData.GetParameterValue("Option")
        if paramDesc:
            self.comboOptions.SetToolTipString(paramDesc)
        try:
            val = paramValue.Evaluate()
            self.comboOptions.SetStringSelection(val)
        except:
            pass

        paramDesc = trcStepData.GetParameterDescription("Switch")
        paramValue = trcStepData.GetParameterValue("Switch")
        if paramDesc:
            self.checkBoxSwith.SetToolTipString(paramDesc)
        val = paramValue.Evaluate()
        self.checkBoxSwith.SetValue(bool(val))

    def StoreParams(self, trcStepData):
        trcStepData.SetParameterValue("Option", self.comboOptions.GetStringSelection())
        trcStepData.SetParameterValue("Switch", self.checkBoxSwith.GetValue())