Cols
含义:各列的信息;数量: 1


Col
含义: 列的属性;数量: 1-n, 内容: 列标题文字。如果希望分多行显示,可以直接加回车、或加插"\r\n"
属性名称含义可用值默认值示例
主要name 或 id列名串, 相当于字段名(无) 
isUnique内容是否允许重复true/falsefalse 
注: 用于生成XML提交文档前的唯一性验证
nullAble是否允许为空true/falsetrue
注: 用于生成XML提交文档前的简单验证
defaultValue默认值串, 用于新插入行操作时的初始, 支持以 "=" 开头的表达式,例如 defaultValue="=now( )", 表示将日期型默认值设为当天(无) 
注: 仅对新插入的行有效
dataType数据类型有 string / int / double / bool / date / datetime 这几种string 
decimal小数位数 -1至8, 仅用于 double 型。 -1表示小数位数不确定, 可以在0位和8位之间可以任意输入2 
isHyperlink是否超链接列true/falsefalse
注: 请参见下面的备注2
isHide是否隐藏,true - 隐藏;
false - 显示;
absHide 或 absTrue - 绝对隐藏,不会被鼠标右键菜单选择;
absShow 或 absFalse - 绝对显示,不会被鼠标右键菜单选择;
false
sortAble点击列标题是否执行排序true/falsetrue 
注: 如果<Properties>中的sortAble设为false, 则本sortAble无效(false)
sortOption列的排序选项为如下可选项的组合, 逗号分隔:
byDatabyText - 按数据排序 或 按显示内容排序, 常见的场景是下拉列按照显示的内容排序。 不指定的话(默认)是按数据排序的, 即 byData;
matchCase - 大小写敏感, 不指定的话(默认), 大小写是不敏感的;
recogonizeIntrecogonizeDouble - 辨认出串中的数字, 在左侧字符相同的情况下按数值排序, recogonizeInt 表示辨认整数, recogonizeDouble 则辨认浮点数, 二选一。 如果不指定的话(默认), 数字和其它字符一视同仁, 比如 “长安街10号” 会排在 “长安街9号” 上方;
ignoreComma - 辨认数字过程中, 忽略其中的逗号(千位符);
(无) 
moveAble是否允许列的拖动操作true/falsetrue 
注: 如果<Properties>中的moveAble设为false, 则本moveAble无效(false)
pasteAble是否允许被粘贴
(非编辑状态下)
true - 允许;
false - 不允许;
supcan.xml - 通常是允许,但是当列不可编辑时(包括隐藏时),将以supcan.xml中的 <pasteAbleWhenUnEditAble> 的设定为准;
supcan.xml 
copyExportAble列是否允许被复制、被转换输出true/falsetrue 
注1: "复制" 是指鼠标右键菜单的 "复制当前行";
注2: 如果当前表中有单元格的合并,那么在转换输出时,该选项失效 (相当于全部为 True);
textId指向另一列的列名,显示的内容存放在该列中,是另类 key-value对 的简易字典解决方案列名(无)
autoId当插入行时,能自动生成并填入唯一的值 (仅用于 string, int, double 型字段)对于 int 型、double 型,为 true/false;
对于 string 型,可以为这样格式的串:
  len=[?];Prefix=[?]
len 表示生成的随机串的长度(字数), 范围为1到32之间, Prefix 可选, 表示左侧固定串, 此固定串长度不计入 len
string 也用 true/false 表示,true 等同于 "len=6"
false
注: string 型的随机串是由数字 0-9 和字母 A-Z 混合组成的,每个字符相当于有36种取值, len=6时,其表达范围是36的6次方, 相当于21亿多。如果没有特别的需求,len 建议为 6
自定义属性自定义属性符合变量命名的任意串, 只要不和其它属性重名即可; 此外,允许有多个自定义属性(无) 
外观isThousandSeparat是否以千位符分隔显示true/falsetrue 
注: 仅用于 datatype 为 int 或 double 时
width列宽整数 - 绝对宽度 (单位:像素数);
百分比 - 窗口宽度的百分比, 如:20%;
为小于1的分数 - 比例因子,用于分配剩余的宽度, 如0.2;
fitHeader 或 header - 自动伸展到能使表头标题能够完整显示;
0.1 
注: 请参考开发者指南"Supcan Treelist组件"中的"16.2 关于列宽"
minWidth列的最小宽度像素数10
align水平对齐left / center / right随datatype而变 
vAlign垂直对齐top / vcenter(或middle) / bottomvcenter 
isSpaceIndent前导空格是否用于整体缩进true/falsefalse 
注: 仅用于左对齐时,"整体缩进"表示空格的空白区域整体有效,例如在自动折行显示时
alignHeader列标题文字的对齐left / center / rightcenter 
fontIndex采用的字体数字,指向在<Fonts>中定义的字体的顺序号, 从0开始计数, 等级高于<Properties>中的同名属性-1
headerFontIndex列标题采用的字体数字,指向在<Fonts>中定义的字体的顺序号, 从0开始计数, 等级高于<Properties>中的同名属性加粗的顺序号为0的字体
headerTextColor列标题文字颜色颜色串#000000
headerIcon列标题旁边的小图标
可以是图标的URL, 也可以是如下格式的串:
  url=[?];pos=[?]
pos用于指定图标的位置, 是水平(left/right)、 垂直(top/middle/bottom)方向的组合. 举例如下:
  url=../ac.png;pos=right,bottom
建议采用png或ico这类透明的图片
(无)
headerIconTip鼠标点击上述小图标时弹出的提示文字文字串, 如果不定义这个串,鼠标点击小图标时将触发Clicked事件(无)
displayMask用于显示的格式掩码表达式表达式的内容包括显示内容、 背景色、 文字色、 左图、 右图. 请详见Treelist帮助文档的"3.几个重要的属性"(无)
atLayer位于多层表头的层位置数字,从0开始0
extentRows当以多层表头显示时,该列可跨越多行显示的额外行数数字,从0开始0
dropDisplayType下拉列(droplis, droptreelist)单元格的文字显示方式0 - 仅显示文字部分;
1 - 仅显示键值(即key)部分;
2 - 键值+" - "+文字;
0 
VColSep虚拟列的数据分隔符串,比如"/", 如果设了这个串,在加载数据后,程序将按这个分隔符自动对各行数据进行处理,使其看上去呈现多列的效果。此外, 各个段中纵向、横向如果有连续相同的数据,将自动呈现纵、横的合并效果(无)
注1: 仅改变显示效果,并不改变数据;
注2: VColSep列有诸多限制,例如只能用于string型、不能作为树的排序列等等;
VColSepStyle虚拟列的合并方式row - 只允许跨行的垂直合并;
col - 只允许跨列的横向合并;
row,col - 跨行、跨列自动合并;
row,col 
MouseMoveIn预约鼠标移入单元格的事件数字,毫秒数,表示鼠标在该列的某个单元格上方停留超过此毫秒,即触发名为 "MouseMoveIn" 的事件;0表示不触发鼠标移入事件;0
图片列isImage是否图片列true/falsefalse
注1: 若以图片显示, 内容串将是图片的URL(支持图片扩展URL)、或图片二进制的Base64串;
注2: 如果是相对URL, 是指相对于填入数据的URL, 而不是相对于当前XML文档或当前页面;
注3: 如果是URL, 图片是需要显示时才从URL取得图片数据的, 即所谓即用即下载;
注4: 不建议采用Base64串,因为数据包会很大;
注5: 请参见下面的备注2;
isBase64First当isImage=true时,内容串是否优先认作是图片的Base64大串true/falsefalse 
imageArrange图片展现方式useOriSize - 采用原始尺寸, 且从不缩放, 若单元格太小则显示局部;
full - 能自动缩小(但从不放大), 使其完整显示, 保持长宽比;
stretch - 自动缩放、完整显示, 且全部填满单元格, 不保持长宽比;
stretchKeepRatio - 自动缩放、完整显示、保持长宽比, 长、宽中至少有一个是伸缩到满格的;
useOriSize 
输入editAble是否允许输入true/falsetrue 
注: 其等级低于Properties中的同名属性,也就是说如果 Properties 中的 editAble 为 false,则本editAble无效
editAbleNewRow当上方的editable=false时,新插入行(即非Load的行)的单元格是否可编辑true/falsefalse 
isSelectEditWhenFocus当输入框取得焦点时,光标是否选中全部文字true - 全选;
false - 不选;
auto - 自动, 表示数据类型为int或double时全选;
沿用<Properties>中的同名属性 
editType输入控件类型Edit - 最普通、允许EditMask的编辑;
EditWithButton - 右侧有按钮的Edit;
MultiLineEdit - 多行编辑(默认以Ctrl+Enter换行);
Checkbox/Check - 复选框 (规则请见注1);
RadioButton/Radio - 单选框 (规则请见注2);
Button - 按钮;
Droplist - 下拉列表;
EditAbleDroplist - 可编辑的下拉列表;
Droptreelist - 下拉嵌套的treelist;
EditAbleDroptreelist - 可编辑的下拉嵌套treelist;
Edit
注1: Checkbox显示方式和数据的关系: 单元格数据可以为 1 / 0 / 2 / -1, 分别显示为 选中 / 未选中 / 状态不确定(方框内显示一实框) / 不显示Checkbox;
注2: Radio显示方式和数据的关系: 单元格数据可以为 1 / 0, 分别显示为 选中 / 未选中(也不显示), 如果要显示未选中的radio, 请参考 <Properties> 的 isDrawUncheckedRadio 属性;
maxChars字符串长度限定长度限制,以Unicode计(中英文均以 '字' 为单位)0
注: 不能同时使用maxChars和maxMBytes, 仅用于string型
maxMBytes字符串长度限定长度限制,以字节计(中文算2字节、英文1字节)0
注: 不能同时使用maxChars和maxMBytes, 仅用于string型
max最大值值串(无)
注: 仅用于int、double、date、datetime型
min最小值值串(无)
注: 仅用于int、double、date、datetime型
editmask日期型、数值型的输入掩码对于日期型,例如YYYY.MM.DD hh:mm:ss
对于数值型,例如 ##,###,###.00 (表示千位符分隔、小数点2位)、 +00000 (表示最长5位的正整数)、#,###.#(表示千位符分隔、小数位数不确定)
如左
注1: double型的默认值和小数位数有关,例如decimal=3时,EditMask默认为"#.000";
注2: 仅用于日期型、数值型的输入;
spin输入框内的垂直旋转滚动条:
true/false日期型是true
注: 仅用于int、date、datetime型
spinAsCalendar右侧显示下拉按钮、点击弹出日历true/falsefalse 
注1: 仅用于date、datetime型;
注2: spin="true"才生效;
startDate日期为空时,在输入时的起跳日期(即开始日期)日期串,例如"2015.1.1", 也可以是表达式, 例如=now('%Y-%m-%d')2000.1.1 
注: 仅用于date、datetime型
isWordWrap超宽时是否自动折行true/falsefalse 
注: 仅用于MultiLineEdit
isAutoTrimRight是否自动清空后继的空格true/falsetrue 
注: 仅用于string型
isConvertToZeroIfInputNull当清除输入框内容(比如全选后按 Del 键、Backspace键)时, 是否将单元格的内容转为0 (因为0和null是有区别的)true - 转为0;
false - 仍然为null;
false 
注: 仅用于数值型的Edit
droplistId下拉框的相关联的下拉资源ID串,该ID必须存在于下面的<Droplists>节点中(无)
注1: 仅用于edittype为 droplist / droptreelist / editAbleDroplist / editAbleDropTreelist / editWithButton;
注2: 如果是下拉输入, 则为下拉框的相关联的下拉资源ID;
注3: 如果是EditWithButton, 则用作Key-Value字典(该ID须存在,或用"auto"表示自动创建);
delayBeforeDropdownBeforeDropdown事件重复触发的最短时间差0 
注: 仅用于edittype为 droplist / droptreelist / editAbleDroplist / editAbleDropTreelist
dropdownWidth强制设定下拉窗的宽度像素数或百分比(无) 
注1: 百分比是指相对于列宽;
注2: 仅用于下拉;
dropdownHeight强制设定下拉窗的高度像素数或百分比(无) 
注1: 百分比是指相对于屏幕的高度;
注2: 仅用于edittype为 droptreelist / editAbleDropTreelist;
isDropDownWhenFocus是否得到焦点就自动弹出下拉true/falsefalse 
enable (或enabled)列是否活动状态true - 常态;
false - 该列不可输入, 且以灰色显示;
readonly - 可以进入编辑窗但内容无法被修改, 通常用于 EditWithButton, 其右侧的按钮是 Enable 的
true 
freeInputAble输入内容是否受限true - 可任意输入,内容不受限制;
false - 受Droplist中的dataCol、dispCol限制, 输入内容必须和dataCol、dispCol匹配, 否则输入无效;
false 
注1: 如果EditWithButton绑定了DroplistID,则强制被设为false;
注2: 仅用于EditAbleDropTreelist, editWithbutton;
isCheckboxOnly是否仅仅用于Checkbox选择true/false, 如果是True,则不管 <Properties> 中的"editable"是true还是false,该Checkbox均是可操作的,并且左标尺的鼠标右键有全选、反选等菜单功能false
注1: 仅用于 Checkbox;
注2: 一般不允许有多个 isCheckboxOnly 列;
TreeCombine以树显示时, CheckBox显示在树的第一列, 本列自动隐藏可以包含如下串:
normal - 树杈不允许有复选框;
NodeSelectAble 或 node - 树杈允许有复选框;
AutoSelectChildren 或 auto - 树杈选中后, 将自动影响到其子孙;
false
注1: 仅用于Checkbox 且 isCheckboxObly="true";
注2: 单列多层树、多列多层树均适用; 例如:treeCombine="node,auto";
注3: 仅仅是显示合并,其单元格数据仍然是独立的;
GroupIDRadioButton(单选框)所在的组(无) 
注1: 仅用于 Radio;
注2: GroupId="row"表示纵向选择,即只有一行的值为1;
注3: 如果仅有一个组, 则可忽略;
EditTextId含 TextId 的列的输入方式id - 只能输入 id (即key, 单元格的值);
text - 优先输入 Text
id 
注: 仅用于非下拉的、通过 TextId 映射或通过 SetCellDataText( ) 设置了key-data映射的列
按钮列buttonText按钮上的文字(无)
注: buttonText 和 buttonImg至少要定义一项
buttonImg 或 buttonImage按钮上的小图标URL(无) 
注1: buttonText 和 buttonImg至少要定义一项;
注2: buttonImage除了用于按钮列,也能用于EditWithButton、DropTreelist的右侧的图标;
buttonTip鼠标划过按钮时的Tip文字串(无) 
buttonWidth按钮宽度数字,像素数(无)
buttonHeight按钮高度数字,像素数(无) 
buttonSkin强制指定按钮皮肤windows - 操作系统按钮外观;
default - 自动,与全局色调一致;
flat - 平坦,无按钮边框,常用于仅有图标的情形;
light gray - 浅灰色;
caramel - 焦糖色;
lilian - 百合花色;
lividity - 青黑色;
windows 
关于按钮状态的重要提示:
  按钮在每行的显示和单元格的值有关: 1:正常显示按钮, 0:按钮显示为Disabled, 其它值: 不显示按钮,作为纯文字显示;
关于多按钮:
  一列中允许同时有多个按钮, 如右图所示.
  上述buttonText、buttonTip、buttonImg、buttonWidth的内容只要用逗号(,)分隔即可,例如: buttonText="审核, 不审核" buttonWidth="50, 70".
  关于决定按钮状态的单元格的值, 可以采用单一的 0 或 1 整体决定其 disable / enable 状态, 也可以是 string 型的字段, 以逗号分隔多个 0/1 , 为本行的每个按钮设置状态.
合计
小计
totalExpress
subtotalExpress
合计/小计表达式表达式(无)
注1: 表达式可以包含 @开头的宏, 如 @sum、@rows, 请参见《开发者指南》中的“公共内容”的“3.宏”中的“合计宏”;
注2: 表达式可以包含 @开头的其它列的列名, 表示取当前小计范围中第一个明细行中某列的内容;
注3: 表达式可以包含 其它列的列名, 表示取同一行中其它列的内容;
totalAlign
subtotalAlign
合计/小计的水平对齐left / center / rightright
totalDecimal
subtotalDecimal
合计/小计保留的小数位数0 至 8与当前列一致 
多个合计行的语法:
  允许有多个独立的合计行,命名规则为 totalExpress1、 totalExpress2...类推, totalAlign 和 totalDecimal 也可按这个规则书写

备注1: 上述列标题、buttonText,允许以"|"分隔中英文(用于中英文切换);
备注2: isHyperLink、isImage的列,如果加载的单元格数据以特征串 “[NoEffect]” 开头(大小写敏感),表示该单元格以普通文字显示,特征串 [NoEffect] 使用范围为:
  1.仅用于初始数据;
  2.对 SetCellData( ) 函数设置的值无效;
  3.该特征串在加载时能被自动识别、摘除,不会出现在单元格中;