Properties
含义: TreeList属性;数量: 0-1
属性名称含义可用值默认值示例
基本idTreelist的ID(无) 
注: 用于 GetChangedXML( ) 生成XML提交串,相当于是告诉应用服务器,当前提交的是什么表单
key主键串, 下面<cols>中的列名,若是复合主键,则列名之间须以逗号分隔见注2
注1: key 用于 GetChangedXML( ) 生成XML提交串;
注2: 通常情况下 key 是没有默认值的,但当 treeformat="byId" 时,默认值是第一列的列名; 当 treeformat="byPid" 时,默认值是"id"
dataURL填入数据的默认URLURL串, 绝对或相对(无)
注: 也可以是以“=”开头的表达式, 表达式的通常用于分页、或下拉嵌入的树列表
XMLNodeName指定XML/JSON中的数据节点节点名, 不太常用(无) 
editAble是否允许增删改操作true/falsefalse
注: 并不影响增删改的API
addRowAble是否允许用户增行操作true/falsetrue
注1: 仅在editAble=true时生效;
注2: 不影响增删改的API;
deleteRowAble是否允许用户删行操作true/falsetrue
注1: 仅在editAble=true时生效;
注2: 不影响增删改的API;
sort默认排序表达式串, 语法如下: "列名1 [a/d], 列名2 [a/d], ...", 例如: sort = "price a, city d"
此外,还支持用 "{ ... } " 包绕的静态排序,例如:sort = "{price a, city d}", "静态排序列"表示始终优先按这些列排序,当用户点击其它列的列标题时,不影响静态排序列,只是在静态排序的基础上再作"子排序".
(无)
unique某些列的内容是否允许重复用加号(+)分隔列,用于生成XML提交文档前的唯一性验证, 例如"ProdId+MatId", 表示这2个列的复合内容不得重复. 如果有多组内容各自不得重复, 则以逗号分隔, 例如 "ProdId+MatId, factId+ProdId, BillId", 里面有独立的3个组(无)
注: 和<Col>中的 isUnique 类似,但isUnique仅限于单列
isParseDigit加载double/int型字段数据时, 是否允许从混合的串中挑出纯数字true/falsefalse
注:在执行 Load 函数时, 假如数据中某字段的原始串是 “重量为2.3吨”, 如果 isParseDigit = true, 那么该单元格的数据是拆解后的 2.3, 否则不拆解(即为 0)
ref引用外部XML描述文件外部XML文件的URL, 可以是相对URL, 本<Properties> 和下属节点 (<Expresses> 和 <Validations> 除外) 的内容将来自该文件, 实现类似页面 CSS 的统一置换功能(无) 
注: 如果本XML文档和外部的XML文档同时定义了某个属性, 则优先使用本文档中定义的属性值
自定义属性自定义属性符合变量命名的任意串, 不和文档中的其它属性重名即可, 且可定义多个自定义属性(无) 
注: GetChangedXML( ) 函数输出的XML中将包含自定义属性, 并可以用SetProp( )、GetProp( )函数存取自定义属性


1
rowHeight行高像素数19
fontIndex指定默认字体<Fonts>中的字体顺序号, 不太常用-1 
注: 等级低于<Col>中的同名属性
textColor文字颜色颜色串#000000
bgColor 或 backColor背景色颜色串,也可以是以逗号分隔的2个颜色(渐变填充), 建议写在 <Background> 中, 此处为兼容老版本(无) 
displayMask整行的背景色、文字色表达式表达式, 如:
displayMask = "bgColor=if(price=0, red, transparent); textColor=if(price>2,#000022, blue)"
注意:上面的大于(>)符号, 在XML中要写成 &gt;
(无)
cellPadding文字和表格线之间的最小距离像素数, 对对齐处生效,例如文字是左对齐的,就表示文字左侧离表格线的距离,依此类推1
autoBreakLine文字显示的超宽处理0 或 breakLine - 自动换行、缩小字体, 换行优先;
1 或 none - 不处理;
2 或 shrinkFont 或 smallFont - 自动缩小字体、换行, 缩小字体优先;
3 或 breakLineOnly - 自动换行, 但不缩小字体;
0 
TextEllipsis超宽时是否显示省略符1 - 显示省略符(即...);
0 - 不显示;
1 
alternateColor斑马线色颜色串(无)
curSelMode当前行或区域的显示模式row - 单行选择,以深底色标记;
rows - 允许多行选择(Ctrl、shift+鼠标);
excel - 类似excel的区域选择方式;
row
curSelBackColor 或 curSelBgColor 或 curSelColor当前行的颜色,允许多个颜色渐变颜色串, 支持ARGB格式,例如: "#10C0D0E0", 其中前2位( "10" )是 alpha(即透明度), 后6位( "C0D0E0" ) 是 RGB, 透明度的值的范围也和颜色一样, 是从0到255(对应到16进制就是00到FF).
“当前行颜色”好比是一层薄纱,叠加在当前行的上方,这层纱的透明度决定了颜色的浓淡,比如:
 curSelBgColor="#20000000", 效果是覆盖了一层淡淡的黑色;
 curSelBgColor="#EE000000", 效果是覆盖了一层深深的黑色;
此外, 还支持包含如下边框属性:
  borderWidth - 边框线宽
  borderColor - 边框线色
  borderRound - 边框线的圆角直径
示例: "#12FFFFFF,#22EEFFEE; borderWidth=1; borderColor=red; borderRound=8"
#14101020
isDrawUncheckedRadio是否显示未选中的Radiotrue/falsefalse 
CheckBoxColorCheckbox的颜色逗号分隔的7个颜色,分别是边框色、打勾的颜色、3态的实心矩形填充色、Disable状态的前面三种的颜色、整体填充色(T或-1表示透明), 默认是:
  #8C5809,#400000,#007850,#C8C8C8,#808080,#787878,#FFFFFF
如左
isHiLightModified 或 isHighLightModified修改过的单元格, 是否在其左上角显示一个醒目的标记true/falsefalse
isHiLightNewRow 或 isHighLightNewRow新增行, 是否在左标尺的左上角显示一个醒目的标记true/falsefalse
disableRowFlag指定disable行的标记gray - 灰色显示;
deleteline - 删除线;
none - 无标记;
gray
isAnimateFocus当 curSelMode=excel 时, 切换焦点是否采用 Office 2013 样式的动画true/falsefalse 
fadeInStep执行 Load( ) 函数时的淡入淡出效果0 - 255, 数值越小效果越明显, 而 0 表示关闭此效果20 
fadeInPager绑定分页器时前后页切换的淡入淡出效果none - 关闭淡入淡出效果;
cross - 前后页交替渐变;
flash - 快速点亮效果
cross
innerShadow内凹陷阴影上、下、左、右边框处的凹陷阴影, 默认是: "top.width=6; top.alpha=25; left.width=2; left.alpha=33", 其中width表示阴影大小, alpha表示阴影的Alpha值(0-255), 数字越大越浓如左 
freeform嵌入freeform,作为整行的显示、输入Freeform的URL(无)


2
(标
尺)
headerHeight顶部标题条(即上标尺)的高度像素数24
headerColor 或 headerBgColor 或 headerBackColor顶部标题条(即上标尺)的背景色颜色串,可以是以逗号分隔的多个颜色(渐变)(无)
headerFontIndex指定标题栏(即上标尺)默认字体<Fonts>中的字体顺序号-1
注: 等级低于<Col>中的同名属性
isShowSortPanel是否显示顶部的多重排序区true/falsefalse
isShowRuler是否显示左标尺true/false见备注2 
leftColor 或 leftBgColor 或 leftBackColor左标尺的背景色颜色串,可以是以逗号分隔的多个颜色(渐变)(无)
leftWidth左标尺的宽度像素数35 
注: 该宽度并非一成不变,当行数增多时,宽度会自动加长
RulerLineColor左、上标尺的分隔线颜色颜色串, 为空表示采用默认颜色(空)


3
(表

线)
GridColor表格线颜色颜色串(无)
GridStyle表格线样式solid / dash / dot / dashdotsolid 
isShowGridVert是否显示垂直表格线true/falsetrue
isShowGridHor是否显示水平表格线true/falsetrue
isShowGrid是否显示表格线true/falsetrue
注: 同时考虑了垂直、水平表格线
isTree是否以树展现true/falsefalse
ListTreeSwitchAble是否允许在 列表 和 树 之间任意切换true/falsetrue 
treeFormat树的格式normal - 普通多列多层树;
byid - 以第一列作为代码的单列多层树;
bydata - 数据本身就呈树状的单列多层树;
byPid - 用pid指定父id的单列多层树;
normal
注: 详见开发者指南中的"Supcan Treelist组件"中的"7.树"
isShowTreeLine是否显示树的连接线true/falsetrue
TreeNodeButton树的展开合拢按钮逗号分隔的2个URL, 分别表示合拢、展开时的图标.
默认值是 "!Bmp/TreeNodeClose.bmp, !Bmp/TreeNodeExpand.bmp", 表示是系统内置的图片
如左描述
isShowGridTreeNode是否显示树叉单元格的表格线true/falsefalse 
TreeNodeBackColor不同级次的树杈的背景色逗号分隔的颜色串, 依次表示第一级,第二级,...各级颜色, 中间如果有不需要定义的颜色, 可用 -1 代替(无)
TreeNodeTextColor不同级次的树杈的文字色逗号分隔的颜色串, 依次表示第一级,第二级,...各级颜色, 中间如果有不需要定义的颜色, 可用 -1 代替(无)
TreeNodeFontIndex不同级次的树杈的字体逗号分隔的字体序号, 依次表示第一级,第二级,...各级的 fontIndex, 中间如果有不需要定义的字体, 可用 -1 代替(无)
单列多层树treeImageLeaf树叶的图标图片URL(无)
TreeImageNodeExpand
TreeImageNodeCollapse
树杈展开/合拢时的图标图片URL(无)
LazyLoad默认的懒加载方式true - 不能确定是否含子孙,显示树杈标记,鼠标点击标记时抛出 "LazyLoad" 事件,需要通过加载数据来即时判断;
false - 默认非树杈;
URL串 - 不能确定是否含子孙,显示树杈标记,鼠标点击标记时自动从该URL加载数据,该URL通常为一表达式;
false
注: 仅用于单列多层树



SeparateBarStyle分屏方式true - 始终显示分隔条;
false - 始终不显示分隔条;
auto - 自动(超宽时会在左侧浮现分隔条);
auto 
SeparateBar分屏,将窗口分裂为左右二个部分(类似"冻结")列名或列序号,在该列处分屏(无)
isHideLeftScrollBar 或 isHideLeftScroll分屏后,是否隐藏左窗的水平滚动条true/falsetrue 
isFrozenWhenSeparate 或 isFrozen分屏后,右窗的水平滚动是否冻结true/falsetrue 
注: 为true时水平滚动条将滚不到被冻结的列
行为isAutoFitWidth是否能自动扩展列宽而填充整个窗口true/falsefalse
sortAble点击列标题是否执行排序true/falsetrue 
multiSortAble是否允许多重排序操作true/falsetrue 
moveAble是否允许拖拽标题交换列的次序true/falsetrue 
multiLayerAble是否允许鼠标拖拽为多层表头true/falsetrue 
dragPitchAble是否允许鼠标拖拽让窗口内容作上下左右滚动 (相当于滚动条的作用)true/falsetrue
IsTipOmit如果单元格文字显示不全,鼠标划过时是否自动弹出显示完整内容的Tiptrue/falsetrue 
ExpandMore以树显示、点击树杈后,是否连带展开其所有子孙树杈true/falsetrue 
isSelectEditWhenFocus当输入框取得焦点时,光标是否选中全部文字true - 全选;
false - 不选;
auto - 自动 (int 和 double 类型全选);
auto 
enter回车键的行为 (仅用于在输入时)Right/Down - 光标向右/向下跳转right 
autoUpdate输入行为true/false - 是否直接更新到 Treelistfalse
注: 下拉Treelist列在选中后, 是否立即将所选数据更新到Treelist中, 默认情况下, 并不将数据更新到Treelist中, 因为可以敲 Esc 键反悔
leftMost输入框内光标位于最左侧时, 向左键的行为 (仅用于在输入时)none - 无动作;
priorCell - 跳转到前一个输入框;
priorCellLine - 跳转到前一个输入框,如果已经是第一列,则跳到上一行;
none 
rightMost输入框内光标位于最右侧时, 向右键的行为 (仅用于在输入时)none - 无动作;
nextCell - 跳转到下一个输入框;
nextCellLine - 跳转到下一个输入框,如果已经是最后列,则跳到下一行;
none 
autoRevertScroll在第一行/最后一行按Up/Down键后,是否上下翻转当前行true/falsefalse 
OpenEditMode当 curSelMode=excel 时, 进入编辑状态的模式dblClick - 鼠标双击进入编辑;
Click - 鼠标单进入编辑;
dblClick 
DropDataLoadMode下拉数据的加载模式asynch/synch - 异步/同步asynch
注1: "下拉数据"即<Droplists>下的需要加载外部数据的所有下拉资源;
注2: 数据异步加载后,会触发 DropDownDataReach 事件;
CheckModeisCheckboxOnly=true 的列的checkbox交互模式checkbox - 鼠标需要精确点击到 checkbox 方框中;
row - 鼠标单击该行即可;
checkbox 
注: 仅用于 curSelMode=row 的情形
editFreeformId用于对话框输入的Freeform资源的id在<FreeformRes>中的freeform的id(无)
editFreeformKey打开Freeform对话框的动作可以从dblClicked,enter,space选取,逗号分隔dblClicked,enter 
editFreeformMode打开何种Freeform对话框可以是 inner, model, 分别表示内嵌对话框、弹出的模式对话框inner 
打印简易配置title标题(无)
subTitle副标题(无) 
titleAlign标题水平对齐Left / Center / Rightcenter 
subTitleAlign副标题水平对齐Left / Center / Rightcenter 
oriantation打印纸方向Portrait - 纵向;
Landscape - 横向;
Portrait 
scale打印缩放比例10至300之间的数字,含义为百分比100 
PaperBorder.left
PaperBorder.right
PaperBorder.top
PaperBorder.bottom
打印纸边界数字(单位:毫米)15 
建议在<PrintPage>中设置打印配置,上述简易配置仅是为了兼容老版本。如果在<PrintPage>中有配置,上述简易配置将自动失效
小计合计totalFontIndex
subTotalFontIndex
合计/小计行的字体顺序号数字, 指向<Fonts>中的字体资源-1
totalBgColor
subTotalBgColor
合计/小计行的背景色颜色串(无)
totalTextColor
subTotalTextColor
合计/小计行的文字色颜色串(无) 
isFixTotalRow 或 isTotalRowFixed合计行是否固定在底部、始终显示true/falsefalse
totalOption合计/小计的其它选项格式为: "isIncludeHideRow=?; isIncludeMergedCell=?; verticalLine=?; isKeepTotalrowAlways=?"
isIncludeHideRow - 表示是否包含被隐藏的行,默认是true;
isIncludeMergedCell - 表示是否包含被组合的单元格(左上角主单元格除外),默认是true;
verticalLine - 表示 isFixTotalRow=true时, 底部合计和上方表体之间的空白区的垂直线绘制方式, 可以是: normal-绘制; none-不绘制; dotline-虚线绘制, 默认是normal;
isKeepTotalrowAlways - 是否始终显示合计行, 当为false时, 表示没有记录时将不显示合计行, 默认是true;
如左 
分页动态加载pageRows每次加载行数数字100
totalRows取得数据总行数的URL相对或绝对URL, 服务器返回的响应必须是数字(即总行数), 或包含数字的XML、JSON,不太常用(无)
dataURL分页取数的URL就是前面提到的dataURL, 但是必须包含@宏变量, 例如: "../get1.aspx?st=@startRow&count=@rows", 其中宏变量@startRow、@rows分别表示开始行、要索取的行数(无)
IsRemoteSort当用户试图执行排序操作时, 是否让服务器来完成排序true/falsefalse
注: 如果为true, 在鼠标点击列头时, 将抛出Sort事件
备注1: 上述dataURL、ref如果是相对URL,那么是相对于当前XML文件,而不是页面URL;
备注2: editAble=true时,isShowRuler的默认值是true,否则是false;
备注3: isTree=true时,如果不定义sort,那么默认将第一列当作树的排序列;
备注4: 上述Title、SubTitle,允许以"|"分隔中英文(用于中英文切换);