Alternative user interface for parameterization(参数化的替代用户界面)¶
Info
本节面向具有 wxPython 用户界面开发经验的用户。
通过 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())