超级列表框使用说明.docx

超级列表框使用说明.docx

《超级列表框使用说明.docx》由会员分享，可在线阅读，更多相关《超级列表框使用说明.docx（39页珍藏版）》请在冰点文库上搜索。

超级列表框使用说明

超级列表框使用说明

说明

版本：

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：

淡化。

参数二特效时间指定特效持续时间，单位为毫秒。

参数三特效停留指定是否保持特效结束时的状态。

控件_获取焦点

整数型项目索引,整数型行索引,整数型列索引

无返回值

使组件获取焦点。

支持事件

参数

描述

控件_创建完毕

整数型项目索引,整数型行索引,整数型列索引

当组件被创建后触发此事件。

控件_被单击

整数型项目索引,整数型行索引,整数型列索引

当组件被单击时触发此事件。

控件_被按下

整数型项目索引,整数型行索引,整数型列索引,整数型横坐标,整数型纵坐标

当组件被按下时触发此事件，返回按下时的坐标，注意：

该坐标以屏幕为参照系。

控件_被弹起

整数型项目索引,整数型行索引,整数型列索引,整数型横坐标,整数型纵坐标

当组件被弹起时触发此事件，返回按下时的坐标，注意：

该坐标以屏幕为参照系。

控件_被移动

整数型项目索引,整数型行索引,整数型列索引,整数型起点横坐标,整数型起点纵坐标,整数型终点横坐标,整数型终点纵坐标

当组件被移动时触发此事件，返回移动开始时和结束时的坐标，注意：

该坐标是以屏幕左上角为原点作为参照系。

控件_触摸手势

整数型项目索引,整数型行索引,整数型列索引,整数型手势类型

当用户触摸滑动屏幕后触发此事件，返回参数手势类型，具体类型数值可查看类库下方的手势类型常量。

控件_获得焦点

整数型项目索引,整数型行索引,整数型列索引

当组件获得焦点时触发此事件。

控件_失去焦点

整数型项目索引,整数型行索引,整数型列索引

当组件失去焦点时触发此事件。

编辑框

支持方法

参数

返回值

描述

控件_置标题

整数型项目索引,整数型行索引,整数型列索引,文本型标题