Supcan Tree组件


  Supcan Tree组件是一个简单的树控件组件,从MFC的CTreeCtrl类继承,插件/加载项能将其展示到页面。
  树是根据一个XML(或JSON)创建的,该XML可以是一个URL,也可以是一个XML串。

1.创建实例


  Supcan Tree 组件是通过插件/加载项创建的,可以直接调用 dynaload.js 中的函数创建:
insertTree('AF', 'Border=single,3D;  NodeImage=2;  BackPicture=../res/trade.gif')
  其中第二个参数即 “创建参数”,决定了如何在页面上展现 Supcan Tree,创建参数中可包含多个子串,子串间以 ";" 分隔。
  创建参数的名值对的规范如下:
子串名含义可用值默认值
Border边界 1.none - 无边界
2.single - 单线条边界
3.3dLower(或3d) - 3D凹进边界
4.3dRaise - 3D凸起边界
single
BorderColor边界色颜色,仅用于Border=single#7f9db9
Style显示风格 可以包含如下串,同时选用则以逗号分隔:
1.hasButton - 含有展开/收拢的+/-小按钮
2.hasLine - 含有树的连接线
3.hasCheckBox - 左侧含有CheckBox
4.singleExpand - 不能同时展开多个节点
5.showSelAlways - 始终显示当前选择项焦点
6.editLabel - 允许编辑文字
(无)
lineHeight行高像素数19
NodeImage树杈的默认图标-1表示不显示图标,0至3表示采用如下图标中的一个:

也可以是外部自定义的图片文件的URL(支持图片扩展URL)
0
LeafImage树叶的默认图标-1表示不显示图标,0至12表示采用如下图标中的一个:

也可以是外部自定义的图片文件的URL(支持图片扩展URL)
0
bgColor
或BackColor
背景色颜色,如果是以逗号分隔的2个颜色值,则表示在垂直方向的渐变(无)
Picture 或
BackPicture
背景图图片的URL,支持图片扩展URL(无)
arrange背景图片显示方式1.tile - 平铺
2.stretch - 伸展
3.单幅原样显示,须是水平、垂直的对齐组合,水平:left / center / right,垂直:top / middle / bottom,例如"bottom,right"
tile
DragAble是否允许拖拽leaf - 仅树叶能拖拽
node - 仅树杈能拖拽
leaf,node - 全部能拖拽
备注:能支持拖拽的场合不多
(无)
EventLog事件日志文件名,建议后缀是txt, 不必带路径,系统将自动在 BC 目录下创建. 该文件能自动记录本组件实例的所有事件, 用于程序调试.
注:正式运行时请不要使用,因为频繁读写磁盘会导致性能下降.
FuncLog函数调用日志文件名,建议后缀是txt, 不必带路径,系统将自动在 BC 目录下创建. 该文件能自动记录本组件实例被调用的所有函数, 用于程序调试.
注:正式运行时请不要使用,因为频繁读写磁盘会导致性能下降.
FuncParaChars函数日志中参数最大字数数字,当启用函数日志时,函数的参数最多保留字数.128
FuncReturnChars函数日志中返回值最大字数数字,当启用函数日志时,函数的返回值最多保留字数.0
备注1: 所谓“默认值”就是在没有设定值的情况下,Tree自动采用的值.
备注2: 所谓“zip包中的BMP的URL”,写法例如: “http://..../abc.zip#pic1.bmp”
备注3: 上述URL为绝对URL或相对URL