<?xml version='1.0' encoding='utf-8' ?>
<root>
<elements name="Properties" meaning="TreeList属性" number="0-1">
<element name="id" meaning="Treelist的ID">
	<category>主要</category>
	<group>基本</group>
	<value>串</value>
	<memo>用于GetChangedXML( )生成XML提交串，相当于是告诉应用服务器，当前提交的是什么表单</memo>
</element>
<element name="key" meaning="主键">
	<category>主要</category>
	<group>基本</group>
	<value>串, 下面&amp;lt;col&amp;gt;的列名，复合主键须以逗号分隔</value>
	<memo>用于GetChangedXML( )生成XML提交串</memo>
	<example>20.提交修改内容</example>
</element>
<element name="isTree" meaning="是否以树展现">
	<category>主要</category>
	<group>基本</group>
	<datatype>bool</datatype>
	<default>false</default>
	<example>5.图文并茂(2)</example>
</element>
<element name="treeFormat" meaning="树的格式">
	<category>主要</category>
	<group>基本</group>
	<value meaning="普通多列多层树">normal</value>
	<value meaning="以第一列作为代码的单列多层树">byid(或id)</value>
	<value meaning="数据本身就呈树状的单列多层树">bydata(或data)</value>
	<value meaning="用pid指定父id的单列多层树">byPid(或pid)</value>
	<default>normal</default>
	<memo>详见开发者指南中的"Supcan Treelist组件"中的"7.树"</memo>
	<example>14.单列多层树(一)，15.单列多层树(二)</example>
</element>
<element name="dataURL" meaning="填入数据的默认URL">
	<category>主要</category>
	<group>基本</group>
	<value>URL串, 绝对或相对</value>
	<memo>也可以是以“=”开头的表达式, 表达式的通常用于分页、或下拉嵌入的树列表</memo>
	<example>6.引用外部Treelist、10.可编辑的下拉</example>
</element>
<element name="XMLNodeName" meaning="指定XML/JSON中的数据节点">
	<category>数据</category>
	<group>基本</group>
	<value>节点名, 不太常用</value>
</element>
<element name="editAble" meaning="是否允许增删改操作">
	<category>主要</category>
	<group>基本</group>
	<datatype>bool</datatype>
	<default>false</default>
	<example>5.图文并茂(2)、12.事件</example>
	<memo>并不影响增删改的API</memo>
</element>
<element name="addRowAble" meaning="是否允许用户增行操作">
	<category>主要</category>
	<group>基本</group>
	<datatype>bool</datatype>
	<default>true</default>
	<example>12.事件</example>
	<memo>仅在editAble=true时生效</memo>
	<memo>不影响增删改的API</memo>
</element>
<element name="deleteRowAble" meaning="是否允许用户删行操作">
	<category>主要</category>
	<group>基本</group>
	<datatype>bool</datatype>
	<default>true</default>
	<example>12.事件</example>
	<memo>仅在editAble=true时生效</memo>
	<memo>不影响增删改的API</memo>
</element>
<element name="sort" meaning="默认排序表达式">
	<category>数据</category>
	<group>基本</group>
	<value>串, 语法如下: "列名1 [a/d], 列名2 [a/d], ...",  例如:"price a, city d"</value>
	<example>12.事件、13.分类汇总</example>
</element>
<element name="ListTreeSwitchAble" meaning="是否允许在 列表 和 树 之间任意切换">
	<category>行为</category>
	<group>基本</group>
	<datatype>bool</datatype>
	<default>true</default>
</element>
<element name="unique" meaning="某些列的内容是否允许重复">
	<category>数据</category>
	<group>基本</group>
	<value>用加号(+)分隔列，用于生成XML提交文档前的唯一性验证, 例如"ProdId+MatId", 表示这2个列的复合内容不得重复. 如果有多组内容各自不得重复, 则以逗号分隔, 例如 "ProdId+MatId, factId+ProdId, BillId", 里面有独立的3个组</value>
	<memo>和&amp;lt;Col&amp;gt;中的 isUnique 类似，但isUnique仅限于单列</memo>
	<example>12.事件、13.分类汇总</example>
</element>
<element name="ref" meaning="引用外部XML描述文件">
	<category>外观</category>
	<group>基本</group>
	<value>外部XML文件的URL, 可以是相对URL, 本&amp;lt;Properties&amp;gt; 和下属节点 (&amp;lt;Expresses&amp;gt; 和 &amp;lt;Validations&amp;gt; 除外) 的内容将来自该文件, 实现类似页面 CSS 的统一置换功能</value>
	<memo>如果本XML文档和外部的XML文档同时定义了某个属性, 则优先使用本文档中定义的属性值</memo>
</element>
<element name="自定义属性" meaning="自定义属性">
	<category>外观</category>
	<group>基本</group>
	<value>符合变量命名的任意串, 不和文档中的其它属性重名即可, 且可定义多个自定义属性</value>
	<memo>GetChangedXML( )函数输出的XML中将包含自定义属性, 并可以用SetProp( )、GetProp( )函数存取自定义属性</memo>
</element>


<element name="rowHeight" meaning="行高">
	<category>外观</category>
	<group>外观</group>
	<datatype>int</datatype>
	<value>像素数</value>
	<default>19</default>
	<example>5.图文并茂(2)、8.多种掩码输入、12.事件、16.行的复选</example>
</element>
<element name="headerHeight" meaning="顶部标题条的高度">
	<category>外观</category>
	<group>外观</group>
	<datatype>int</datatype>
	<value>像素数</value>
	<default>24</default>
	<example>16.行的复选</example>
</element>
<element name="headerColor/headerBgColor/headerBackColor" meaning="顶部标题条的背景色">
	<category>外观</category>
	<group>外观</group>
	<value>颜色串，可以是以逗号分隔的多个颜色(渐变)</value>
	<example>3.多层表头、16.行的复选</example>
</element>
<element name="leftColor/leftBgColor/leftBackColor" meaning="左标尺的背景色">
	<category>外观</category>
	<group>外观</group>
	<value>颜色串，可以是以逗号分隔的多个颜色(渐变)</value>
</element>
<element name="leftWidth" meaning="左标尺的宽度">
	<category>外观</category>
	<group>外观</group>
	<value>像素数</value>
	<default>35</default>
	<memo>该宽度并非一成不变，当行数增多时，宽度会自动加长</memo>
</element>
<element name="textColor" meaning="文字颜色">
	<category>外观</category>
	<group>外观</group>
	<datatype>color</datatype>
	<value>颜色串</value>
	<default>#000000</default>
	<example>16.行的复选</example>
</element>
<element name="bgColor/backColor" meaning="背景色">
	<category>外观</category>
	<group>外观</group>
	<value>颜色串，也可以是以逗号分隔的2个颜色(渐变填充), 建议写在 &amp;lt;Background&amp;gt; 中, 此处为兼容老版本</value>
</element>
<element name="alternateColor" meaning="斑马线色">
	<category>外观</category>
	<group>外观</group>
	<datatype>color</datatype>
	<value>颜色串</value>
	<example>8.多种掩码输入</example>
</element>
<element name="curSelMode" meaning="当前行或区域的显示模式">
	<category>外观</category>
	<group>外观</group>
	<value meaning="单行选择,以深底色标记">row</value>
	<value meaning="允许多行选择(Ctrl、shift+鼠标)">rows</value>
	<value meaning="类似excel的区域选择方式">excel</value>
	<default>row</default>
	<example>8.多种掩码输入、21.4种提交级别</example>
</element>
<element name="curSelBackColor/curSelBgColor/curSelColor" meaning="当前行的颜色，允许多个颜色渐变">
	<category>外观</category>
	<group>外观</group>
	<value>颜色串, 支持ARGB格式，例如: "#10C0D0E0", 其中 "10" 是 alpha(透明度), "C0D0E0" 是 RGB, 此外, 还支持包含如下边框属性：</value>
	<value>　　borderWidth - 边框线宽</value>
	<value>　　borderColor  - 边框线色</value>
	<value>　　borderRound - 边框线的圆角直径</value>
	<value>示例: "#12FFFFFF,#22EEFFEE; borderWidth=1; borderColor=red; borderRound=8"</value>
	<default>#14101020</default>
	<example>12.事件、16.行的复选</example>
</element>
<element name="displayMask" meaning="整行的背景色、文字色表达式">
	<category>外观</category>
	<group>外观</group>
	<value>表达式, 如:</value>
	<value>displayMask = "bgColor=if(price=0, red, transparent); textColor=if(price>2,#000022, blue)"</value>
	<example>24.动态更改属性</example>
</element>
<element name="isShowRuler" meaning="是否显示左标尺">
	<category>外观</category>
	<group>外观</group>
	<datatype>bool</datatype>
	<default>见备注</default>
</element>
<element name="isShowGridVert" meaning="是否显示垂直表格线">
	<category>外观</category>
	<group>外观</group>
	<datatype>bool</datatype>
	<default>true</default>
	<example>16.行的复选</example>
</element>
<element name="isShowGridHorz" meaning="是否显示水平表格线">
	<category>外观</category>
	<group>外观</group>
	<datatype>bool</datatype>
	<default>true</default>
	<example>12.事件、16.行的复选</example>
</element>
<element name="isShowGridTreeNode" meaning="是否显示树叉单元格的表格线">
	<category>外观</category>
	<group>外观</group>
	<datatype>bool</datatype>
	<default>false</default>
</element>
<element name="GridColor" meaning="表格线颜色">
	<category>外观</category>
	<group>外观</group>
	<datatype>color</datatype>
	<value>颜色串</value>
</element>
<element name="GridStyle" meaning="表格线样式">
	<category>外观</category>
	<group>外观</group>
	<value>solid / dash / dot / dashdot</value>
	<default>solid</default>
</element>
<element name="fontIndex" meaning="指定默认字体">
	<category>外观</category>
	<group>外观</group>
	<datatype>int</datatype>
	<value>&amp;lt;Fonts&amp;gt;中的字体顺序号, 不太常用</value>
	<memo>等级低于&amp;lt;Col&amp;gt;中的同名属性</memo>
	<default>-1</default>
</element>
<element name="headerFontIndex" meaning="指定标题栏默认字体">
	<category>外观</category>
	<group>外观</group>
	<datatype>int</datatype>
	<value>&amp;lt;Fonts&amp;gt;中的字体顺序号</value>
	<memo>等级低于&amp;lt;Col&amp;gt;中的同名属性</memo>
	<default>-1</default>
	<example>1.感受Treelist</example>
</element>
<element name="disableRowFlag" meaning="指定disable行的标记">
	<category>外观</category>
	<group>外观</group>
	<value meaning="灰色显示">gray</value>
	<value meaning="删除线">deleteline</value>
	<value meaning="无标记">none</value>
	<default>gray</default>
	<example>28.下拉的其它功能</example>
</element>
<element name="isDrawUncheckedRadio" meaning="是否显示未选中的Radio">
	<category>外观</category>
	<group>外观</group>
	<datatype>bool</datatype>
	<default>false</default>
</element>
<element name="isShowSortPanel" meaning="是否显示顶部的多重排序区">
	<category>外观</category>
	<group>外观</group>
	<datatype>bool</datatype>
	<default>false</default>
	<example>12.事件</example>
</element>
<element name="innerShadow" meaning="内凹陷阴影">
	<category>外观</category>
	<group>外观</group>
	<value>上、下、左、右边框处的凹陷阴影, 默认是: "top.width=6; top.alpha=25; left.width=2; left.alpha=33", 其中width表示阴影大小, alpha表示阴影的Alpha值(0-255), 数字越大越浓</value>
	<default>如左</default>
</element>
<element name="fadeInStep" meaning="执行 Load( ) 函数时的淡入淡出效果">
	<category>外观</category>
	<group>外观</group>
	<datatype>int</datatype>
	<value>0 - 255, 数值越小效果越明显, 而 0 表示关闭此效果</value>
	<default>20</default>
</element>
<element name="freeform" meaning="嵌入freeform，作为整行的显示、输入">
	<category>外观</category>
	<group>外观</group>
	<value>Freeform的URL</value>
	<example>自由表头的 11.多记录Freeform(1)</example>
</element>
<element name="autoBreakLine" meaning="文字显示的超宽处理">
	<category>外观</category>
	<group>外观</group>
	<value meaning="自动换行、缩小字体, 换行优先">0 或 breakLine</value>
	<value meaning="不处理">1 或 none</value>
	<value meaning="自动缩小字体、换行, 缩小字体优先">2 或 shrinkFont 或 smallFont</value>
	<value meaning="自动换行, 但不缩小字体">3 或 breakLineOnly</value>
	<default>0</default>
</element>


<element name="SeparateBarStyle" meaning="分屏方式">
	<category>行为</category>
	<group>左右分屏</group>
	<value meaning="始终显示分隔条">true</value>
	<value meaning="始终不显示分隔条">false</value>
	<value meaning="自动(超宽时会在左侧浮现分隔条)">auto</value>
	<default>auto</default>
</element>
<element name="SeparateBar" meaning='分屏，将窗口分裂为左右二个部分(类似"冻结")'>
	<category>外观</category>
	<group>左右分屏</group>
	<value>列名或列序号，在该列处分屏</value>
	<example>24.动态更改属性</example>
</element>
<element name="isHideLeftScrollBar/isHideLeftScroll" meaning="分屏后，是否隐藏左窗的水平滚动条">
	<category>外观</category>
	<group>左右分屏</group>
	<datatype>bool</datatype>
	<default>true</default>
</element>
<element name="isFrozenWhenSeparate/isFrozen" meaning="分屏后，右窗的水平滚动是否冻结">
	<category>外观</category>
	<group>左右分屏</group>
	<datatype>bool</datatype>
	<memo>为true时水平滚动条将滚不到被冻结的列</memo>
	<default>true</default>
</element>


<element name="DropDataLoadMode" meaning="下拉数据的加载模式">
	<category>行为</category>
	<group>行为</group>
	<value>asynch/synch - 异步/同步</value>
	<default>asynch</default>
	<memo>"下拉数据"即&amp;lt;Droplists&amp;gt;下的需要加载外部数据的所有下拉资源</memo>
	<example>9.各种下拉，10.可编辑下拉</example>
</element>
<element name="enter" meaning="回车键的行为, 仅用于在输入时">
	<category>行为</category>
	<group>行为</group>
	<value>Right/Down - 光标向右/向下跳转</value>
	<default>right</default>
</element>
<element name="autoUpdate" meaning="回车键的行为, 仅用于在输入时">
	<category>行为</category>
	<group>行为</group>
	<datatype>bool</datatype>
	<default>false</default>
	<memo>下拉Treelist列在选中后, 是否立即将所选数据更新到Treelist中,  默认情况下, 并不将数据更新到Treelist中, 因为可以敲 Esc 键反悔</memo>
	<example>27.过滤: 关联下拉</example>
</element>
<element name="autoRevertScroll" meaning="在第一行/最后一行按Up/Down键后，是否上下翻转当前行">
	<category>行为</category>
	<group>行为</group>
	<datatype>bool</datatype>
	<default>false</default>
</element>
<element name="isSelectEditWhenFocus" meaning="当输入框取得焦点时，光标是否选中全部文字">
	<category>行为</category>
	<group>行为</group>
	<value meaning="全选">true</value>
	<value meaning="不选">false</value>
	<value meaning="自动 (int 和 double 类型全选)">auto</value>
	<default>auto</default>
</element>
<element name="isHiLightModified/isHighLightModified" meaning="修改过的单元格, 是否在其左上角显示一个醒目的标记">
	<category>行为</category>
	<group>行为</group>
	<datatype>bool</datatype>
	<default>false</default>
	<example>20.提交修改内容</example>
</element>
<element name="isHiLightNewRow/isHighLightNewRow" meaning="新增行, 是否在左标尺的左上角显示一个醒目的标记">
	<category>行为</category>
	<group>行为</group>
	<datatype>bool</datatype>
	<default>false</default>
	<example>20.提交修改内容</example>
</element>
<element name="isAutoFitWidth" meaning="是否能自动扩展列宽而填充整个窗口">
	<category>行为</category>
	<group>行为</group>
	<datatype>bool</datatype>
	<default>false</default>
	<example>6.引用外部Treelist,  自由表头的 9.有表头表体的表单(1)</example>
</element>
<element name="multiLayerAble" meaning="是否允许多层表头">
	<category>行为</category>
	<group>行为</group>
	<datatype>bool</datatype>
	<default>true</default>
</element>
<element name="moveAble" meaning="是否允许拖拽标题交换列的次序">
	<category>行为</category>
	<group>行为</group>
	<datatype>bool</datatype>
	<default>true</default>
</element>
<element name="sortAble" meaning="点击列标题是否执行排序">
	<category>行为</category>
	<group>行为</group>
	<datatype>bool</datatype>
	<default>true</default>
</element>
<element name="multiSortAble" meaning="是否允许多重排序操作">
	<category>行为</category>
	<group>行为</group>
	<datatype>bool</datatype>
	<default>true</default>
</element>
<element name="ExpandMore" meaning="以树显示、点击树杈后，是否连带展开其所有子孙树杈">
	<category>行为</category>
	<group>行为</group>
	<datatype>bool</datatype>
	<default>true</default>
</element>
<element name="editFreeformId" meaning="用于对话框输入的Freeform资源的id">
	<category>行为</category>
	<group>行为</group>
	<value>在&amp;lt;FreeformRes&amp;gt;中的freeform的id</value>
	<example>自由表头的 15.辅助Treelist输入(2)</example>
</element>
<element name="editFreeformKey" meaning="打开Freeform对话框的动作">
	<category>行为</category>
	<group>行为</group>
	<value>可以从dblClicked,enter,space选取，逗号分隔</value>
	<default>dblClicked,enter</default>
</element>
<element name="editFreeformMode" meaning="打开何种Freeform对话框">
	<category>行为</category>
	<group>行为</group>
	<value>可以是 inner, model, 分别表示内嵌对话框、弹出的模式对话框</value>
	<default>inner</default>
</element>

<element name="title" meaning="标题">
	<category>外观</category>
	<group>打印简易配置</group>
	<value>串</value>
	<example>1.感受Treelist、8.多种掩码输入</example>
</element>
<element name="subTitle" meaning="副标题">
	<category>外观</category>
	<group>打印简易配置</group>
	<value>串</value>
</element>
<element name="titleAlign" meaning="标题水平对齐">
	<category>外观</category>
	<group>打印简易配置</group>
	<value>Left / Center / Right</value>
	<default>center</default>
</element>
<element name="subTitleAlign" meaning="副标题水平对齐">
	<category>外观</category>
	<group>打印简易配置</group>
	<value>Left / Center / Right</value>
	<default>center</default>
</element>
<element name="oriantation" meaning="打印纸方向">
	<category>外观</category>
	<group>打印简易配置</group>
	<value meaning="纵向">Portrait</value>
	<value meaning="横向">Landscape</value>
	<default>Portrait</default>
</element>
<element name="scale" meaning="打印缩放比例">
	<category>外观</category>
	<group>打印简易配置</group>
	<datatype>int</datatype>
	<value>10至300之间的数字，含义为百分比</value>
	<default>100</default>
</element>
<element name="PaperBorder.left\PaperBorder.right\PaperBorder.top\PaperBorder.bottom" meaning="打印纸边界">
	<category>外观</category>
	<group>打印简易配置</group>
	<datatype>int</datatype>
	<value>数字(单位:毫米)</value>
	<default>15</default>
</element>
<textLine>建议在&amp;lt;PrintPage&amp;gt;中设置打印配置，上述简易配置仅是为了兼容老版本。如果在&amp;lt;PrintPage&amp;gt;中有配置，上述简易配置将自动失效</textLine>

<element name="totalFontIndex\subTotalFontIndex" meaning="合计/小计行的字体顺序号">
	<category>外观</category>
	<group>小计合计</group>
	<datatype>int</datatype>
	<value>数字, 指向&amp;lt;Fonts&amp;gt;中的字体资源</value>
	<default>-1</default>
	<example>13.分类汇总</example>
</element>
<element name="totalBgColor\subTotalBgColor" meaning="合计/小计行的背景色">
	<category>外观</category>
	<group>小计合计</group>
	<datatype>color</datatype>
	<value>颜色串</value>
	<example>7.计算列合计行、13.分类汇总</example>
</element>
<element name="totalTextColor\subTotalTextColor" meaning="合计/小计行的文字色">
	<category>外观</category>
	<group>小计合计</group>
	<datatype>color</datatype>
	<value>颜色串</value>
</element>
<element name="isFixTotalRow/isTotalRowFixed" meaning="合计行是否固定在底部、始终显示">
	<category>外观</category>
	<group>小计合计</group>
	<datatype>bool</datatype>
	<default>false</default>
	<example>7.计算列、合计行</example>
</element>
<element name="totalOption" meaning="合计/小计的其它选项">
	<category>外观</category>
	<group>小计合计</group>
	<value>格式为: "isIncludeHideRow=?;isIncludeMergedCell=?"</value>
	<value meaning="表示是否包含被隐藏的行，默认是true">isIncludeHideRow</value>
	<value meaning="表示是否包含被组合的单元格(左上角主单元格除外)，默认是true">isIncludeMergedCell</value>
	<default>如左</default>
</element>

<element name="pageRows" meaning="每次加载行数">
	<category>数据</category>
	<group>分页动态加载</group>
	<datatype>int</datatype>
	<value>数字</value>
	<default>100</default>
	<example>18.分页方案(一)、19.分页方案(二)</example>
</element>
<element name="totalRows" meaning="取得数据总行数的URL">
	<category>数据</category>
	<group>分页动态加载</group>
	<value>相对或绝对URL, 服务器返回的响应必须是数字(即总行数), 或包含数字的XML、JSON，不太常用</value>
	<example>18.分页方案(一)、19.分页方案(二)</example>
</element>
<element name="dataURL" meaning="分页取数的URL">
	<category>数据</category>
	<group>分页动态加载</group>
	<value>就是前面提到的dataURL, 但是必须包含@宏变量, 例如: "../get1.aspx?st=@startRow&amp;count=@rows", 其中宏变量@startRow、@rows分别表示开始行、要索取的行数</value>
	<example>18.分页方案(一)、19.分页方案(二)</example>
</element>
<element name="IsRemoteSort" meaning="当用户试图执行排序操作时, 是否让服务器来完成排序">
	<category>行为</category>
	<group>分页动态加载</group>
	<datatype>bool</datatype>
	<default>false</default>
	<example>31.FreeformBar</example>
	<memo>如果为true, 在鼠标点击列头时, 将抛出Sort事件</memo>
</element>

<element name="treeImageLeaf" meaning="树叶的图标">
	<category>外观</category>
	<group>单列多层树</group>
	<value>图片URL</value>
	<example>14.单列多层树(一)</example>
</element>
<element name="TreeImageNodeExpand\TreeImageNodeCollapse" meaning="树杈展开/合拢时的图标">
	<category>外观</category>
	<group>单列多层树</group>
	<value>图片URL</value>
	<example>14.单列多层树(一)</example>
</element>
<element name="LazyLoad" meaning="默认的懒加载方式">
	<category>外观</category>
	<group>单列多层树</group>
	<value meaning='不能确定是否含子孙，显示树杈标记，鼠标点击标记时抛出 "LazyLoad" 事件，需要通过加载数据来即时判断'>true</value>
	<value meaning='默认非树杈'>false</value>
	<value meaning='不能确定是否含子孙，显示树杈标记，鼠标点击标记时自动从该URL加载数据，该URL通常为一表达式'>URL串</value>
	<default>false</default>
	<memo>仅用于单列多层树</memo>
	<example>15.单列多层树(二)</example>
</element>
</elements>

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