Properties

含义: TreeList属性；数量: 0-1
属性名称 | 含义 | 可用值 | 默认值 | 示例
基本 | id | Treelist的ID | 串 | (无) |
注: 用于 GetChangedXML( ) 生成XML提交串，相当于是告诉应用服务器，当前提交的是什么表单
key | 主键 | 串, 下面<cols>中的列名，若是复合主键，则列名之间须以逗号分隔 | 见注2 |
注1: key 用于 GetChangedXML( ) 生成XML提交串; 注2: 通常情况下 key 是没有默认值的，但当 treeformat="byId" 时，默认值是第一列的列名; 当 treeformat="byPid" 时，默认值是"id"
dataURL | 填入数据的默认URL | URL串, 绝对或相对 | (无) |
注: 也可以是以“=”开头的表达式, 表达式的通常用于分页、或下拉嵌入的树列表
XMLNodeName | 指定XML/JSON中的数据节点 | 节点名, 不太常用 | (无) |
editAble | 是否允许增删改操作 | true/false | false |
注: 并不影响增删改的API
addRowAble | 是否允许用户增行操作 | true/false | true |
注1: 仅在editAble=true时生效; 注2: 不影响增删改的API;
deleteRowAble | 是否允许用户删行操作 | true/false | true |
注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/false | false |
注：在执行 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 | 是否显示未选中的Radio | true/false | false |
CheckBoxColor | Checkbox的颜色 | 逗号分隔的7个颜色，分别是边框色、打勾的颜色、3态的实心矩形填充色、Disable状态的前面三种的颜色、整体填充色(T或-1表示透明), 默认是: #8C5809,#400000,#007850,#C8C8C8,#808080,#787878,#FFFFFF | 如左 |
isHiLightModified 或 isHighLightModified | 修改过的单元格, 是否在其左上角显示一个醒目的标记 | true/false | false |
isHiLightNewRow 或 isHighLightNewRow | 新增行, 是否在左标尺的左上角显示一个醒目的标记 | true/false | false |
disableRowFlag | 指定disable行的标记 | gray - 灰色显示; deleteline - 删除线; none - 无标记; | gray |
isAnimateFocus | 当 curSelMode=excel 时, 切换焦点是否采用 Office 2013 样式的动画 | true/false | false |
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/false | false |
isShowRuler | 是否显示左标尺 | true/false | 见备注2 |
leftColor 或 leftBgColor 或 leftBackColor | 左标尺的背景色 | 颜色串，可以是以逗号分隔的多个颜色(渐变) | (无) |
leftWidth | 左标尺的宽度 | 像素数 | 35 |
注: 该宽度并非一成不变，当行数增多时，宽度会自动加长
RulerLineColor | 左、上标尺的分隔线颜色 | 颜色串, 为空表示采用默认颜色 | (空) |
外 观 3 (表 格 线) | GridColor | 表格线颜色 | 颜色串 | (无) |
GridStyle | 表格线样式 | solid / dash / dot / dashdot | solid |
isShowGridVert | 是否显示垂直表格线 | true/false | true |
isShowGridHor | 是否显示水平表格线 | true/false | true |
isShowGrid | 是否显示表格线 | true/false | true |
注: 同时考虑了垂直、水平表格线
树 | isTree | 是否以树展现 | true/false | false |
ListTreeSwitchAble | 是否允许在 列表 和 树 之间任意切换 | true/false | true |
treeFormat | 树的格式 | normal - 普通多列多层树; byid - 以第一列作为代码的单列多层树; bydata - 数据本身就呈树状的单列多层树; byPid - 用pid指定父id的单列多层树; | normal |
注: 详见开发者指南中的"Supcan Treelist组件"中的"7.树"
isShowTreeLine | 是否显示树的连接线 | true/false | true |
TreeNodeButton | 树的展开合拢按钮 | 逗号分隔的2个URL, 分别表示合拢、展开时的图标. 默认值是 "!Bmp/TreeNodeClose.bmp, !Bmp/TreeNodeExpand.bmp", 表示是系统内置的图片 | 如左描述 |
isShowGridTreeNode | 是否显示树叉单元格的表格线 | true/false | false |
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/false | true |
isFrozenWhenSeparate 或 isFrozen | 分屏后，右窗的水平滚动是否冻结 | true/false | true |
注: 为true时水平滚动条将滚不到被冻结的列
行为 | isAutoFitWidth | 是否能自动扩展列宽而填充整个窗口 | true/false | false |
sortAble | 点击列标题是否执行排序 | true/false | true |
multiSortAble | 是否允许多重排序操作 | true/false | true |
moveAble | 是否允许拖拽标题交换列的次序 | true/false | true |
multiLayerAble | 是否允许鼠标拖拽为多层表头 | true/false | true |
dragPitchAble | 是否允许鼠标拖拽让窗口内容作上下左右滚动 (相当于滚动条的作用) | true/false | true |
IsTipOmit | 如果单元格文字显示不全，鼠标划过时是否自动弹出显示完整内容的Tip | true/false | true |
ExpandMore | 以树显示、点击树杈后，是否连带展开其所有子孙树杈 | true/false | true |
isSelectEditWhenFocus | 当输入框取得焦点时，光标是否选中全部文字 | true - 全选; false - 不选; auto - 自动 (int 和 double 类型全选); | auto |
enter | 回车键的行为 (仅用于在输入时) | Right/Down - 光标向右/向下跳转 | right |
autoUpdate | 输入行为 | true/false - 是否直接更新到 Treelist | false |
注: 下拉Treelist列在选中后, 是否立即将所选数据更新到Treelist中, 默认情况下, 并不将数据更新到Treelist中, 因为可以敲 Esc 键反悔
leftMost | 输入框内光标位于最左侧时, 向左键的行为 (仅用于在输入时) | none - 无动作; priorCell - 跳转到前一个输入框; priorCellLine - 跳转到前一个输入框，如果已经是第一列，则跳到上一行; | none |
rightMost | 输入框内光标位于最右侧时, 向右键的行为 (仅用于在输入时) | none - 无动作; nextCell - 跳转到下一个输入框; nextCellLine - 跳转到下一个输入框，如果已经是最后列，则跳到下一行; | none |
autoRevertScroll | 在第一行/最后一行按Up/Down键后，是否上下翻转当前行 | true/false | false |
OpenEditMode | 当 curSelMode=excel 时, 进入编辑状态的模式 | dblClick - 鼠标双击进入编辑; Click - 鼠标单进入编辑; | dblClick |
DropDataLoadMode | 下拉数据的加载模式 | asynch/synch - 异步/同步 | asynch |
注1: "下拉数据"即<Droplists>下的需要加载外部数据的所有下拉资源; 注2: 数据异步加载后，会触发 DropDownDataReach 事件;
CheckMode | isCheckboxOnly=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 / Right | center |
subTitleAlign | 副标题水平对齐 | Left / Center / Right | center |
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/false | false |

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/false | false |
注: 如果为true, 在鼠标点击列头时, 将抛出Sort事件

备注1: 上述dataURL、ref如果是相对URL，那么是相对于当前XML文件，而不是页面URL;
备注2: editAble=true时，isShowRuler的默认值是true，否则是false;
备注3: isTree=true时，如果不定义sort，那么默认将第一列当作树的排序列;
备注4: 上述Title、SubTitle，允许以"|"分隔中英文(用于中英文切换);