ICommandWindow

Inherited from NULL

Inherited by XCommandWnd

Friend class NULL

Description

ICommandWindow向应用层提供了丰富的用于构造命令对话框以及和命令对话框交互的接口函数，而它的实现在UI层完成，从这套接口可以将命令的UI交互与图形界面模块解耦，构造一个新的对话框不用重新编译源码，并且还支持直接使用XML文件配置界面，对开发者而言会非常方便。ICommandWindow提供的交互接口都基于控件的字符串名标识，控件的字符串名字都直接在命令的XML配置文件中给出，这会让开发者更容易阅读理解代码。

Public interface

• virtual const char * getControlStringProperty(const char * ctrl, const char * prp_name) = 0
• virtual int getControlIntProperty(const char * ctrl, const char * prp_name) = 0
• virtual void setControlAttribute(const char * ctrl, const char * atb_name, const char * atb_value) = 0
• virtual void addComboOption(const char * ctrl,const char * o,int v) = 0
• virtual void addFormItem(const char * form, const char * label, const char * name, const char * type, const char * unit = 0, int labelWidth = 0) = 0
• virtual void clearChildren(const char * parent) = 0
• virtual void setControlEnable(const char * ctrl, bool enable) = 0
• virtual void setControlVisible(const char * ctrl, bool bVisible) = 0
• virtual void setChecked(const char * ctrl,bool status) = 0
• virtual void setComboInt(const char * ctrl, int value) = 0
• virtual void setEditInt(const char * ctrl, int value) = 0
• virtual void setEditString(const char * ctrl, const char * str, const char * browse = 0) = 0
• virtual void setEditDouble(const char * ctrl, real value) = 0
• virtual void setLabelString(const char * ctrl, const char * str) = 0
• virtual void setLabelImage(const char * ctrl, const char * imageUrl, int width = -1, int height = -1) = 0
• virtual void clearCombo(const char * ctrl) = 0
• virtual real getEditDouble(const char * ctrl,real null_value = 0) = 0
• virtual int getComboInt(const char * ctrl,int null_value = 0) = 0
• virtual const char * getComboString(const char * ctrl) = 0
• virtual bool getChecked(const char * ctrl) = 0
• virtual int getEditInt(const char * ctrl) = 0
• virtual const char * getEditString(const char * ctrl) = 0
• virtual void getRealVar(const char * edit,RealVar * v) = 0
• virtual void setRealVar(const char * edit, const RealVar * v) = 0
• virtual void setTreeColCount(const char * tblCtrl, int colCount) = 0
• virtual int getTreeColCount(const char * tblCtrl) = 0
• virtual void insertTreeEditString(const char * ctrl, const XTreeIndex * ti, int col, const char * str, bool bEditable = true) = 0
• virtual void setTreeChecked(const char * ctrl, const XTreeIndex * ti, int col, bool status) = 0
• virtual void setTreeCurrent(const char * ctrl, const XTreeIndex * ti) = 0
• virtual void setTreeEditInt(const char * ctrl, const XTreeIndex * ti, int col, int value, bool bEditable = true) = 0
• virtual void setTreeEditString(const char * ctrl, const XTreeIndex * ti, int col, const char * str, bool bEditable = true) = 0
• virtual void setTreeEditDouble(const char * ctrl, const XTreeIndex * ti, int col, real value, bool bEditable = true) = 0
• virtual real getTreeEditDouble(const char * ctrl, const XTreeIndex * ti, int col, real null_value = 0) = 0
• virtual bool getTreeChecked(const char * ctrl, const XTreeIndex * ti, int col) = 0
• virtual int getTreeEditInt(const char * ctrl, const XTreeIndex * ti, int col) = 0
• virtual const char * getTreeEditString(const char * ctrl, const XTreeIndex * ti, int col) = 0
• virtual int getTreeCurrentIndex(const char * ctrl, XTreeIndex * ti) = 0
• virtual int getTreeChildCount(const char * ctrl, const XTreeIndex * ti) = 0
• virtual int getTreeItemValue(const char * ctrl, XTreeIndex * ti, int col) = 0
• virtual void removeTreeItem(const char * ctrl, XTreeIndex * ti) = 0
• virtual void moveTreeItem(const char * ctrl, XTreeIndex * from, XTreeIndex * to) = 0
• virtual void clearContent(const char * ctrl) = 0
• virtual void setCurrentSub(const char * ctrl, const char * subName, const char * url, const char * subBuddy = 0) = 0
• virtual void reloadSub(const char * ctrl, const char * subName, const char * url) = 0
• virtual void setGroupVisible(const char * grp,bool bVisible) = 0
• virtual void layoutBegin() = 0
• virtual void layoutEnd() = 0
• virtual const char * getOpenFile(const char * title, const char * description, const char * filter, const char * dir = 0, const char * buddy = 0) = 0
• virtual const char * getSaveFile(const char * title, const char * description, const char * filter, const char * dir = 0, const char * buddy = 0) = 0
• virtual const char * getDir(const char * title,const char * defaultDir = “”, const char * buddy = 0) = 0
• virtual bool getColor(uint8* out_rgba,uint8 * initial = 0) = 0
• virtual bool getImageSize(const char * img, int * w, int * h) = 0
• virtual void setCurveData(const char * ctrl, const XDataXY * xyc) = 0
• virtual void getFieldData(const char * ctrl, XDataField * fd) = 0
• virtual void setFieldData(const char * ctrl, const XDataField * fd) = 0
• virtual void setHeaderTitle(const char * ctrl, const char * title, int index = 0, int width = -1) = 0
• virtual void setControlSize(const char * ctrl, int width, int height) = 0
• virtual ControlItem getControlItem(const char * name) = 0
• virtual void loadFromXml(const char * config) = 0
• virtual void saveToXml(const char * xml) = 0
• virtual void hide() = 0
• virtual void show() = 0
• virtual void updateTo(void * param) = 0
• virtual void updateFrom(void * param) = 0
• virtual ICommand* getCurrentCmd() = 0
• virtual void popSubDialog(const char * dlg_xml) = 0
• virtual void setMarkdownContent(const char * ctrl, const char * content) = 0
• virtual void saveMarkdown(const char * ctrl, const char * fname) = 0
• virtual void loadMarkdown(const char * ctrl, const char * fname) = 0
• virtual bool configControl(const char * name, const char * config) = 0
• virtual bool exchangeEditData(const char * ctrl,float & value, float default_v = XREAL_MAX) = 0
• virtual bool exchangeEditData(const char * ctrl,double & value, double default_v = XREAL_MAX) = 0
• virtual bool exchangeUnitEditData(const char * ctrl, double & value, TypeID utype, double default_v = XREAL_MAX) = 0
• virtual bool exchangeEditDataWithUnitCombo(const char * valueEdit, const char * unitCombo, double & value, double default_v = XREAL_MAX) = 0
• virtual bool exchangeEditData(const char * ctrl,RealVar & value, real default_v = 0) = 0
• virtual bool exchangeSpinData(const char * ctrl, int & value) = 0
• virtual bool exchangeComboData(const char * ctrl,int & value,int default_v = 0) = 0
• virtual bool exchangeCheckData(const char * ctrl,bool & value) = 0
• virtual bool exchangeColorData(const char * ctrl, RGBAColor & value) = 0
• virtual bool exchangeSubCheckData(const char * ctrl, const char * sub, bool & value) = 0
• virtual bool exchangeRadioCheckData(const char * ctrl,int & value) = 0
• virtual bool exchangeEditData(const char * ctrl,int & value, int default_v = XINT_MAX) = 0
• virtual bool exchangeEditData(const char * ctrl,char * value, const char * default_v = “”) = 0
• virtual bool exchangeFieldData(const char * ctrl,XDataField & value) = 0
• virtual bool exchangeCurveData(const char * ctrl,XDataXY & value) = 0
• virtual bool exchangeSheetData(const char * ctrl,const char * config) = 0
• virtual bool exchangeLabelOption(const char * ctrl, const char * varName, LabelVarSection & varSection) = 0
• virtual bool exchangeLabelVar(const char * ctrl, LabelVar & varSection) = 0
• virtual void setExchangeMode(DataExchangeMode bGetOrSet) = 0
• virtual DataExchangeMode getExchangeMode() = 0
• virtual void initComboItems(const char * wgt, const XManager * mgr,int default_id = 0, TypeID filter = DItem_Unknown) = 0
• virtual void addListItem(const char * ctrl, const char * txt, int v = -1, int checkMode = Check_Disable, const char * linkWgt = 0, const char * linkWgtUrl = 0) = 0
• virtual void removeListItem(const char * ctrl, int v, bool byRowIndex = false) = 0
• virtual void moveUpListItem(const char * ctrl, int v) = 0
• virtual void moveDownListItem(const char * ctrl, int v) = 0
• virtual void initList(const char * ctrl, const char * setting) = 0
• virtual const char * getListString(const char * ctrl, int idx) = 0
• virtual int getListItemValue(const char * ctrl,int index) = 0
• virtual int getListItemRow(const char * ctrl, int value) = 0
• virtual int getListItemCount(const char * ctrl) = 0
• virtual int getListCurrentRow(const char * ctrl) = 0
• virtual bool getListChecked(const char * ctrl, int idx) = 0
• virtual void setListCurrent(const char * ctrl, int idx) = 0
• virtual void setListChecked(const char * ctrl, int idx, bool bCheck) = 0
• virtual void setListString(const char * ctrl, int idx, const char * str) = 0
• virtual void setTableFromString(const char * tblCtrl, const char * str) = 0
• virtual void setTableFromClipboard(const char * tblCtrl) = 0
• virtual void getTableToClipboard(const char * tblCtrl) = 0
• virtual void setTableRowCount(const char * tblCtrl, int rowCount) = 0
• virtual int getTableRowCount(const char * tblCtrl) = 0
• virtual void setTableColCount(const char * tblCtrl, int colCount) = 0
• virtual int getTableColCount(const char * tblCtrl) = 0
• virtual void addTableComboOption(const char * ctrl, int row, int col, const char * o, int v) = 0
• virtual void setTableChecked(const char * ctrl, int row, int col, bool status) = 0
• virtual void setTableComboInt(const char * ctrl, int row, int col, int value) = 0
• virtual void setTableEditableCombo(const char * ctrl, int row, int col) = 0
• virtual void setTableComboOptions(const char * ctrl, int row, int col, vector<string> * options, const char * curText = 0) = 0
• virtual void setTableEditInt(const char * ctrl, int row, int col, int value, bool bEditable = true) = 0
• virtual void setTableEditString(const char * ctrl, int row, int col, const char * str, const char * browse = 0, bool bEditable = true) = 0
• virtual void setTableEditDouble(const char * ctrl, int row, int col, real value, bool bEditable = true) = 0
• virtual void setTableLabelString(const char * ctrl, int row, int col, const char * str) = 0
• virtual real getTableEditDouble(const char * ctrl, int row, int col, real null_value = 0) = 0
• virtual int getTableComboInt(const char * ctrl, int row, int col, int null_value = 0) = 0
• virtual const char * getTableComboString(const char * ctrl, int row, int col) = 0
• virtual bool getTableChecked(const char * ctrl, int row, int col) = 0
• virtual int getTableEditInt(const char * ctrl, int row, int col) = 0
• virtual const char * getTableEditString(const char * ctrl, int row, int col) = 0
• virtual int getTableCurrentRow(const char * ctrl) = 0
• virtual void adjustTableView(const char * ctrl) = 0
• virtual void updateData(bool bSave) = 0

---

virtual const char * getControlStringProperty(const char * ctrl, const char * prp_name) = 0

• function: 控件可以定义若干不同值类型的属性，本函数用于获取控件的字符串属性值
• parameters:
  1. [i]const char * ctrl: 控件名
  2. [i] const char * prp_name: 属性名
• return value: 字符串属性值

virtual int getControlIntProperty(const char * ctrl, const char * prp_name) = 0

• function: 控件可以定义若干不同值类型的属性，本函数用于获取控件的整型属性值
• parameters:
  1. [i]const char * ctrl: 控件名
  2. [i] const char * prp_name: 属性名
• return value: 字符串属性值

virtual void setControlAttribute(const char * ctrl, const char * atb_name, const char * atb_value) = 0

• function: 控件可以定义若干不同值类型的属性，本函数用于为控件添加字符串属性
• parameters:
  1. [i]const char * ctrl: 控件名
  2. [i] const char * atb_name: 属性名
  3. [i] const char * atb_value: 属性值
• return value: 无

virtual void addComboOption(const char * ctrl,const char * o,int v) = 0

• function: 为下拉框控件增加值为v的选项
• parameters:
  1. [i]const char * ctrl: 下拉框控件名
  2. [i]const char * o: 新增选项显示文本
  3. [i]int v: 选项对应的值
• return value: 无

virtual void addFormItem(const char * form, const char * label, const char * name, const char * type, const char * unit = 0, int labelWidth = 0) = 0

• function: 为表单布局增加控件项
• parameters:
  1. [i]const char * form: 表单布局名
  2. [i] const char * label: 控件标签文本
  3. [i] const char * name: 控件名
  4. [i] const char * type: 控件类型
  5. [i] const char * unit = 0: 为控件设定单位制，如果为0，则忽略之
  6. [i] int labelWidth = 0: 标签宽
• return value: 无

virtual void clearChildren(const char * parent) = 0

• function: 清空容器控件的所有子控件
• parameters:
  1. [i]const char * parent:容器控件名
• return value: 无

virtual void setControlEnable(const char * ctrl, bool enable) = 0

• function:
• parameters: 设置控件是否可用（不可用，则灰掉控件）
  1. [i]const char * ctrl: 控件名
  2. [i] bool enable: 是否可用
• return value: 无

virtual void setControlVisible(const char * ctrl, bool bVisible) = 0

• function: 设置控件是否可见
• parameters:
  1. [i]const char * ctrl: 控件名
  2. [i] bool bVisible: 是否可见
• return value: 无

virtual void setChecked(const char * ctrl,bool status) = 0

• function: 设置勾选框控件勾选状态
• parameters:
  1. [i]const char * ctrl: 勾选框控件名
  2. [i]bool status: 是否勾选
• return value: 无

virtual void setComboInt(const char * ctrl, int value) = 0

• function:把下拉框的值为value的选项设置成当前项
• parameters:
  1. [i]const char * ctrl: 下拉框控件名
  2. [i] int value: 选项值
• return value: 无

virtual void setEditInt(const char * ctrl, int value) = 0

• function: 设置编辑框的值
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i] int value: 整型值
• return value: 无

virtual void setEditString(const char * ctrl, const char * str, const char * browse = 0) = 0

• function: 设置编辑框的值
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i] const char * str: 文本值
  3. [i] const char * browse = 0: 是否浏览路径，按照“open:*.xml”、“save:*.xml”或者“dir:“形式指定打开目录或者文件
• return value: 无

virtual void setEditDouble(const char * ctrl, real value) = 0

• function: 设置编辑框的值
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i] real value: 浮点值
• return value: 无

virtual void setLabelString(const char * ctrl, const char * str) = 0

• function: 设置标签控件的显示文本
• parameters:
  1. [i]const char * ctrl: 标签控件名
  2. [i] const char * str: 显示文本
• return value: 无

virtual void setLabelImage(const char * ctrl, const char * imageUrl, int width = -1, int height = -1) = 0

• function: 设置标签控件的背景图片
• parameters:
  1. [i]const char * ctrl: 标签控件名
  2. [i] const char * imageUrl: 背景图片路径，为参考资源目录的相对路径
  3. [i] int width = -1: 标签宽
  4. [i] int height = -1: 标签长
• return value: 无

virtual void clearCombo(const char * ctrl) = 0

• function: 清空下拉框的所有选项
• parameters:
  1. [i]const char * ctrl: 下拉框控件名
• return value: 无

virtual real getEditDouble(const char * ctrl,real null_value = 0) = 0

• function: 获取编辑框输入的整型值
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i]real null_value = 0: 默认返回值，如编辑框内容为空，将返回该值
• return value: 编辑框输入的整型值

virtual int getComboInt(const char * ctrl,int null_value = 0) = 0

• function: 获取下拉框当前选项的对应值（一般一个选项对应一个整型值）
• parameters:
  1. [i]const char * ctrl: 下拉框控件名
  2. [i]int null_value = 0: 默认返回值，如下拉框为空，将返回该值
• return value: 下拉框当前选项的对应值

virtual const char * getComboString(const char * ctrl) = 0

• function: 获取下拉框当前选项的文本
• parameters:
  1. [i]const char * ctrl: 下拉框控件名
• return value: 下拉框当前选项的文本

virtual bool getChecked(const char * ctrl) = 0

• function: 勾选框控件是否被勾选
• parameters:
  1. [i]const char * ctrl: 勾选框控件名
• return value: 如勾选返回true，否则返回false

virtual int getEditInt(const char * ctrl) = 0

• function: 获取编辑框输入的整型值
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
• return value: 编辑框输入的整型值

virtual const char * getEditString(const char * ctrl) = 0

• function: 获取编辑框输入的字符串
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
• return value: 编辑框输入的字符串

virtual void setTreeColCount(const char * tblCtrl, int colCount) = 0

• function: 设置树控件的数据列数
• parameters:
  1. [i]const char * tblCtrl: 树控件名
  2. [i] int colCount: 数据列数
• return value: 无

virtual int getTreeColCount(const char * tblCtrl) = 0

• function: 获取树控件的数据维度
• parameters:
  1. [i]const char * tblCtrl: 数控件名
• return value: 无

virtual void insertTreeEditString(const char * ctrl, const XTreeIndex * ti, int col, const char * str, bool bEditable = true) = 0

• function: 在树控件中插入文本项
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] const XTreeIndex * ti: 树节点索引，按照”0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点）
  3. [i] int col: 数据列号
  4. [i] const char * str: 插入的文本
  5. [i] bool bEditable = true: 是否可编辑，若为false，该文本项不能被编辑，默认为可编辑。
• return value: 无

virtual void setTreeChecked(const char * ctrl, const XTreeIndex * ti, int col, bool status) = 0

• function: 设置树控件的节点为可勾选
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] const XTreeIndex * ti: 树节点索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点）
  3. [i] int col: 指定节点的第col个数据
  4. [i] bool status: 设置状态是否勾选
• return value: 无

virtual void setTreeCurrent(const char * ctrl, const XTreeIndex * ti) = 0

• function: 设置树控件的当前选中项
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] const XTreeIndex * ti: 树节点索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点）
• return value: 无

virtual void setTreeEditInt(const char * ctrl, const XTreeIndex * ti, int col, int value, bool bEditable = true) = 0

• function: 设置树控件的节点数据值
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] const XTreeIndex * ti: 树节点索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点）
  3. [i] int col: 节点的第col个数据
  4. [i] int value: 整型值
  5. [i] bool bEditable = true: 是否可编辑，默认为可编辑
• return value: 无

virtual void setTreeEditString(const char * ctrl, const XTreeIndex * ti, int col, const char * str, bool bEditable = true) = 0

• function: 设置树控件节点序号为col的数据项的值
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] const XTreeIndex * ti: 树节点索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点）
  3. [i] int col: 节点的数据项序号
  4. [i] const char * str: 字符串
  5. [i] bool bEditable = true: 是否可编辑，默认为可编辑
• return value: 无

virtual void setTreeEditDouble(const char * ctrl, const XTreeIndex * ti, int col, real value, bool bEditable = true) = 0

• function: 设置树控件节点序号为col的数据项的值
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] const XTreeIndex * ti: 树节点索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点
  3. [i] int col: 节点的数据项序号
  4. [i] real value:
  5. [i] bool bEditable = true:
• return value:

virtual real getTreeEditDouble(const char * ctrl, const XTreeIndex * ti, int col, real null_value = 0) = 0

• function: 获取树控件节点序号为col的数据项的浮点数值
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] const XTreeIndex * ti: 树节点索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点
  3. [i] int col: 节点的数据项序号
  4. [i] real null_value = 0: 如树控件节点序号为col的数据项为空，返回该值
• return value: 树控件节点序号为col的数据项的浮点数值

virtual bool getTreeChecked(const char * ctrl, const XTreeIndex * ti, int col) = 0

• function: 获取树控件节点序号为col的数据项的勾选状态
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] const XTreeIndex * ti: 树节点索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点
  3. [i] int col: 节点的数据项序号
• return value: 若被勾选返回true，否则返回false

virtual int getTreeEditInt(const char * ctrl, const XTreeIndex * ti, int col) = 0

• function: 获取树控件节点序号为col的数据项的整数值
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] const XTreeIndex * ti: 树节点索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点
  3. [i] int col: 节点的数据项序号
• return value: 树控件节点序号为col的数据项的整数值

virtual const char * getTreeEditString(const char * ctrl, const XTreeIndex * ti, int col) = 0

• function: 获取树控件节点序号为col的数据项的文本
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] const XTreeIndex * ti: 树节点索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点
  3. [i] int col: 节点的数据项序号
• return value: 树控件节点序号为col的数据项的文本

virtual int getTreeCurrentIndex(const char * ctrl, XTreeIndex * ti) = 0

• function: 获取树控件的当前选项的索引
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] XTreeIndex * ti: 当前选项的索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点
• return value: 返回当前选项的数据序号

virtual int getTreeChildCount(const char * ctrl, const XTreeIndex * ti) = 0

• function: 获取树控件节点的子项个数
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] const XTreeIndex * ti: 树节点索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点
• return value: 子项个数

virtual int getTreeItemValue(const char * ctrl, XTreeIndex * ti, int col) = 0

• function: 获取树控件节点的绑定值
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] XTreeIndex * ti: 树节点索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点
  3. [i] int col: 节点的数据项序号
• return value: 树控件节点的绑定值

virtual void removeTreeItem(const char * ctrl, XTreeIndex * ti) = 0

• function: 删除树控件的节点及其所有子节点
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] XTreeIndex * ti: 树节点索引，按照“0,1,3”形式给出（从根节点开始，第0个分支的第一个子分支的第3个子节点
• return value: 删除树控件的节点及其所有子节点

virtual void moveTreeItem(const char * ctrl, XTreeIndex * from, XTreeIndex * to) = 0

• function: 将树控件的from节点移动到to节点位置（插入到to节点之前）
• parameters:
  1. [i]const char * ctrl: 树控件名
  2. [i] XTreeIndex * from: 源节点位置
  3. [i] XTreeIndex * to: 目标节点位置
• return value: 无

virtual void clearContent(const char * ctrl) = 0

• function: 清空控件（List/Tree/Table/Combo）的内容
• parameters:
  1. [i]const char * ctrl: 控件名
• return value: 无

virtual void setCurrentSub(const char * ctrl, const char * subName, const char * url, const char * subBuddy = 0) = 0

• function: 设置Tab/Stack控件的当前子控件
• parameters:
  1. [i]const char * ctrl: 父控件名
  2. [i] const char * subName: 子控件名
  3. [i] const char * url: 子控件对应的配置文件
  4. [i] const char * subBuddy = 0: 关联控件名（如当前子控件受下拉框或者列表框控制时）
• return value: 无

virtual void reloadSub(const char * ctrl, const char * subName, const char * url) = 0

• function: 重新载入子控件（用于子控件内容发生较大修改时 重新配置子控件）
• parameters:
  1. [i]const char * ctrl: 父控件名
  2. [i] const char * subName: 子控件名
  3. [i] const char * url: 子控件对应的配置文件路径
• return value: 无

virtual void setGroupVisible(const char * grp,bool bVisible) = 0

• function: 设置控件组是否可见
• parameters:
  1. [i]const char * grp: 控件组名
  2. [i]bool bVisible: 是否可见
• return value: 无

virtual void layoutBegin() = 0

• function: 开始布局（启动命令对话框时调用）
• parameters: NULL
• return value: 无

virtual void layoutEnd() = 0

• function: 布局结束（启动命令对话框时调用）
• parameters: NULL
• return value: 无

virtual const char * getOpenFile(const char * title, const char * description, const char * filter, const char * dir = 0, const char * buddy = 0) = 0

• function: 打开文件对话框获取文件路径
• parameters:
  1. [i]const char * title: 文件对话框标题
  2. [i] const char * description: 描述
  3. [i] const char * filter: 文件后缀名
  4. [i] const char * dir = 0: 初始目录
  5. [i] const char * buddy = 0: 关联编辑框，获取的文件名路径将自动更新到关联编辑框中，默认无关联编辑框
• return value: 打开文件路径（文件可以不存在）

virtual const char * getSaveFile(const char * title, const char * description, const char * filter, const char * dir = 0, const char * buddy = 0) = 0

• function: 打开保存文件对话框获取文件路径
• parameters:
  1. [i]const char * title: 文件对话框标题
  2. [i] const char * description: 描述
  3. [i] const char * filter: 文件后缀名
  4. [i] const char * dir = 0: 初始目录
  5. [i] const char * buddy = 0: 关联编辑框，获取的文件名路径将自动更新到关联编辑框中，默认无关联编辑框
• return value: 保存文件路径（文件必须已存在）

virtual const char * getDir(const char * title,const char * defaultDir = “”, const char * buddy = 0) = 0

• function: 打开目录对话框获取文件夹路径
• parameters:
  1. [i]const char * title: 目录对话框标题
  2. [i]const char * defaultDir = “”: 初始目录
  3. [i] const char * buddy = 0: 关联编辑框，获取的文件名路径将自动更新到关联编辑框中，默认无关联编辑框
• return value: 目录路径（目录必须存在）

virtual bool getColor(uint8* out_rgba,uint8 * initial = 0) = 0

• function: 获取颜色控件的颜色值
• parameters:
  1. [i]uint8* out_rgba: 颜色值
  2. [i]uint8 * initial = 0: 初始颜色值
• return value: 成功获取返回true，否则返回false

virtual bool getImageSize(const char * img, int * w, int * h) = 0

• function: 获取图像尺寸
• parameters:
  1. [i]const char * img: 图像路径
  2. [i] int * w: 图像宽（像素）
  3. [i] int * h: 图像高（像素）
• return value: 成功获取返回true，否则返回false

virtual void setCurveData(const char * ctrl, const XDataXY * xyc) = 0

• function: 设置曲线控件数据
• parameters:
  1. [i]const char * ctrl: 曲线控件名
  2. [i] const XDataXY * xyc: 曲线数据
• return value: 无

virtual void getFieldData(const char * ctrl, XDataField * fd) = 0

• function: 获取场控件数据
• parameters:
  1. [i]const char * ctrl: 场控件名
  2. [i] XDataField * fd: 数据场
• return value: 无

virtual void setFieldData(const char * ctrl, const XDataField * fd) = 0

• function: 设置场控件数据
• parameters:
  1. [i]const char * ctrl: 场控件名
  2. [i] const XDataField * fd: 数据场
• return value: 无

virtual void setHeaderTitle(const char * ctrl, const char * title, int index = 0, int width = -1) = 0

• function: 设置List/Tree/Table标题栏标题
• parameters:
  1. [i]const char * ctrl: 控件名
  2. [i] const char * title: 标题
  3. [i] int index = 0: 序列号
  4. [i] int width = -1: 列数据宽度
• return value: 无

virtual void setControlSize(const char * ctrl, int width, int height) = 0

• function: 设置控件大小
• parameters:
  1. [i]const char * ctrl: 控件名
  2. [i] int width: 宽
  3. [i] int height: 高
• return value: 无

virtual ControlItem getControlItem(const char * name) = 0

• function: 获取给定控件名控件指针
• parameters:
  1. [i]const char * name: 控件名
• return value: 控件指针

virtual void loadFromXml(const char * config) = 0

• function: 读取XML文件配置对话框
• parameters:
  1. [i]const char * config: XML配置文件
• return value: 无

virtual void hide() = 0

• function: 隐藏对话框
• parameters: NULL
• return value: 无

virtual void show() = 0

• function: 显示对话框
• parameters: NULL
• return value: 无

virtual ICommand* getCurrentCmd() = 0

• function: 获取当前命令
• parameters: NULL
• return value: 当前命令指针

virtual void popSubDialog(const char * dlg_xml) = 0

• function: 弹出子对话框
• parameters:
  1. [i]const char * dlg_xml: 子对话框的配置文件
• return value: 无

virtual void setMarkdownContent(const char * ctrl, const char * content) = 0

• function: 设置Markdown控件内容
• parameters:
  1. [i]const char * ctrl: Markdown控件名
  2. [i] const char * content: Markdown格式内容
• return value: 无

virtual void saveMarkdown(const char * ctrl, const char * fname) = 0

• function: 保存Markdown控件内容到指定文件中
• parameters:
  1. [i]const char * ctrl: Markdown控件名
  2. [i] const char * fname: 文件名
• return value: 无

virtual void loadMarkdown(const char * ctrl, const char * fname) = 0

• function: 从指定文件中载入内容到Markdown控件
• parameters:
  1. [i]const char * ctrl:Markdown控件名
  2. [i] const char * fname: 文件名
• return value: 无

virtual bool configControl(const char * name, const char * config) = 0

• function: 通过配置文件配置控件
• parameters:
  1. [i]const char * name: 控件名
  2. [i] const char * config: 配置文件路径
• return value: 成功配置返回true，否则返回false

virtual bool exchangeEditData(const char * ctrl,float & value, float default_v = XREAL_MAX) = 0

• function: 与单精度浮点数变量交换编辑框数据
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i]float & value: 交换的单精度浮点数变量
  3. [i] float default_v = XREAL_MAX: 如编辑框为空返回默认值
• return value: 成功交换返回true，否则返回false

virtual bool exchangeEditData(const char * ctrl,double & value, double default_v = XREAL_MAX) = 0

• function: 与双精度浮点数变量交换编辑框数据
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i]double & value: 交换的双精度浮点数变量
  3. [i] double default_v = XREAL_MAX: 如编辑框为空返回默认值
• return value: 成功交换返回true，否则返回false

virtual bool exchangeUnitEditData(const char * ctrl, double & value, TypeID utype, double default_v = XREAL_MAX) = 0

• function: 与带单位的双精度浮点数变量交换编辑框数据
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i] double & value: 带单位的双精度浮点数变量
  3. [i] TypeID utype: 单位类型
  4. [i] double default_v = XREAL_MAX: 如编辑框为空返回默认值
• return value: 成功交换返回true，否则返回false

virtual bool exchangeEditDataWithUnitCombo(const char * valueEdit, const char * unitCombo, double & value, double default_v = XREAL_MAX) = 0

• function: 与带单位的双精度浮点数变量交换编辑框数据，其中单位类型由下拉框给定
• parameters:
  1. [i]const char * valueEdit: 编辑框控件名
  2. [i] const char * unitCombo: 指定单位类型的下拉框控件名
  3. [i] double & value: 带单位的双精度浮点数变量
  4. [i] double default_v = XREAL_MAX: 如编辑框为空返回默认值
• return value: 成功交换返回true，否则返回false

virtual bool exchangeSpinData(const char * ctrl, int & value) = 0

• function: 与整数变量交换旋钮框数据
• parameters:
  1. [i]const char * ctrl: 旋钮框控件名
  2. [i] int & value: 整数变量
• return value:成功交换返回true，否则返回false

virtual bool exchangeComboData(const char * ctrl,int & value,int default_v = 0) = 0

• function: 与整数变量交换下拉框数据
• parameters:
  1. [i]const char * ctrl: 下拉框控件名
  2. [i]int & value: 整数变量
  3. [i]int default_v = 0: 指定默认值
• return value: 成功交换返回true，否则返回false

virtual bool exchangeCheckData(const char * ctrl,bool & value) = 0

• function: 与布尔变量交换勾选框数据
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i]bool & value: 布尔变量
• return value: 成功交换返回true，否则返回false

virtual bool exchangeColorData(const char * ctrl, RGBAColor & value) = 0

• function: 与颜色变量交换颜色控件数据
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i] RGBAColor & value: 颜色值
• return value: 成功交换返回true，否则返回false

virtual bool exchangeSubCheckData(const char * ctrl, const char * sub, bool & value) = 0

• function: 与整数变量交换父控件（目前只支持树控件）子节点的勾选状态
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i] const char * sub: 子节点名
  3. [i] bool & value: 整数变量
• return value: 成功交换返回true，否则返回false

virtual bool exchangeRadioCheckData(const char * ctrl,int & value) = 0

• function: 与整数变量交换单选框数据
• parameters:
  1. [i]const char * ctrl: 单选框控件名
  2. [i]int & value: 整数变量
• return value: 成功交换返回true，否则返回false

virtual bool exchangeEditData(const char * ctrl,int & value, int default_v = XINT_MAX) = 0

• function: 与整数变量交换编辑框数据
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i]int & value: 整数变量
  3. [i] int default_v = XINT_MAX: 编辑框为空时，返回该默认值
• return value: 成功交换返回true，否则返回false

virtual bool exchangeEditData(const char * ctrl,char * value, const char * default_v = “”) = 0

• function: 与字符串变量交换编辑框数据
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i]char * value: 字符串变量
  3. [i] const char * default_v = “”: 编辑框为空时，以此为默认值返回
• return value: 成功交换返回true，否则返回false

virtual bool exchangeFieldData(const char * ctrl,XDataField & value) = 0

• function: 交换场数据
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i]XDataField & value: 场对象
• return value: 成功交换返回true，否则返回false

virtual bool exchangeCurveData(const char * ctrl,XDataXY & value) = 0

• function: 交换曲线数据
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i]XDataXY & value: 曲线对象
• return value: 成功交换返回true，否则返回false

virtual bool exchangeSheetData(const char * ctrl,const char * config) = 0

• function: 通过配置文件交换数据表数据
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i]const char * config: 数据表文件
• return value: 成功交换返回true，否则返回false

virtual bool exchangeLabelVar(const char * ctrl, LabelVar & varSection) = 0

• function: 与带标签的变量交换编辑框数据
• parameters:
  1. [i]const char * ctrl: 编辑框控件名
  2. [i] LabelVar & varSection: 标签变量组
• return value: 成功交换返回true，否则返回false

virtual void setExchangeMode(DataExchangeMode bGetOrSet) = 0

• function: 设置数据交换模式
• parameters:
  1. [i]DataExchangeMode bGetOrSet: 获取模式或者设置模式
• return value: 无

virtual DataExchangeMode getExchangeMode() = 0

• function: 获取当前数据交换模式
• parameters: NULL
• return value: 获取模式或设置模式

virtual void initComboItems(const char * wgt, const XManager * mgr,int default_id = 0, TypeID filter = DItem_Unknown) = 0

• function: 按照对象管理器初始化下拉框
• parameters:
  1. [i]const char * wgt: 下拉框控件名
  2. [i] const XManager * mgr: 对象管理器
  3. [i]int default_id = 0: 默认当前对象ID
  4. [i] TypeID filter = DItem_Unknown: 对象类型过滤器，默认不过滤
• return value: 无

virtual void addListItem(const char * ctrl, const char * txt, int v = -1, int checkMode = Check_Disable, const char * linkWgt = 0, const char * linkWgtUrl = 0) = 0

• function: 向列表控件添加子项
• parameters:
  1. [i]const char * ctrl: 列表控件名
  2. [i] const char * txt: 子项文本
  3. [i] int v = -1: 子项绑定值
  4. [i] int checkMode = Check_Disable: 子项是否可勾选
  5. [i] const char * linkWgt = 0: 关联控件（双击子项，关联控件将切换当前控件）
  6. [i] const char * linkWgtUrl = 0: 关联控件的配置文件路径
• return value: 无

virtual void removeListItem(const char * ctrl, int v, bool byRowIndex = false) = 0

• function: 删除移动列表项
• parameters:
  1. [i]const char * ctrl: 列表控件名
  2. [i] int v: 列表项的序号或绑定值
  3. [i] bool byRowIndex = false: 若true按照序号删除，否则按照绑定值删除
• return value: 无

virtual void moveUpListItem(const char * ctrl, int v) = 0

• function: 向上移动绑定值为v的列表项
• parameters:
  1. [i]const char * ctrl: 列表控件名
  2. [i] int v: 列表项的绑定值
• return value: 无

virtual void moveDownListItem(const char * ctrl, int v) = 0

• function: 向下移动绑定值为v的列表项
• parameters:
  1. [i]const char * ctrl: 列表控件名
  2. [i] int v: 列表项的绑定值
• return value: 无

virtual void initList(const char * ctrl, const char * setting) = 0

• function: 按照配置文件初始化列表控件
• parameters:
  1. [i]const char * ctrl: 列表控件名
  2. [i] const char * setting: 配置文件名
• return value: 无

virtual const char * getListString(const char * ctrl, int idx) = 0

• function: 获取列表控件第index项的字符串文本
• parameters:
  1. [i]const char * ctrl: 列表控件名
  2. [i] int idx: 列表项序号
• return value: 列表项文本

virtual int getListItemValue(const char * ctrl,int index) = 0

• function: 获取列表控件第index项的绑定值
• parameters:
  1. [i]const char * ctrl: 列表控件名
  2. [i]int index: 列表项序号
• return value: 列表项的绑定值

virtual int getListItemRow(const char * ctrl, int value) = 0

• function: 通过绑定值获取列表控件对应的项
• parameters:
  1. [i]const char * ctrl: 列表控件名
  2. [i] int value: 绑定值
• return value: 对应列表项的序号，如没有对应返回-1

virtual int getListItemCount(const char * ctrl) = 0

• function: 获取列表控件的项目数目
• parameters:
  1. [i]const char * ctrl: 列表控件名
• return value: 列表控件的项目数目

virtual int getListCurrentRow(const char * ctrl) = 0

• function: 获取列表控件当前选中项的序号
• parameters:
  1. [i]const char * ctrl: 列表控件名
• return value: 如选中返回选中项的序号，否则返回-1

virtual bool getListChecked(const char * ctrl, int idx) = 0

• function: 获取列表控件第idx项的勾选状态
• parameters:
  1. [i]const char * ctrl: 列表控件名
  2. [i] int idx: 列表项序号
• return value: 列表控件第idx项的勾选状态

virtual void setListCurrent(const char * ctrl, int idx) = 0

• function: 设置列表控件第idx项为选中项
• parameters:
  1. [i]const char * ctrl: 列表控件名
  2. [i] int idx: 列表项序号
• return value: 无

virtual void setListChecked(const char * ctrl, int idx, bool bCheck) = 0

• function: 设置列表控件第idx项的勾选状态
• parameters:
  1. [i]const char * ctrl: 列表控件名
  2. [i] int idx: 列表项序号
  3. [i] bool bCheck: 勾选状态
• return value: 无

virtual void setListString(const char * ctrl, int idx, const char * str) = 0

• function: 设置列表控件第idx项的文本
• parameters:
  1. [i]const char * ctrl: 列表控件名
  2. [i] int idx: 列表项序号
  3. [i] const char * str: 列表项文本
• return value: 无

virtual void setTableFromString(const char * tblCtrl, const char * str) = 0

• function: 按照格式字符串设定表格控件内容
• parameters:
  1. [i]const char * tblCtrl: 表格控件名
  2. [i] const char * str: 格式字符串
• return value: 无

virtual void setTableFromClipboard(const char * tblCtrl) = 0

• function: 从剪贴板内容设定表格控件内容
• parameters:
  1. [i]const char * tblCtrl: 表格控件名
• return value: 无

virtual void getTableToClipboard(const char * tblCtrl) = 0

• function: 将表格控件内容复制到及剪贴板
• parameters:
  1. [i]const char * tblCtrl: 表格控件名
• return value: 无

virtual void setTableRowCount(const char * tblCtrl, int rowCount) = 0

• function: 设置表格控件的行数
• parameters:
  1. [i]const char * tblCtrl: 表格控件名
  2. [i] int rowCount: 表格控件的行数
• return value: 无

virtual int getTableRowCount(const char * tblCtrl) = 0

• function: 获取表格控件的行数
• parameters:
  1. [i]const char * tblCtrl: 表格控件名
• return value: 表格控件的行数

virtual void setTableColCount(const char * tblCtrl, int colCount) = 0

• function: 设置表格控件的列数
• parameters:
  1. [i]const char * tblCtrl: 表格控件名
  2. [i] int colCount: 表格控件的列数
• return value: 无

virtual int getTableColCount(const char * tblCtrl) = 0

• function: 获取表格控件的列数
• parameters:
  1. [i]const char * tblCtrl: 表格控件名
• return value: 表格控件的列数

virtual void addTableComboOption(const char * ctrl, int row, int col, const char * o, int v) = 0

• function: 为表格控件指定单元下拉框添加选项（单元控件为下拉框）
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
  4. [i] const char * o: 选项文本
  5. [i] int v: 选项所对应的值
• return value: 无

virtual void setTableChecked(const char * ctrl, int row, int col, bool status) = 0

• function:
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
  4. [i] bool status:
• return value:

virtual void setTableComboInt(const char * ctrl, int row, int col, int value) = 0

• function: 设置表格控件指定单元的当前下拉项（单元控件为下拉框）
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
  4. [i] int value: 当前下拉项的绑定值
• return value: 无

virtual void setTableEditableCombo(const char * ctrl, int row, int col) = 0

• function: 设置表格控件指定单元为下拉框控件
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
• return value: 无

virtual void setTableComboOptions(const char * ctrl, int row, int col, vector<string> * options, const char * curText = 0) = 0

• function: 设置表格控件指定单元的下拉项（单元控件为下拉框）
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
  4. [i] vector<string> * options: 下拉选项
  5. [i] const char * curText = 0: 当前选项文本，如空则不设定当前选项文本
• return value: 无

virtual void setTableEditInt(const char * ctrl, int row, int col, int value, bool bEditable = true) = 0

• function: 设置表格控件指定单元的整型值（单元控件为编辑框）
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
  4. [i] int value: 值
  5. [i] bool bEditable = true: 单元编辑框是否可编辑
• return value: 无

virtual void setTableEditString(const char * ctrl, int row, int col, const char * str, const char * browse = 0, bool bEditable = true) = 0

• function: 设置表格控件指定单元的文本值（单元控件为编辑框）
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
  4. [i] const char * str: 文本字符串
  5. [i] const char * browse = 0: 编辑框是否支持打开文件或目录模式，以“open:*.xml”形式给定
  6. [i] bool bEditable = true:单元编辑框是否可编辑
• return value: 无

virtual void setTableEditDouble(const char * ctrl, int row, int col, real value, bool bEditable = true) = 0

• function: 设置表格控件指定单元的浮点数值
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
  4. [i] real value: 浮点值
  5. [i] bool bEditable = true: 单元是否可编辑
• return value: 无

virtual void setTableLabelString(const char * ctrl, int row, int col, const char * str) = 0

• function: 获取表格控件指定单元的标签文本
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
  4. [o] const char * str: 指定单元的标签文本
• return value: 无

virtual real getTableEditDouble(const char * ctrl, int row, int col, real null_value = 0) = 0

• function: 获取表格控件指定单元的浮点数值
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
  4. [i] real null_value = 0: 如单元为空，返回该默认值
• return value: 指定单元的浮点数值

virtual int getTableComboInt(const char * ctrl, int row, int col, int null_value = 0) = 0

• function: 获取表格控件指定单元的下拉项绑定整型值
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
  4. [i] int null_value = 0: 如下拉项为空，返回该默认值
• return value: 指定单元的下拉项绑定整型值

virtual const char * getTableComboString(const char * ctrl, int row, int col) = 0

• function: 获取表格控件指定单元的下拉项文本
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
• return value: 指定单元的下拉项文本

virtual bool getTableChecked(const char * ctrl, int row, int col) = 0

• function: 获取表格控件指定单元的勾选状态
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
• return value: 指定单元的勾选状态，勾选返回true，否则返回false

virtual int getTableEditInt(const char * ctrl, int row, int col) = 0

• function: 获取表格控件指定单元的整型值
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
• return value: 指定单元内容的整型值

virtual const char * getTableEditString(const char * ctrl, int row, int col) = 0

• function: 获取表格控件指定单元的字符串值
• parameters:
  1. [i]const char * ctrl: 表格控件名
  2. [i] int row: 单元行号
  3. [i] int col: 单元列号
• return value: 字符串值

virtual int getTableCurrentRow(const char * ctrl) = 0

• function: 获取表格控件当前行号
• parameters:
  1. [i]const char * ctrl: 表格控件名
• return value: 如选中行则返回行号，否则返回-1

virtual void adjustTableView(const char * ctrl) = 0

• function: 根据内容调整表格尺寸
• parameters:
  1. [i]const char * ctrl: 表格控件名
• return value: 无

virtual void updateData(bool bSave) = 0

• function: 更新数据
• parameters:
  1. [i]bool bSave:如true，从界面更新到内存变量中；如false，从内存变量中更新到界面；
• return value: 无