超级列表框使用说明.docx
《超级列表框使用说明.docx》由会员分享,可在线阅读,更多相关《超级列表框使用说明.docx(39页珍藏版)》请在冰豆网上搜索。
![超级列表框使用说明.docx](https://file1.bdocx.com/fileroot1/2023-4/28/f8a83c7b-343b-47ce-b860-93f4db0e271e/f8a83c7b-343b-47ce-b860-93f4db0e271e1.gif)
超级列表框使用说明
超级列表框使用说明
说明
版本:
V1.2
作者:
QIQI(QQ:
1354092549,E4A论坛账户:
1354092549)
更新日记
V1.2
1、支持空列
2、支持绝对布局
V1.1
1、支持E4A4.0,不再支持以前版本
2、图片框可以指定“显示方式”
1、导入
将下载的例程或EAA文件中的接口函数代码复制,在要导入的工程中创建一个名为“超级列表框”的接口函数,并将代码粘贴进去。
注意:
此版本仅适用于E4A4.0
如果您的程序中没有使用按钮、编辑框、标签、图片框,请务必在工程属性中关闭“按需编译”。
原因是:
接口函数中需要使用这些组件,而E4A的“按需编译”并不能检测接口函数中使用的组件。
2、创建
使用类似于以下的语句声明一个保存对象的变量
变量list1为超级列表框
其中“list1”表示变量名称
并在需要创建“超级列表框”对象的地方(一般在窗口的“创建完毕”事件)使用类似于以下语句创建
list1=超级列表框.创建超级列表框(主窗口)
其中“list1”表示变量名称,“主窗口”表示父窗口
3、设置位置和大小
刚刚我们创建的超级列表框是不会显示的,因为它的左边、顶边、高度、宽度都为0,我们需要使用类似于以下的语句来设置位置和大小
list1.置顶边(0)
list1.置左边(0)
list1.置高度(300)
list1.置宽度(300)
其中“list1”表示变量名称
4、添加一个列表项
我们创建完“超级列表框”后需要添加列表项,下面我们来教大家如何添加列表项。
每个列表项的结果如下:
其中绿线上面的(①)是第1行(行索引为0)
其中绿线下面的(④)是第2行(行索引为1)
其中②是第1行(行索引为0)中的第1列(列索引为0)
其中③是第1行(行索引为0)中的第2列(列索引为1)
其中⑤是第2行(行索引为1)中的第1列(列索引为0)
通过上图可以看出每行可以包含任意多个列,每个列的宽度可以不同,每行的列数也可以不同
行数其实也是可是每个项目都不同的,而且可以包含任意多个行
每一列就是一个组件。
使用以下语句可以添加列表项:
变量项目索引为整数型
项目索引=list1.添加列表项()
list1.添加行(项目索引)
list1.置行高(项目索引,0,50)
list1.添加列(项目索引,0,2)
list1.置列宽(项目索引,0,0,300)
其中“list1”表示变量名称
第1行代码声明一个变量,名称为“项目索引”,用了存储添加的项目的索引(0表示第1个,1表示第2个)
第2行代码添加一个列表项,并把“项目索引”赋值为添加的项目的索引(0表示第1个,1表示第2个)
第3行代码给指定项目索引(参数1)添加一行
第4行代码给指定项目索引(参数1)的指定行(参数2)设置行高,目标行高为参数3
第5行代码给指定项目索引(参数1)的指定行(参数2)添加一列,这列组件的类型(参数3)为标签(-1表示空列,0表示按钮,1表示编辑框,2表示标签,3表示图片框)
第6行代码给指定项目索引(参数1)的指定行(参数2)的指定列(参数3)设置列宽,目标列宽为参数4
我们创建了一个列表项,这个列表项包含1行,这一行包含一列,这一列的内容是“标签”组件。
现在,我们要执行组件的方法(详细的所有控件方法见后)
使用“控件_置标题”方法设置标签的标题(参数1为项目索引,参数2为行索引,参数3为列索引,参数4为目标标题),使用类似于以下的语句
list1.控件_置标题(项目索引,0,0,"测试项目")
其中“list1”表示变量名称
现在我们把“标签”的“标题”设置为了“测试项目”,运行一下。
不会显示?
别急,继续往下看。
由于“字体颜色”默认是“无色”,所以不会显示。
使用类似于以下的语句设置“字体颜色”
list1.控件_置字体颜色(项目索引,0,0,黑色)
其中“list1”表示变量名称
“控件_置字体颜色”方法设置标签的字体颜色(参数1为项目索引,参数2为行索引,参数3为列索引,参数4为目标颜色)
依然不会显示?
别急,继续往下看。
我们在添加等操作(具体哪些操作会在后面列出)等需要通知超级列表框刷新显示,使用类似于以下的语句
list1.更新数据()
完整例程:
例程1.e4a
效果图:
5、绑定组件事件
上面,我们成功制作了一个简单的列表框,但是我们在真实的应用中还需要绑定组件的事件。
下面我们来绑定“标签”的事件。
使用以下代码处理“标签”的单击事件(实际上是处理“超级列表框”的“控件_被单击”事件)
事件list1.控件_被单击(项目索引为整数型,行索引为整数型,列索引为整数型)
弹出提示("“控件_被单击”事件发生,项目索引:
"&项目索引&",行索引:
"&行索引&",列索引:
"&列索引)
结束事件
效果图:
6、多行多列列表项
添加多行多列列表项的方法与添加简易列表项的方法基本相同,只是多次调用添加行、添加列而已。
看代码!
变量项目索引为整数型
项目索引=list1.添加列表项()
list1.添加行(项目索引)
list1.置行高(项目索引,0,100)
list1.添加列(项目索引,0,2)
list1.置列宽(项目索引,0,0,300)
list1.控件_置标题(项目索引,0,0,"测试项目")
list1.控件_置字体颜色(项目索引,0,0,黑色)
list1.添加行(项目索引)
list1.置行高(项目索引,1,50)
list1.添加列(项目索引,1,0)
list1.置列宽(项目索引,1,0,150)
list1.控件_置标题(项目索引,1,0,"删除")
list1.添加列(项目索引,1,0)
list1.置列宽(项目索引,1,1,150)
list1.控件_置标题(项目索引,1,1,"修改")
list1.更新数据()
事件处理区分控件的方法:
事件list1.控件_被单击(项目索引为整数型,行索引为整数型,列索引为整数型)
如果行索引=1则
如果列索引=0则
弹出提示("“删除”被单击,项目索引:
"&项目索引)
否则如果列索引=1则
弹出提示("“修改”被单击,项目索引:
"&项目索引)
结束如果
结束如果
结束事件
效果图:
7、折叠式列表项
添加列表项的方法类似,只是在“标签”右边会添加一个用于折叠“按钮”,并且会调用一个新的方法“置行可视状态”
代码:
变量项目索引为整数型
项目索引=list1.添加列表项()
list1.添加行(项目索引)
list1.置行高(项目索引,0,50)
list1.添加列(项目索引,0,2)
list1.置列宽(项目索引,0,0,250)
list1.控件_置标题(项目索引,0,0,"测试项目")
list1.控件_置字体颜色(项目索引,0,0,黑色)
list1.添加列(项目索引,0,0)
list1.置列宽(项目索引,0,1,50)
list1.控件_置标题(项目索引,0,1,"∨")
list1.添加行(项目索引)
list1.置行高(项目索引,1,50)
list1.添加列(项目索引,1,0)
list1.置列宽(项目索引,1,0,150)
list1.控件_置标题(项目索引,1,0,"删除")
list1.添加列(项目索引,1,0)
list1.置列宽(项目索引,1,1,150)
list1.控件_置标题(项目索引,1,1,"修改")
list1.置行可视状态(项目索引,1,假)
list1.更新数据()
注意倒数第2行调用了“置行可视状态”方法,给指定项目索引(参数1)的指定行(参数2)设置可视状态(参数3),注意:
此方法调用后也需要“更新数据”。
然后处理按钮的单击事件(实际上是处理“超级列表框”的“控件_被单击”事件)来实现折叠与展开
事件list1.控件_被单击(项目索引为整数型,行索引为整数型,列索引为整数型)
如果行索引=0则
如果列索引=1则
如果list1.控件_取标题(项目索引,0,1)="∨"则
list1.置行可视状态(项目索引,1,真)
list1.控件_置标题(项目索引,0,1,"∧")
否则
list1.置行可视状态(项目索引,1,假)
list1.控件_置标题(项目索引,0,1,"∨")
结束如果
list1.更新数据()
结束如果
结束如果
结束事件
注意:
调用“置行可视状态”方法后千万不要忘记调用“更新数据”方法!
效果图:
8、绝对布局
我们要实现左图的效果,前面的表格布局并不能满足我们,我们需要使用绝对布局。
使用“列_置布局类型”设置布局类型,使用“列_绝对_置左边”、“列_绝对_置顶边”、“列_绝对_置宽度”、“列_绝对_置高度”设置位置(详见参考手册)
还有一个特殊的列叫空列,它只占位置,不显示内容。
原来的“置列宽”设置的列宽指定在原本的位置空多少,类似于空列。
见如下代码:
变量项目索引为整数型
项目索引=list1.添加列表项()
list1.添加行(项目索引)
list1.置行高(项目索引,0,50)
list1.添加列(项目索引,0,3)
list1.置列宽(项目索引,0,0,100)
list1.列_绝对_置左边(项目索引,0,0,0)
list1.列_绝对_置顶边(项目索引,0,0,0)
list1.列_绝对_置宽度(项目索引,0,0,100)
list1.列_绝对_置高度(项目索引,0,0,150)
list1.列_置布局类型(项目索引,0,0,1)
list1.控件_置图像(项目索引,0,0,"p.png")
list1.添加列(项目索引,0,2)
list1.置列宽(项目索引,0,1,200)
list1.控件_置标题(项目索引,0,1,"我是第一行文字")
list1.添加行(项目索引)
list1.置行高(项目索引,1,50)
list1.添加列(项目索引,1,-1)
list1.置列宽(项目索引,1,0,100)
list1.添加列(项目索引,1,2)
list1.置列宽(项目索引,1,1,200)
list1.控件_置标题(项目索引,1,1,"我是第二行文字")
list1.添加行(项目索引)
list1.置行高(项目索引,2,50)
list1.添加列(项目索引,2,-1)
list1.置列宽(项目索引,2,0,100)
list1.添加列(项目索引,2,2)
list1.置列宽(项目索引,2,1,200)
list1.控件_置标题(项目索引,2,1,"我是第三行文字")
list1.更新数据()
完整例程:
例程5.e4a
效果图:
参考手册
核心操作
超级列表框.创建超级列表框(容器container)
创建一个超级列表框
参数1类型为容器组件,用来存放“超级列表框”
{对象}.置顶边(整数型新顶边)
设置超级列表框的顶边
{对象}.置左边(整数型新左边)
设置超级列表框的左边
{对象}.置高度(整数型新高度)
设置超级列表框的高度
{对象}.置宽度(整数型新宽度)
设置超级列表框的宽度
整数型{对象}.取顶边()
获取超级列表框的顶边
整数型{对象}.取左边()
获取超级列表框的左边
整数型{对象}.取高度()
获取超级列表框的高度
整数型{对象}.取宽度()
获取超级列表框的宽度
整数型{对象}.添加列表项()
添加一个列表项,返回项目索引(从0开始)
整数型{对象}.添加行(整数型项目索引)
在指定列表项添加一行,返回行索引(从0开始)
整数型{对象}.添加列(整数型项目索引,整数型行索引,整数型类型)
添加列,返回列索引(从0开始)
参数1待加列所在的项目的索引
参数2待加列所在的行的索引
参数3待加列的类型(-1表示空列,0表示按钮,1表示编辑框,2表示标签,3表示图片框)
{对象}.置行高(整数型项目索引,整数型行索引,整数型新行高)
设置指定列表项的指定行的行高
{对象}.置列宽(整数型项目索引,整数型行索引,整数型列索引,整数型新列宽)
设置指定列表项的指定行的指定列的列宽。
如果布局为绝对布局,则相应位置相等于空列,因此此值依然有效。
{对象}.置行可视状态(整数型项目索引,整数型行索引,逻辑性可视状态)
设置指定列表项的指定行的可视状态
{对象}.删除项目(整数型项目索引)
删除指定项目
{对象}.删除行(整数型项目索引,整数型行索引)
删除指定项目的指定行
{对象}.删除列(整数型项目索引,整数型行索引,整数型列索引)
删除指定项目的指定行的指定列
{对象}.更新数据()
更新数据,在以下几种操作后需要更新数据。
添加列表项
添加行
添加列
置行高
置列宽
置行可视状态
删除项目
删除行
删除列
列_置布局类型
列_绝对_置左边
列_绝对_置顶边
列_绝对_置宽度
列_绝对_置高度
{对象}.列_置布局类型(整数型项目索引,整数型行索引,整数型列索引,整数型新布局类型)
设置布局类型,0表示表格布局,1表示绝对布局
{对象}.列_绝对_置左边(整数型项目索引,整数型行索引,整数型列索引,整数型新左边)
设置绝对布局下的左边
{对象}.列_绝对_置顶边(整数型项目索引,整数型行索引,整数型列索引,整数型新顶边)
设置绝对布局下的顶边
{对象}.列_绝对_置宽度(整数型项目索引,整数型行索引,整数型列索引,整数型新宽度)
设置绝对布局下的宽度
{对象}.列_绝对_置高度(整数型项目索引,整数型行索引,整数型列索引,整数型新高度)
设置绝对布局下的高度
各类组件
通用说明
所有组件的事件和方法均以“控件_”开头,且前三个参数分别为“整数型项目索引,整数型行索引,整数型列索引”
按钮
支持方法
参数
返回值
描述
控件_置标题
整数型项目索引,整数型行索引,整数型列索引,文本型标题
无返回值
指定组件的标题文本。
控件_置内容
整数型项目索引,整数型行索引,整数型列索引,文本型内容
无返回值
指定组件的标题文本。
控件_置字体大小
整数型项目索引,整数型行索引,整数型列索引,单精度小数型字体大小
无返回值
指定组件标题的字体大小。
控件_置字体颜色
整数型项目索引,整数型行索引,整数型列索引,整数型字体颜色
无返回值
指定组件标题的字体颜色。
控件_置对齐方式
整数型项目索引,整数型行索引,整数型列索引,整数型对齐方式
无返回值
指定组件标题的对齐方式。
控件_置粗体
整数型项目索引,整数型行索引,整数型列索引,逻辑型粗体
无返回值
指定组件标题是否为粗体。
控件_置斜体
整数型项目索引,整数型行索引,整数型列索引,逻辑型斜体
无返回值
指定组件标题是否为斜体。
控件_置背景颜色
整数型项目索引,整数型行索引,整数型列索引,整数型背景颜色
无返回值
指定组件的背景颜色。
控件_置透明度
整数型项目索引,整数型行索引,整数型列索引,整数型透明度
无返回值
指定组件的背景透明度,透明度范围为0到255,0为完全透明,255为不透明。
控件_置可用
整数型项目索引,整数型行索引,整数型列索引,逻辑型可用
无返回值
指定组件是否可用。
控件_置可视
整数型项目索引,整数型行索引,整数型列索引,逻辑型可视
无返回值
指定组件是否可视。
控件_置可停留焦点
整数型项目索引,整数型行索引,整数型列索引,逻辑型可停留焦点
无返回值
指定组件是否可停留焦点。
控件_刷新
整数型项目索引,整数型行索引,整数型列索引
无返回值
刷新组件。
控件_置图片
整数型项目索引,整数型行索引,整数型列索引,文本型图片
无返回值
指定按钮的背景图片,该图片必须是assets资源中的图片(例如:
"back.jpg")或SD卡上的图片(例如:
"/sdcard/back.jpg")。
控件_置按下图片
整数型项目索引,整数型行索引,整数型列索引,文本型按下图片
无返回值
指定当按钮被按下时的背景图片,该图片必须是assets资源中的图片(例如:
"back.jpg")或SD卡上的图片(例如:
"/sdcard/back.jpg")。
控件_置弹起图片
整数型项目索引,整数型行索引,整数型列索引,文本型弹起图片
无返回值
指定当按钮被弹起时的背景图片,该图片必须是assets资源中的图片(例如:
"back.jpg")或SD卡上的图片(例如:
"/sdcard/back.jpg")。
控件_置图片2
整数型项目索引,整数型行索引,整数型列索引,整数型图片2
无返回值
指定按钮的背景图片,该图片必须是res资源中的图片,请使用图片资源ID,例如:
R.back。
控件_置按下图片2
整数型项目索引,整数型行索引,整数型列索引,整数型按下图片2
无返回值
指定按钮被按下时的背景图片,该图片必须是res资源中的图片,请使用图片资源ID,例如:
R.back。
控件_置弹起图片2
整数型项目索引,整数型行索引,整数型列索引,整数型弹起图片2
无返回值
指定按钮被弹起时的背景图片,该图片必须是res资源中的图片,请使用图片资源ID,例如:
R.back。
控件_取标题
整数型项目索引,整数型行索引,整数型列索引
文本型
获取组件的标题文本。
控件_取内容
整数型项目索引,整数型行索引,整数型列索引
文本型
获取组件的标题文本。
控件_取字体大小
整数型项目索引,整数型行索引,整数型列索引
单精度小数型
获取组件标题的字体大小。
控件_取字体颜色
整数型项目索引,整数型行索引,整数型列索引
整数型
获取组件标题的字体颜色。
控件_取对齐方式
整数型项目索引,整数型行索引,整数型列索引
整数型
获取组件标题的对齐方式。
控件_取粗体
整数型项目索引,整数型行索引,整数型列索引
逻辑型
获取组件标题是否为粗体。
控件_取斜体
整数型项目索引,整数型行索引,整数型列索引
逻辑型
获取组件标题是否为斜体。
控件_取背景颜色
整数型项目索引,整数型行索引,整数型列索引
整数型
获取组件的背景颜色。
控件_取透明度
整数型项目索引,整数型行索引,整数型列索引
整数型
获取组件的背景透明度,透明度范围为0到255,0为完全透明,255为不透明。
控件_取可用
整数型项目索引,整数型行索引,整数型列索引
逻辑型
获取相应组件是否可用。
控件_取可视
整数型项目索引,整数型行索引,整数型列索引
逻辑型
获取组件是否可视。
控件_取可停留焦点
整数型项目索引,整数型行索引,整数型列索引
逻辑型
获取组件是否可停留焦点。
控件_取图片
整数型项目索引,整数型行索引,整数型列索引
文本型
获取按钮的背景图片,该图片必须是assets资源中的图片(例如:
"back.jpg")或SD卡上的图片(例如:
"/sdcard/back.jpg")。
控件_取按下图片
整数型项目索引,整数型行索引,整数型列索引
文本型
获取当按钮被按下时的背景图片,该图片必须是assets资源中的图片(例如:
"back.jpg")或SD卡上的图片(例如:
"/sdcard/back.jpg")。
控件_取弹起图片
整数型项目索引,整数型行索引,整数型列索引
文本型
获取当按钮被弹起时的背景图片,该图片必须是assets资源中的图片(例如:
"back.jpg")或SD卡上的图片(例如:
"/sdcard/back.jpg")。
控件_取图片2
整数型项目索引,整数型行索引,整数型列索引
整数型
获取按钮的背景图片,该图片必须是res资源中的图片,请使用图片资源ID,例如:
R.back。
控件_取按下图片2
整数型项目索引,整数型行索引,整数型列索引
整数型
获取按钮被按下时的背景图片,该图片必须是res资源中的图片,请使用图片资源ID,例如:
R.back。
控件_取弹起图片2
整数型项目索引,整数型行索引,整数型列索引
整数型
获取按钮被弹起时的背景图片,该图片必须是res资源中的图片,请使用图片资源ID,例如:
R.back。
控件_电视机关闭特效
整数型项目索引,整数型行索引,整数型列索引
无返回值
电视机关闭特效。
控件_开启特效
整数型项目索引,整数型行索引,整数型列索引,整数型特效类型,整数型特效时间,逻辑型特效保留
无返回值
开启指定动画特效。
参数一特效类型可以查看特效类型常量,1:
旋转,2:
缩放,3:
淡化。
参数二特效时间指定特效持续时间,单位为毫秒。
参数三特效停留指定是否保持特效结束时的状态。
控件_获取焦点
整数型项目索引,整数型行索引,整数型列索引
无返回值
使组件获取焦点。
支持事件
参数
描述
控件_创建完毕
整数型项目索引,整数型行索引,整数型列索引
当组件被创建后触发此事件。
控件_被单击
整数型项目索引,整数型行索引,整数型列索引
当组件被单击时触发此事件。
控件_被按下
整数型项目索引,整数型行索引,整数型列索引,整数型横坐标,整数型纵坐标
当组件被按下时触发此事件,返回按下时的坐标,注意:
该坐标以屏幕为参照系。
控件_被弹起
整数型项目索引,整数型行索引,整数型列索引,整数型横坐标,整数型纵坐标
当组件被弹起时触发此事件,返回按下时的坐标,注意:
该坐标以屏幕为参照系。
控件_被移动
整数型项目索引,整数型行索引,整数型列索引,整数型起点横坐标,整数型起点纵坐标,整数型终点横坐标,整数型终点纵坐标
当组件被移动时触发此事件,返回移动开始时和结束时的坐标,注意:
该坐标是以屏幕左上角为原点作为参照系。
控件_触摸手势
整数型项目索引,整数型行索引,整数型列索引,整数型手势类型
当用户触摸滑动屏幕后触发此事件,返回参数手势类型,具体类型数值可查看类库下方的手势类型常量。
控件_获得焦点
整数型项目索引,整数型行索引,整数型列索引
当组件获得焦点时触发此事件。
控件_失去焦点
整数型项目索引,整数型行索引,整数型列索引
当组件失去焦点时触发此事件。
编辑框
支持方法
参数
返回值
描述
控件_置标题
整数型项目索引,整数型行索引,整数型列索引,文本型标题