列表-项模板-数据适配器

数据适配器当前支持范围:

List,ListBox,Tree,ListView,ComboBox;

项模板当前支持范围:

List,ListBox,Tree,ListView,ComboBox;

注解
提示: 以下所说的列表, 指所有列表类型的UI元素.

数据适配器:

数据适配器相当于数据库里的数据表, 有行和列, 每列对应字段名(列名).
数据适配器用来保存数据, 通过列表,模板,数据适配器组合,满足不同的需求.
列表根据设置的模板文件中UI元素绑定的字段名, 自动去数据适配器中取对应数据显示到UI.
如果在列表显示之后,修改数据适配器中数据, 需要刷新列表模板,以便更新数据到UI.

项模板说明:

项模板用于定义列表类型元素"列表项"的内容展示.可以通过UI设计器创建编辑模板文件,也可以通过手写修改.
可通过项模板中项itemID获取模板实例化后对象句柄.
可动态替换模板,实现复杂列表内容.
注册项模板事件,对内容进行操作.
详细用法见文档示例.

当用户未指定模板时, 将使用内置模板, 默认开启了模板列延伸(复用),所以不限制列数量, 字段名分别为:"name1","name2","name3" ,"nameN" ; 项ID(itemID)从1开始.
在模板中绑定字段名, 列表项将从数据适配器中取对应字段的值显示;

当用户先设置模板文件, 再通过列表的接口创建数据适配器时, 将自动从模板中获取字段名添加到适配器, 否则用户需要手动将字段名添加到数据适配器,否则数据适配器是空的没有字段名

列表默认未开启模板复用机制, 如果对性能要求比较高,请开启模板复用,避免列表项重复创建与销毁模块的开销;

用户也可通过代码动态创建修改模板;

项模板支持的内置对象

Element,LayoutEle,Button,TextLink,ComboBox,Edit,SliderBar,ProgressBar,ShapeText,ShapePicture.

项模板-列延伸(列复用)

仅多列列表(List)支持列延伸 例如:列表有100列, 很多列UI元素相同,就造成了内容重复,影响开发效率, 这种情况可以使用列延伸 那么模板我们只需要一列, 因为后面99列内容和他相同, 在设计器属性中[列延伸-字段名]即开启复用,也可以指定[列延伸-数量],延伸指定数量列

设计属性: 字段名前缀: 将绑定的字段名作为前缀 列延伸-字段名(整数): 大于等于0, 起始值; [前缀 + (字段名起始值 + 当前延伸次数)], 例如: 当前缀为"name",起始值为3, 延伸次数为3, 那么字段名为: name3, name4, name5" 列延伸-数量(整数): 大于等于0, 当为0时从当前列延伸到末尾列, 否则延伸指定数量列; 如果未指定那么值为0;