【易语言UI 纯组件列表模块】CHENI纯组件自定义列表框模块帮助文档(基于1.7)

当前最新版本:1.9c

交流群:378697972

帮助文档更新时间:2020年7月6日14点00分

对应版本:未命名 - 1.7

帮助文档基于1.7及以前

为了您使用到最新的功能,请在帖子尾部下载最新版本的模块

前言:

我之前写过很多用纯组件和复制窗口组件这个命令做出来的自定义列表的Demo

怎么说呢,它虽然动画效果可能并不会像自绘的那么舒服,但是它画起来比自绘更直观一些,你只需要放好一个表项,然后给上它一堆(如果没有这个模块之前)代码,他就可以给你自动生成出来

但是后来随着我做的越来越多此类的列表的时候,我发现,有很多重复的代码,并且每次我都要重新写一遍,于是为了节省今后的界面开发时间,我就开始写这个模块,这个模块只需要几行代码就可以自动完成剩下的步骤,而且容错率个人认为比较高,我发现的所有可能出错的结果我都进行了判断,并且保证即使出错了,程序不会直接停止运行,而是调试输出,这样就算是发布版本的程序使用起来也是没有问题的,只需要开发者及时发现并更新就好了,并不会导致程序无法运行
版权声明:本模块可进行二次开发,但二次开发者需著明原作者:CHENI
使用条例:本模块官方版本以此贴为准,在其它网站或其它用户分享途径获取的模块、源代码所造成的经济、安全损失,本站、原作者不做任何补偿与解释,本模块本身不传播任何违法信息未对软件内容进行任何添加、修改,所有源文本均来自软件作者,非模块作者。模块开源,若怀疑模块具有漏洞、后门等安全隐患请勿使用本模块!
特别声明:使用即代表同意以上条例,软件制作者通过本模块制作的软件造成的任何法律责任由软件作者承担。

如图:现在我们要生成一个这样的界面
只需要这样几行代码就完成了

而在此之前我需要写一段比我的屏幕高度还高的代码他才能生成出来,并且如果我还要加更多的组件的话他会更长


代码解释:

一:创建以及生成表项

1. 首先我们要在程序变量中声明变量在类型中选择一个组件上限数量

【上限数量概念:比如说一个表项有5个标签,上限量为1000个组件,那我最多可以创建200个表项,而如果我想要更多的表项就需要选择更大数量上限的类】

【修改记录】

    1.2出现多列表项

    1.31及其以后取消了单、多列类的区分

    1.32及以后版本组件数量调整为自适应

使用方法

在程序变量中声明一个自定义变量名 变量类型为:CHENI_纯组件列表框 的变量


2. 第二步我们要创建表项【此部分使用的是初代版本的截图、1.1及以后版本例程中都以“图文列表框(_多列)”为变量名】

而在创建表项之前我们需要添加表项中所需要的组件

添加方法:变量名.创建表项_添加[母组件类型](母组件名称)

ps:这里的变量名指的是类的变量名,比如下图的:左侧边栏

【母组件名称概念:就是说我们在创建表项之前,表项原型调用的那个组件的名称,比如默认的标签1、图片框1等,添加什么类型的组件就接受什么样类型的参数】

在我们添加完所有的表项组件之后只需要写上一段变量名.创建_表项()代码就可以对默认表项进行初始化了


创建_表项()参数说明:在1.1及以后的版本中新增了以下几个参数

每行个数(1.2及以后的多列类中):声明每一行需要展示表项的个数 详细说明看下一条

序号标签(1.1及以后):系统会在每次创建、删除表项的时候自动修改这个标签的标题使之与自身序号相对应 序号:第一项即为1依次递加

序号左侧字符(1.1及以后):在序号前面添加的字,比如我们想显示 “第 1 项” 那么这里参数就可以写“第 ”

序号右侧字符(1.1及以后):在序号后面添加的字 ,同上 这里的参数写” 项“


其中:创建_表项_多列(1.2及以后):的第一个参数是每行表项数量,比如我们想要显示3列,这个方法的第一个参数就应该写3

这个方法会自动判断你当前设置的数量是否合理 比如一个表项的宽度为800 但是它的列表载体的宽度为1000 而你想创建每行两列的列表,则会自动转换为1,因为2*800=1600 1600>1000 该方法会计算每行最多的列数。

特别提醒:1.2版本中该方法未进行防呆判断 即:如果列表宽度小于表项宽度的话,每行列数会直接被设为0!



3. 在创建完表项之后,列表并不能直接显示出来,因为你还没有告诉模块你需要生成多少个表项、以及没有声明列表载体。

首先声明列表体:

使用变量名.创建_列表载体(载体组件名称)【这一步通常放在第一步】

【列表载体概念:也就是说接下来生成的所有表项它都会显示在这个组件上,所有表项的位置可以随着载体的位置相对移动,但是要注意的是载体必须是所有表项中母组件的父组件(就是你把组件拖到载体之外之后它是看不见的)这一点很重要】

说明:”创建_列表载体” 和 “创建_表项” 这两个方法并没有执行顺序上的差异,但是都必须要在 "插入_*“ 方法之前执行(*在未命名版本中为单列表项 之后的版本中分别有:”插入_多列表项_首次“ 、”插入_单列表项_首次“ 1.31及以后修改为“插入_表项_首次”)


4.首次插入表项需要定义左右、上下间距 【数量可接收空参 如果有些版本需要接收非空参数也可填写0,并不一定非要传参】


然后我们需要使用变量名.插入_单列表项(数量,间距)来生成多个表项(1.1及以后版本为:”插入_单列表项_首次“ 1.2及以后版本新增:”插入_多列表项_首次“

【参数说明】:插入_单列表项_首次、插入_单列表项

数量:即你想生成多少个这样的表项

间距:即每个表项之间的纵向间隔(单位为像素)

【参数说明】:插入_多列表项_首次

数量:即你想生成多少个这样的表项

上下间距:即每个表项之间的纵向间距(单位为像素)不建议使用负数

左右间距:即每列(横向)之间的间距(单位为像素)如果是单列的话,此处可填0 但此参数不接收空参数,且不建议使用负数


做完这些我们的列表就创建完了


但是要特别注意的是组件之间的父子关系,即:除了在体外、其它所有组件均为载体的子组件、否则会出现组件无法显示的情况(后期可能会修复)

二:删除表项的方法:

方法:删除_表项

参数说明:

开始表项序号:和修改,获取的批量操作不一样的是,删除使用开始序号就是想要删除的那个序号,如果需要删除第一个就填1就可以了

删除数量:需要删除多少个就写多少

方法2:删除_全部表项
无参方法

作用是把所有的表项都删除


说明:删除表项的操作只是对表项的所有组件进行了初始化,即将母组件的所有可赋值的属性赋值给被删除的项,最后修改可视为假,并不是真正意义上的销毁了组件。

三:修改组件的属性

批量修改组件属性:


批量修改在这里使用变量名.修改_组件类型组件属性_批量(母组件,开始位置-1,修改结果[数组类型])

【说明:目前支持的批量修改类型有:标签、超级按钮、按钮的标题和图片框的图片、编辑框的内容】

参数说明:

母组件:就是说我们在创建表项之前,表项原型调用的那个组件的名称

开始位置:比如我要从第一个表项开始修改我就填零或者不写,如果要从第二个开始则写1

[毕竟资深程序猿去十楼的话就会按下电梯上9这个按钮 |纵所皆知,程序总是从0开始| ]

修改结果:需要提供一个数组型参数


单个修改的方法:

修改_标签标题()等

参数说明:

母组件:同批量修改的母组件解释

表项序号:和批量不一样,这里是需要获取哪一个序号的标题就直接写哪一个序号 是1就写1

修改后文本:非数组型的文本型参数


获取组件:

如图所示:调用的方法为:变量名.获取_组件类型(母组件,表项序号)

此方法的返回类型为:对应的母组件组件类型,但是需要特别注意的是:如果获取不到该组件比如母组件未参与到表项中或者表项序号超过了表项数量的情况,都会直接返回母组件本身,如果对其作了属性修改的话也会直接作用到母组件上,当然我们也可以通过计次循环来完成批量的效果。


获取组件属性:


参数说明:

母组件:即创建表项时调用的那个组件

开始表项索引:索引从0开始,想要从第一个到第五个的话这里应该写0

需要获取的数量:需要获取几个就写几 如:5

赋值数组:类似精易模块的 文本_取中间_批量的方法,传入一个赋值的数组,获取的结果将会被赋值到该数组【因为不支持返回文本型数组】


获取单个组件属性的方法:

获取_超级按钮标题 等系列方法

参数:母组件、表项序号

返回类型:文本型


通过上面的方法我们就可以灵活的进行修改、获取组件的属性了,本模块只继承了常用的属性的修改及获取,开发者可通过获取组件的方法进行自行获取、修改组件属性


四:控制列表的方法

列表_滚动

参数:滚动距离

此方法写在列表组件的 滚轮被滚动 事件下,响应鼠标滚动


列表_绑定纵向滚动条【1.11及以后版本】

参数:

滚动条 纵向滚动条 类型,此滚动条需要独立于列表载体之外否则会跟随列表载体移动

列表显示最大高度:就是显示出来的最大高度(用于判断可移动范围)此参数可空,默认为列表载体初始高度


列表_滚动条控制列表【1.11及以后版本】

无参方法

需手动在滚动条的位置被改变方法下添加


列表_回到顶部【1.3及以后版本】

参数:

1.3-1.5以前是速度【无法直观描述】

1.5修改为所需时间


五:数据绑定组件的方法

数据_标签标题绑定数组 等组件绑定数组的方法【该方法和修改类似,但是用该方法做出的绑定后期可进行数据对接、转移、保存 读取操作】

参数:

母组件:需要对哪个组件进行绑定就传入哪个组件

欲绑定数组:即初始传入的数组

特别说明:绑定之后模块内的数组会跟随表项的改变一起改变,但由于采用的是赋值的方法,不是传址 所以做出的修改不会对原数组做出影响如果需要获取请通过 获取_标签标题_批量 等方法进行获取

【1.7及以后版本修改为传址参数 即模块所做的修改会影响到原数组,程序外部可直接对数组进行修改,也会在下一次更新的时候会对组件属性进行修改(但是不建议手动进行修改,具有滞后性),建议使用模块内提供的方法进行修改、添加,操作会立即对组件属性进行修改】(此功能未在1.7版本中实现)

特别提醒:不建议手动删除数组!!!会影响组件对应数组的关系!!!

数据_更新标签绑定数组数据 等此类方法

参数:母组件 (可无参调用)

如果是无参调用将会对所有绑定了数组的标签惊醒更新

更新方向: 组件属性到数组


数据_更新所有组件绑定数组数据【删除表项时会自动调用】

无参方法,执行该方法后,程序对数组进行的修改会立即响应到所有绑定了数组的组件上

【1.7及以后,1.7以前版本使用非传址方法,不会做出任何响应】

更新方向:组件属性到数组


数据_更新标签绑定标题 等此类方法

参数:母组件(可无参调用)

如果是无参调用会将所有绑定了数组的标签的属性修改为数组对应的数据

更新方向:数组到组件属性


数据_更新所有组件属性【插入表项时会自动调用(默认值都为空)】

无参方法,执行后程序组件会被赋值绑定的数组

更新方向:数组到组件属性


以上两个方法如果是有参调用则仅更新指定数组、组件属性


六:数据绑定表项的方法

数据_绑定文本型自定义数组 等此类方法

接收参数:

关键字:文本型 类似于索引,但这是文本型索引,获取时需要输入相同的关键字才可获取到指定内容

初始数组:指定类型数组型 初始的数组,如果初始数组成员数少于表项数量则会进行自动补全 默认内容为 “”(空内容)

如果初始数组成员数多于表象数量则会删除多余项

表项的添加和删除会对相应数组造成影响 添加表项时默认加入的为空内容“” 【整数型则为0】

绑定了该关键字后,不可再用此方法进行绑定新的数组,如需绑定新数组需使用下列方法


数据_更新绑定文本类型自定义数组 等此类方法

接收参数:

关键字:同上

更新后数组:同上

此方法特定使用在更新数组上,即之前的数组会被新数组所替换【传址型替换】,如果关键字未被插入则不会做出任何修改


数据_获取文本型自定义数组 等此类方法

接收参数:

关键字:同上

赋值数组:将对应数组转移到该数组


数据_获取文本型自定义表项文本 等此类方法

接收参数:

关键字:同上

表项序号:需要获取哪一项的就填几

返回类型:文本型 等响应类型


数据_修改文本型自定义表项文本 等此类方法

接收参数:

关键字:同上

表项序号:同上

修改结果:需要赋值到数组特定项的值

此方法之后会自动更新对应文本、整数型等内容


数据_修改文本型自定义表项文本_批量 等此类方法

接收参数:

关键字:同上

开始表项序号:同索引一样从0开始

修改结果:数组型

修改结果有多少内容就会修改多少项【如果超出范围,则会被删除】


七:编辑框自适应宽高(未完善)

接收参数:

编辑框:需要修改的编辑框

操作类型:0为自适应宽度,高度不变,1为自适应高度,宽度不变

最大宽度:如果为自适应高度模式,小于最大宽度时,会进行自适应宽度操作大于时才进行自适应高度操作



注意:以上部分码即使加载出错也不会导致程序直接无法运行,而是会调试输出一段提示信息,可通过提示信息对调用代码进行修改容错率相对较高(由于发布时未检测、下列代码【响应组件事件】可能会引起程序强制退出)


但是要特别注意的是,一但组件被添加到表项中,即使未生成列表它的可视也是为假【但是程序本身依然可以对该组件做出属性修改】


八:响应组件事件

【特别声明:此处所用的获取方法调用的是组件的标记这个属性,这个属性是在创建列表的时候赋值进去的,如无特别需要请勿对其修改,否则无法响应事件!!!】


需要表项的相应组件处理事件只需要对其母组件进行操作即可(比如:我想要单击表项中的某一个超级按钮,我只需要对它的母组件那个超级按钮绑定事件就可以了)

响应方法如图所示,这里有一个很关键的步骤,就是实际被单击组件(也可理解为实际响应组件)该变量类型需要与母组件也就是触发事件的组件类型一致比如途中的类型就为超级按钮,而获取事件组件的方法就是让这个变量=取事件组件()即可

而我们需要使用表项中的组件调用表项中的另一个组件则只需要按照上面的变量名.获取_组件类型(母组件,表项序号)即可

此处表项序号的填写方法为:到整数(实际响应组件.标记),同理如果我们想要改变上一个组件则只需要到整数(实际响应组件.标记) - 1即可




1.1更新内容:

1、新增方法:【编辑框自适应宽高】来自精易:Peanut
调用方法帖子地址:https://bbs.125.la/forum.php?mod=viewthread&tid=14530555

此方法可对编辑框进行自动适配长宽,可锁定其长度只自动适应高度,也可锁定其高度自动适应长度。后期可能调用此方法对列表进行文本自适应显示。
2、新增方法:【标签_设置表项序号】 同时更新【创建_表项】方法
如图所见粉色部分即为系统自动更新生成,前提需要设置表项序号标签并且该标签已被添加到表项组件中
3、新增支持组件:编辑框
编辑框也被加入到纯组件列表中了噢~
4、修复方法:【获取_标签】等同类方法
前代版本中的循环次数变量存在问题
5、修复方法:【获取_标签表项序号】等同类方法
前代版本或多或少存在获取表项序号的问题
6、修复方法:【获取_表项数量】
前代版本中表项数量是添加了几次就是几但是存在删除的情况未及时更新本次进行了修复
7、修复其它未记录BUG 以及新增某些未知BUG


1.11更新内容:

1、修改方法【创建_表项】

方法加入最大可插入表项数量输出

2、新增功能:绑定纵向滚动条

衍生方法

        a:列表_绑定纵向滚动条

        绑定后需要传入列表显示最大高度从而判断滚动条是否可控制

        b:列表_滚动条控制列表

        此方法需自行在滚动条被滚动之后加入调用,与列表_滚动类似

        方法作用:当用户拖动滚动条时列表会跟随滚动

        c:列表_刷新滚动条

        此方法为模块私有方法将在【列表_滚动】以及添加、删除等方法后执行调用,用于更新滚动条显示

                PS:B、C的方法都需要绑定了纵向滚动条之后才可正常使用


【列表_绑定纵向滚动条】:

参数说明:

纵向滚动条:接收一个纵向滚动条类型的参数

列表最大高度:也就是列表所展现给用户最大的高度,即显示的最大高度,通常会直接设置为纵向滚动条的高度

特别提醒:滚动条建议独立于列表载体之外,即不受列表滚动所影响


【列表_滚动条控制列表】:

无参方法,此方法写在滚动条位置改变的方法之下执行。


1.2更新内容:
1、新增类:CHENI_纯组件列表框_多列10000组件、20000、50000、100000都有随之添加
2、修复:因为判断条件导致的表项宽度计算错误
3、修复:滚动条绑定后未激活导致滚动条最大位置出错问题
4、修复:由于未计算第一个表项顶边而造成的预判生成数量错误

【生成和使用注意事项均在上方有所注释】


1.3更新内容:

1、新增功能:回到顶部(非线性缓动)、尾部组件载体(类似于Web中存放底部页面导航,版权信息的载体)

A:回到顶部 该方法可直接无参调用,调用后会从当前位置向上滚动,并且滚动期间实时可视(但是列表载体会被禁止【即禁止 = 真】)

B:尾部组件载体

需要注意的是这个载体接收的是一个图片框类型的参数,通过修改这个载体的顶边从而实现实时置底的效果

同时这个图片框可以存放其它组件,注意,如果想要让存放的组件跟随图片框一起动的话那组件需要在这个载体中创建,即生成的组件是载体的子组件。

2、修复反人类错误:由于多列使用了自动判断每行最多可以插入多少列表项,所以如果载体本身就连一列都存放不了,那么它会直接设置为0,从而无法显示表项


1.31更新内容:

1、修复:未绑定滚动条时 列表_滚动 方法疯狂调试报错BUG

2、修复:列表_刷新滚动条(此方法为私有方法),1.3版本新增的尾部组件载体的高度未被记录在滚动条中,导致拖动滚动条只能到达列表底部,并不是尾部组件载体上

2、调整:取消所有单列表项,(如需使用单列则在创建时每列数量留空即可)

3、修改:类名  修改为:CHENI_纯组件列表框_10000组件

4、修改:方法名:创建_表项_多列 等 修改为 创建_表项 参数依次为 每行数量(可省略默认为1)、序号标签组件、序号前字符串、序号后字符串

5、修改:方法名:插入_多列表项_首次、插入_单列表项_首次 均修改为 插入_表项_首次

6、新增:修改_标签标题、修改_按钮标题、修改_图片框加载图片、修改_超级按钮标题 这些方法达到的效果和批量的一样,但是这些方法做出的修改只对指定序号有效,且传入的为非数组参数


1.32更新内容:

1、调整:取消组件数量限制【采用自适应数量】,即需要多少组件则提供多少组件(PS为了节省生成速度,生成过后的组件不会销毁,而是可视为假,当需要再次调用的时候会调整其属性使之快速响应)

1.1、修改:类名:CHENI_纯组件列表框_10000组件 修改为 CHENI_纯组件列表框

2、修改:列表_绑定纵向滚动条 第二参数 列表显示最大高度 修改为可空,默认为纵向滚动条的高度

3、修复:列表_刷新滚动条等方法,此方法在1.31中为成功修复,导致载体定边算法错误

4、修复:获取_ 等此类方法中的超出数量判断方案 此前会调用越界数组变量

5、新增:获取_标签标题、获取_按钮标题、获取_图片框图片、获取_超级按钮标题、获取_编辑框内容 及其批量获取方法

5.1参数说明:获取_按钮标题 等此类方法需要提供的参数为:母组件、表项序号

5.2参数说明:获取_按钮标题_批量 等此类方法需要提供的参数为:母组件、开始表项索引(从0开始)、需要获取的数量、赋值数组


1.5更新内容:

1、调整:列表_绑定纵向滚动条的第二参数可接收空参 默认为列表载体的初始高度

2、定义私有数据类型:posAndSize 用于记录组件的坐标和大小  同时衍生 一系列Get和set方法(私有方法 | 将用于后期自适应组件的判断、记录、修改)

3、修复:之前未成功修复的滚动条错误 前代版本如果绑定滚动条时间在 插入_表项_首次 之前执行的话,那滚动条将不会进行激活

4、调整:在插入、删除等批量事件中加入的刷新显示代码,优化显示

5、调整:获取_标签表项序号 等系列通过组件获取序号的方法无需再提供母组件参数,只需提供事件组件【即第一参数】

6、调整:提示信息中加入组件名输出,方便开发者寻找对应组件事件【警告:如果使用线程调用方法将会报错,但因为是调试输出,所以用户运行时是不会出错的】

7、新增:数据_标签标题绑定数组 等系列数据绑定方法【支持批量、单个 如需批量更新则无参调用即可,单个组件更新则传入欲更新的母组件即可】

【特别说明:该方法的效果和 修改_标签标题 等方法效果类似,但是数组内容会基于组件相对应的属性进行更新 便于后期更新的保存、读取数据方法】

7.1、支持类型:标签标题、图片框图片、超级按钮标题、按钮标题、编辑框内容

7.2、手动更新数据方法:数据_更新标签绑定数组数据 等系列数据更新方法 批量更新方法:数据_更新所有组件绑定数组数据

7.2.1、此方法会在删除、添加等命令后自动执行【批量更新所有数据】

7.3、手动更新组件属性方法:数据_更新标签绑定标题 等系列属性更新方法 批量更新方法:数据_更新所有组件属性

7.3.1、此方法会在修改组件属性时进行更新【单组件更新】

8、新增:数据_绑定文本型自定义数组 功能

【特别说明:此功能绑定数组后类内部的数组会跟随表项一起变动,会一起删除、新增等,但是方法做出的修改不会对原程序的数组进行任何修改,并非通过地址值、内存进行的修改,如需获、修改请使用相应方法!】

8.1、数据_绑定文本型自定义数组

(作用:首次绑定自定义文本数组,该方法绑定后的数组会和各个表项之间互相对应,例如点击按钮后可使用 打开指定网址()方法配合下列获取方法从而达到于数组对接的效果)

8.1.1、参数: 关键字:用于获取时的凭证

初始数组:首次绑定时调用的数组

8.2数据_更新绑定文本类型自定义数组


8.2、获取指定数组变量方法:

8.2.1、批量获取方法:数据_获取文本型自定义数组

参数: 关键字:创建文本型自定义数组时输入的关键字

赋值数组:由于无法返回数组型数据所以 获取后将得到的数组将会赋值到该数组上

8.2.2、单个获取方法:数据_获取文本型自定义表项文本

参数: 关键字:创建文本型自定义数组时输入的关键字

表项序号:即第几项就输入几(可通过 获取_标签表项序号 等方法获取当前组件的表项序号)

9、新增系列私有方法:数据_插入文本型自定义修改表项文本_所有、数据_插入文本型自定义修改表项文本、数据_删除文本型自定义修改表项文本_所有、数据_删除文本型自定义修改表项文本 此系列方法具有一定的风险性所以未对外公开,而是出现在特定场合下,可提供二开调用。

10、新增系列私有方法:GetKeyWordsIndex、GetIndex、GetIndexByData、此类方法因接收的是类似通用变量的“组件名称(文本型)”参数,存在一定的风险性,暂未对外公开

11、新增系列私有方法:SetPosAndSize、GetPosAndSize、此类方法用于记录,获取组各组件的位置、大小、用于后期组件之间自适应位置、大小,同样使用类似通用变量的“组件名称(文本型)”参数,存在一定的风险性,暂未对外公开


1.6更新内容:

优化显示效果【降低闪烁频率】
修复最大数量判断错误
修复列表表项数量越界带来的一系列错误
新增整数型数组绑定功能

1、修复:删除表项时计算行数的错误,导致的列表载体高度异常
2、优化:对 复制组件 系列程序集私有方法 ,优化删除表项时的批量修改导致的程序闪动问题 组件宽度、高度也将被复制
3、优化:序号标签的判定,使得序号标签稳定显示【此前会出现内容变动】
4、优化:删除时防止列表位置出错而进行滚动效果,现采用伪滚动【滚动距离为0】进行防止出错,减少界面闪烁可能
5、修复:列表_返回顶部 的位置判断问题【之前的判断会导致特定距离下陷入滚动距离为0的情况下,现调整算法最小滚动距离为3】
6、调整:列表_返回顶部 的参数从速度修改为耗时 更直观的表现速度【默认为1(小数型 单位秒)】 tip:通过简单计算当前表项数量和一个常量值可得到固定速度噢~ 例如:0.1 × 图文列表框_多列.获取_表项数量 () ÷ 40
7、修复:最大表项数量判定机制、修复插入_继续插入表项最大数量判断机制【此前会导致表项超出最大范围或出现未保存生成后的表项的情况】
8、新增:数据_绑定整数型自定义数组 及相关操作 【方法名格式大体与1.5版本文本型数组相似】
10、为方便调试、查找问题,现将多列【纯UI】例程移植到模块源码中【仅在临时子程序中调用,不会加载到程序中】


1.7更新内容:

1、修复:由于表项数量赋值位置错误导致的 插入_表项_首次 时表项数量计算错误

2、修复:由于数组越界导致的删除表项出现的成员取值、组件未创建的错误

3、修复:由于 复制组件_* 系列方法对可视进行的判断,可能会导致表项无法被删除的错误【1.6版本如果首次插入时插入了表项 则会导致无法删除任何表项,且无法再次获取其属性!!【原因是修复的第一个错误】】

4、修复:由于返回值判断错误导致的 获取_标签 修改_标签标题 等方法 母组件参数填入非母组件导致的数组越界问题【如果该组件已被添加到表项中不会出现错误】

5、新增:列表_开启显示部分表项功能【开启后将暂时关闭添加、删除表项功能,但依旧可以进行其它操作】

5.1、用途:搜索【模块自身未集成搜索功能】,仅展示属于某特定内容的表项 等

5.2、方法说明:

5.2.1、:列表_开启显示部分表项功能

参数:显示表项序号组【整数数组型】 可空(自带去重,可提供带重复序号的数组)

作用:开启后仅显示传入序号的表项,排序方式为数组表项序号的顺序,绑定了表项序号的标签不会受影响,依旧显示之前的表项序号

注意:开启后由于计算、显示问题,插入,删除功能会暂时关闭,退出该功能后,将会恢复

5.2.2、:列表_显示部分表项并排序

参数:同上

作用:同上

注意事项:同上

5.2.3、:列表_显示所有表项

无参方法

作用、恢复到调整调整之前,但并未退出该功能,依旧无法进行删除、添加功能

5.2.4、:列表_隐藏所有表项

无参方法

作用、将所有表项的可视设为假,但是表项的内容并未被改变,且其位置也不会被改变

5.2.5、:列表_退出显示部分表项功能

无参方法

使用此方法后添加、删除功能会被恢复,并且会显示所有表项并按初始序号排序

5.3、由于未进行深入适配,所以 【列表_显示或隐藏单个表项】 【列表_移动表项到指定表项位置】 两个方法暂未公开,如需二开请谨慎使用!

5.4、目前未对开启功能前的表项组件可视进行保存,且如果开启了 默认显示、隐藏功能 功能,显示部分表项时也是以此为依据进行可视操作 且恢复后也同理,将在下个版本进行更新。

6、新增:默认显示、隐藏功能【特别注意:此版本及以后版本请将所有初始化UI的步骤放到 窗口首次激活(或其它窗口显示后执行的方法,且窗口的可视为真,列表载体的可视也为真)中,否则所有表项的可视都会默认为假!】

使用方法:无方法,修改母组件属性即可

7、新增:CHENI_数组_去重_整数型 、文本型、字节集型方法

参数说明:

参考数组:数组型 提供运算的数组

接收结果的数组:数组型 运算结果赋值的数组

功能说明:去重


1.71更新内容:

1、新增关闭事件组件提醒功能

此前由于默认打开事件组件提醒(无法关闭),会导致如果不是通过组件调用的此方法【比如多线程】,如果有提示则会出现无法获取组件的错误

但是由于在调试输出里调用,所以打包后并不会出现错误

方法:开启事件组件提醒功能【默认开启】

无参调用,开启后所有的提示都会附带上当前的组件名称,方便开发者查找错误

方法:关闭事件组件提醒功能

关闭后无法收到事件组件提醒

2、优化显示部分表项功能

支持保存表项组件的可视属性

此前默认是恢复到初始属性,此版本及以后支持保存组件可视属性【并非保存到文件】【此功能需要配合 修改_标签可视 方法实现,请勿手动修改可视属性!】

3、新增 修改_标签可视 等系列方法

可单独修改组件可视属性并保存到数组中


1.8更新内容:

1、修复由于关闭 创建_列表载体 第二参数 是否跟随母组件可视属性 导致的显示部分表项异常错误
3、修复由于对组件可视属性的判断,如果在 创建完毕 下执行 创建_表项_首次 和  删除方法 导致的无法正常删除错误
4、新增 绑定_小数型自定义数组 及其延伸的系列方法【同文本型、整数型类似】
5、修复删除时表项行数判断错误导致的列表载体高度判定错误


模块缺点:
现在暂时只支持:标签、图片框、按钮、超级按钮、编辑框这五种组件,后期我会继续更新此模块,会支持更多的组件等


并且后期会更新:多列表项列表(1.2版本已更新)、自适应内容高度、宽度列表、更多表项批量属性修改等功能,如需更新请在调试的时候添加:“变量名.帮助文档及更新 ()”代码即可访问模块官网。

模块和例程在附件列表里,模块源码需要回复下载,各位有兴趣的小伙伴也可以对模块进行二次修改或升级,注意官方版本只有本贴附件中提供的版本!


目前最新版本:1.9c

此帮助文档基于1.7版本

附件中发布版本为初代、未命名版本

5 条回复   |  直到 2022-10-13 | 7479 次浏览




附件列表
文件名称 文件大小 下载次数
CHENI纯组件列表框例程发布版1.0.zip 文件大小:0.032M 18
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框1.0.zip 文件大小:0.034M 4
附件列表
文件名称 文件大小 下载次数
CHENI纯组件列表框例程发布版.zip 文件大小:0.016M 33
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框模块源码.zip 文件大小:0.016M 12
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框 1.71.zip 文件大小:0.284M 2
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框1.1模块源码.zip 文件大小:0.046M 5
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框1.1模块、例程.zip 文件大小:0.934M 9
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框1.11模块、源码、例程.zip 文件大小:0.308M 7
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框1.2模块、源码、例程.zip 文件大小:0.382M 10
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框 1.3.zip 文件大小:0.403M 14
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框 1.31.zip 文件大小:0.312M 2
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框 1.32.zip 文件大小:0.256M 7
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框 1.5.zip 文件大小:0.28M 7
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框 1.6.zip 文件大小:0.272M 7
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框 1.7.zip 文件大小:0.28M 8
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框 1.8.zip 文件大小:0.287M 2
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框 1.9.zip 文件大小:0.323M 29
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框 1.9b.zip 文件大小:0.112M 5
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框 1.9c.zip 文件大小:0.33M 50
附件列表
文件名称 文件大小 下载次数
cheni纯组件列表框 1.9a.zip 文件大小:0.11M 47
热门评论
  1. 20140706 - 2020-6-15 支持  0 | 反对  0

    希望能添加个自定义位置的命令

    1. Cheni 【CHENI】 - 2020-6-15 支持  0 | 反对  0

      你好,请问一下自定义位置的具体要求是什么样的呢?

      1. Cheni 【CHENI】 - 2020-6-16 支持  0 | 反对  0

        感谢您的反馈,下个版本将更新绑定滚动条方法

        1. ptbcc - 2022-9-27 支持  0 | 反对  0

          你好,希望添加个卸载函数,如果多次载入窗口,目前最新版本会出现卡死问题。

          1. Cheni 【CHENI】 - 2022-10-13 支持  0 | 反对  0

            已知该问题,目前的解决方案是设置窗口的可视属性



            登录后才可发表内容