E4A使用手册

易语言FOR安卓使用手册

小刀（siyu1840）2013-06-01

前言：

易语言FOR安卓，以下简称E4A，是一个基于谷歌Simple语言的编程工具，旨在实现通过类似易语言的Basic语法轻松编写Android应用程序。只要你有易语言的基础，就可以很轻松上手。E4A拥有和易语言一样的可视化开发环境，以及强大的智能语法提示功能。纯中文编写代码，比英文更具亲和力，您也无需为记不住英文关键词而烦恼。E4A已经内置了Android1.5开发包SDK，您只需额外下载安装Java1.6开发包JDK即可。目前E4A还处于初级阶段，我们将继续完善她，立志把E4A打造成最简单易用的中文安卓开发工具！

一、 搭建开发环境

下载E4A安装程序，安装好后（安装路径不能有中文和空格），运行E4A，首次运行会出现如下界面，E4A已经内置了安卓1.5开发包，但是需要您额外下载Java1.6开发包，点击界面上的下载链接，下载好后安装该Java开发包，安装好后请在路径设置中设置您的JDK安装目录，并保存。E4A会自动据此设置JAVA_HOME。

二、 IDE界面介绍：

为了能让广大易友快速上手，E4A的IDE界面尽量和易语言界面靠拢，几乎都差不多，就不多费口舌了。这里着重说明一下两个菜单：

编译：将您的工程直接编译生成APK文件。

安装：将编译好的APK文件安装到虚拟机或手机。

卸载：将之前安装在设备上的APK卸载。

启动AVD：启动虚拟机管理器，用于调试编译好的APK文件，需要您事先安装好安卓虚拟机，至于如何安装，网上有大把教程，这里我就不再赘述了。

三、 新建工程：

您可以直接打开运行E4A，然后会出现新建工程面板，输入英文包名和应用名称即可，工程会被保存在E4A安装目录的projects文件夹中，编译后生成的APK文件会跟工程文件在同一目录中。您也可以直接单击鼠标右键新建E4A工程。

四、 可视化界面设计：

E4A的界面设计比较特殊，其实是按照行和列来排列组件的，在设计窗口界面时系统会自动帮您对齐到网格，这里需要注意的是，设计添加组件时，同一行的组件高度必须一致，而且组件不能叠在一起，否则会造成解析错误！

五、 代码输入：

E4A拥有易语言那样的智能语法提示，所以您完全不必担心因为输入中文代码而废掉更多的时间，您只需要输入关键词的首拼即可获得即时语法提示。另外，将鼠标停留在关键词或命令上，系统会自动为您显示语法提示块。

六、 调试运行：

源码成APK文件后，您可以选择把它安装到安卓虚拟机进行调试，也可以安装到手机进行调试，首先要开启您的虚拟机或者把您的手机开启调试模式后连接到电脑。具体如何操作，请问度娘。

七、 功能函数集合：

类别

文本操作

名称

寻找文本

格式

寻找文本(被搜寻的文本 为 文本型,欲寻找的文本 为 文本型,起始搜寻位置 为 整数型)为 整数型

倒找文本(被搜寻的文本 为 文本型,欲寻找的文本 为 文本型,起始搜寻位置 为 整数型)为 整数型

到小写(传址 待转换的文本 为 文本型)

到大写(传址 待转换的文本 为 文本型)

取文本左边(欲取其部分的文本 为

文本型,欲取出字符的数目 为 整数型)为 文本型

取文本右边(欲取其部分的文本 为

文本型,欲取出字符的数目 为 整数型)为 文本型

取文本中间(欲取其部分的文本 为

文本型,起始取出位置 为 整数型,欲取出字符的数目 为 整数型)为 文本型

取文本长度(文本数据 为 文本型)为

整数型

删首空(传址 欲删除空格的文本 为

文本型)

删尾空(传址 欲删除空格的文本 为

文本型)

删首尾空(传址 欲删除空格的文本

为 文本型)

子文本替换(传址 欲被替换的文本

为 文本型,欲被替换的子文本 为 文本型,用作替换的子文本 为 文本型,进行替换的起始位置 为 整数型,替换进行的次数 为 整数型)

文本比较(待比较文本一 为 文本型,待比较文本二 为 文本型)为 整数型

注释

返回一个整数值，指定一文本在另一文本中最先出现的位置。

返回一个整数值，指定一文本在另一文本中最后出现的位置。

将文本转换成小写。

将文本转换成大写。

返回一个文本，其中包含指定文本中从左边算起指定数量的字符。

返回一个文本，其中包含指定文本中从右边算起指定数量的字符。

返回一个文本，其中包含指定文本中从指定位置算起指定数量的字符。

取文本型数据的长度。

删除文本左边的空格。

删除文本右边的空格。

删除文本左右两边的空格。

倒找文本

到小写

到大写

取文本左边

取文本右边

取文本中间

取文本长度

删首空

删尾空

删首尾空

子文本替换

文本比较

翻转文本

将文本中指定的子文本替换成另一子文本，并且替换发生的次数也是被指定的。参数五：替换进行的次数，-1表示替换全部子文本。

如果返回值小于0，表示文本一小于文本二；如果等于0，表示文本一等于文本二；如果大于0，表示文本一大于文本二。

翻转文本(传址 文本数据 为 文本型) 翻转指定文本数据。

转换操作 到文本

到数值

字符转代码

代码转字符

到十六进制

算术运算 取绝对值

求反正切

求余弦

求反对数

取整

求自然对数

取最大值

取最小值

取随机数

求正弦

取符号

求平方根

求正切

角度转弧度

弧度转角度

文件操作 打开文件

打开文件2

关闭文件

到文本(待转换的数据 为 通用型)为

文本型

到数值(待转换的数据 为 通用型)为

双精度小数型

字符转代码(字符 为 文本型)为 整数型

代码转字符(代码 为 整数型)为 文本型

到十六进制(数值 为 通用型)为 文本型

取绝对值(数值 为 通用型)为 通用型

求反正切(数值 为 双精度小数型)为

双精度小数型

求余弦(数值 为 双精度小数型)为 双精度小数型

求反对数(数值 为 双精度小数型)为

双精度小数型

取整(数值 为 通用型)为 长整数型

求自然对数(数值 为 双精度小数型)为 双精度小数型

取最大值(数值一 为 通用型,数值二

为 通用型)为 通用型

取最小值(数值一 为 通用型,数值二

为 通用型)为 通用型

函数：取随机数()为 双精度小数型

求正弦(数值 为 双精度小数型)为 双精度小数型

取符号(数值 为 双精度小数型)为 整数型

求平方根(数值 为 双精度小数型)为

双精度小数型

求正切(数值 为 双精度小数型)为 双精度小数型

角度转弧度(角度 为 双精度小数型)为 双精度小数型

弧度转角度(弧度 为 双精度小数型)为 双精度小数型

打开文件(文件名 为 文本型)为 整数型

打开文件2(完整路径文件名 为 文本型)为 整数型

关闭文件(文件号 为 整数型)

将指定数据转换成文本。

将指定数据转换成数值。

字符转ASCII码，返回首字符的unicode值。

ASCII码转字符，返回给定unicode值的字符文本。

将指定数值转换成16进制文本。

返回数值的绝对值。

返回数值的反正切值。

返回数值的余弦值。

返回e(自然对数的底)的某次方。

注释：返回数值的整数部分。

返回数值的自然对数。

返回数值一和数值二中的最大值。

返回数值一和数值二中的最小值。

返回一个随机数。

返回数值的正弦值。

返回数值符号(1：正，0：零，-1：负)。

返回数值的平方根。

返回数值的正切值。

角度转弧度。

弧度转角度。

打开一个文件，返回文件号。

打开一个文件，需提供文件完整的路径，返回文件号。

关闭指定文件号的文件。

是否在文件尾

写出文本

读入文本

写出数值

读入数值

修改文件名

删除文件

删除文件2

文件是否存在

文件是否存在2

是否为文件夹

是否为文件夹2

新建文件夹

新建文件夹2

删除文件夹

删除文件夹2

置读写位置

取文件尺寸

应用操作 添加菜单

切换窗口

弹出提示

信息框

取时间

取日期

播放音乐

是否在文件尾(文件号 为 整数型)为

逻辑型

写出文本(文件号 为 整数型,欲写出文本 为 文本型)

读入文本(文件号 为 整数型)为 文本型

写出数值(文件号 为 整数型,欲写出数值 为 整数型)

读入数值(文件号 为 整数型)为 整数型

修改文件名(旧文件名 为 文本型,新文件名 为 文本型)

删除文件(文件名 为 文本型)

删除文件2(完整路径文件名 为 文本型)

文件是否存在(文件名 为 文本型)为

逻辑型

文件是否存在2(完整路径文件名 为

文本型)为 逻辑型

是否为文件夹(名称 为 文本型)为 逻辑型

是否为文件夹2(名称 为 文本型)为

逻辑型

新建文件夹(文件夹名 为 文本型)

新建文件夹2(文件夹名 为 文本型)

判断当前读写位置是否在文件的尾部。

写出一段文本数据到文件中当前读写位置处。

从文件中当前读写位置读取并返回一段文本数据。

写出一个数值数据到文件中当前读写位置处。

从文件中当前读写位置读取并返回一个数值数据。

重命名指定文件。

删除指定文件。

删除指定文件，需提供完整路径。

判断文件是否存在。

判断文件是否存在，需提供完整路径。

判断指定名称是否为文件夹。

判断指定名称是否为文件夹，需提供完整路径。

新建一个文件夹。

新建一个文件夹，需提供完整路径。

删除文件夹(文件夹名 为 文本型) 删除指定文件夹。

删除文件夹2(文件夹名 为 文本型) 删除指定文件夹，需提供完整路径。

置读写位置(文件号 为 整数型,位置 重置读写位置，返回偏移之后的为 长整数型)为 长整数型 新地址。

取文件尺寸(文件号 为 整数型)为 长返回文件的尺寸大小。

整数型

添加菜单(菜单项 为 文本型) 添加一个菜单。

切换窗口(新 窗口名称 为 窗口) 切换到指定窗口，例如：切换窗口(新 窗口2)。

弹出提示(提示信息 为 文本型) 弹出提示信息。

信息框(标题 为 文本型,信息 为 文弹出信息框。

本型,按钮标题 为 文本型)

取时间()为 文本型 获取当前时间。

取日期()为 文本型 获取当前日期。

播放音乐(文件名 为 文本型) 播放APK资源中的音乐。

播放音乐2

SQL执行

SQL查询

数组操作 过滤数组

播放音乐2(完整路径文件名 为 文本型)

SQL执行(数据库名称 为 文本型,SQL命令 为 文本型)

SQL查询(数据库名称 为 文本型,SQL命令 为 文本型,列分隔符 为

文本型,行分隔符 为 文本型)为 文本型

过滤数组(要过滤的文本数组 为 文本型(),要寻找的子文本 为 文本型,是否保留 为 逻辑型)为 文本型()

播放SD卡中的音乐，需提供完整路径。

对sqlite3数据库执行SQL命令。

连接数组成员

分割文本

取数组下标

流程控制 如果

判断

判断循环首

变量循环首

容错处理首

调用事件

对数据库执行SQL查询命令，返回查询结果，每条记录中的项目用指定列分隔符连接，各条记录之间用指定行分隔符连接。

在一个文本数组中寻找指定子文本，如果保留则返回包含该子文本的数组，否则返回不含该子文本的数组。

连接数组成员(文本数组 为 文本型(),将一个文本数组的成员用指定文连接文本 为 文本型)为 文本型 本连接起来，返回连接后的文本。

分割文本(待分割的文本 为 文本型,将指定文本进行分割，返回分割用作分割的文本 为 文本型,分割次数 后的文本数组。

为 整数型)为 文本型()

取数组下标(数组 为 通用型,维度 为 返回指定数组维度可用的最大下整数型)为 整数型 标。

如果 表达式 则

[语句]

[否则如果 表达式 则]

[语句]

[否则]

[语句]

结束 如果

判断 分支 表达式

[分支 表达式列表]

[语句]

[分支 否则]

[语句]

结束 判断

判断循环首 条件表达式

[语句]

判断循环尾

变量循环首 循环变量 = 起始值 至

结束值 [步进 步进值]

[语句]

变量循环尾

容错处理首

[分支]

[语句]

容错处理尾

调用事件 事件名称

集合

退出

结束程序

项目总数

加入项目

清空

是否包含

取项目

删除项目

退出 [循环]或[函数]或[过程]

结束程序()

项目总数

返回集合的项目总数，该属性为只读属性。

加入项目(项目 为 通用型) 向集合中加入项目，可以是任意类型的数据。

清空() 清空集合中所有的项目。

是否包含(项目 为 通用型)为 逻辑型 判断集合中是否存在某个项目，返回真或假。

取项目(索引 为 整数型)为 通用型 取指定索引的项目，返回项目数据。

删除项目(项目 为 通用型) 删除指定项目。

八、 控件

类别

窗口

属性、方法、事件

属性：标题

属性：背景颜色

事件：创建完毕()

事件：按下某键(键代码 为 整数型)

菜单被选择(菜单名 为 文本型)

触摸手势(方向 为 整数型)

属性：宽度

属性：高度

属性：标题

属性：字体大小

属性：粗体

属性：斜体

属性：可用

事件：创建完毕()

事件：被单击()

事件：获得焦点()

事件：失去焦点()

属性：宽度

属性：高度

属性：内容

属性：字体大小

属性：字体颜色

属性：对齐方式

属性：粗体

属性：斜体

注释

本属性指定或获取相应组件的标题文本。

本属性指定或获取相应组件的背景颜色。

当窗口被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

当用户按下某键后产生此事件。

当用户选择菜单后产生此事件。

当用户触摸滑动屏幕后产生此事件。

本属性指定或获取相应组件的宽度。

本属性指定或获取相应组件的高度。

本属性指定或获取相应组件的标题。

本属性指定或获取相应组件标题的字体大小。

本属性指定或获取相应组件标题是否为粗体。

本属性指定或获取相应组件标题是否为斜体。

本属性指定或获取相应组件是否启用。

当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

按钮被单击事件。

组件获得焦点事件。

组件失去焦点事件。

本属性指定或获取相应组件的宽度。

本属性指定或获取相应组件的高度。

本属性指定或获取相应组件的内容文本。

本属性指定或获取相应组件内容的字体大小。

本属性指定或获取相应组件内容的字体颜色。

本属性指定或获取相应组件内容的对齐方式。

本属性指定或获取相应组件内容是否为粗体。

本属性指定或获取相应组件内容是否为斜体。

按钮

编辑框

属性：背景颜色

属性：可用

事件：创建完毕()

事件：获得焦点()

事件：失去焦点()

属性：宽度

属性：高度

属性：标题

属性：字体大小

属性：字体颜色

属性：对齐方式

属性：粗体

属性：斜体

属性：背景颜色

属性：可用

事件：创建完毕()

事件：被单击()

属性：宽度

属性：高度

属性：背景颜色

属性：图像

事件：创建完毕()

事件：被单击()

属性：宽度

属性：高度

属性：标题

属性：字体大小

属性：字体颜色

属性：对齐方式

标签

图片框

单选框

本属性指定或获取相应组件的背景颜色。

本属性指定或获取相应组件是否启用。

当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

组件获得焦点事件。

组件失去焦点事件。

本属性指定或获取相应组件的宽度。

本属性指定或获取相应组件的高度。

本属性指定或获取相应组件的标题。

本属性指定或获取相应组件标题的字体大小。

本属性指定或获取相应组件标题的字体颜色。

本属性指定或获取相应组件内容的对齐方式。

本属性指定或获取相应组件标题是否为粗体。

本属性指定或获取相应组件标题是否为斜体。

本属性指定或获取相应组件的背景颜色。

本属性指定或获取相应组件是否启用。

当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

标签被单击事件。

本属性指定或获取相应组件的宽度。

本属性指定或获取相应组件的高度。

本属性指定或获取相应组件的背景颜色。

本属性指定或获取相应组件的图像。

当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

图片框被单击事件。

本属性指定或获取相应组件的宽度。

本属性指定或获取相应组件的高度。

本属性指定或获取相应组件的标题。

本属性指定或获取相应组件标题的字体大小。

本属性指定或获取相应组件标题的字体颜色。

本属性指定或获取相应组件内容的对齐方式。

属性：粗体

选择框

画板

本属性指定或获取相应组件标题是否为粗体。

属性：斜体 本属性指定或获取相应组件标题是否为斜体。

属性：背景颜色 本属性指定或获取相应组件的背景颜色。

属性：选中 本属性指定或获取相应组件是否被选中。

属性：可用 本属性指定或获取相应组件是否启用。

事件：创建完毕() 当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

事件：选择改变() 单选框的选择状态被改变事件。

事件：获得焦点() 组件获得焦点事件。

事件：失去焦点() 组件失去焦点事件。

属性：宽度 本属性指定或获取相应组件的宽度。

属性：高度 本属性指定或获取相应组件的高度。

属性：标题 本属性指定或获取相应组件的标题。

属性：字体大小 本属性指定或获取相应组件标题的字体大小。

属性：字体颜色 本属性指定或获取相应组件标题的字体颜色。

属性：对齐方式 本属性指定或获取相应组件内容的对齐方式。

属性：粗体 本属性指定或获取相应组件标题是否为粗体。

属性：斜体 本属性指定或获取相应组件标题是否为斜体。

属性：背景颜色 本属性指定或获取相应组件的背景颜色。

属性：选中 本属性指定或获取相应组件是否被选中。

属性：可用 本属性指定或获取相应组件是否启用。

事件：创建完毕() 当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

事件：选择改变() 选择框的选择状态被改变事件。

事件：获得焦点() 组件获得焦点事件。

事件：失去焦点() 组件失去焦点事件。

方法：清空() 清空画布中所有绘制内容。

方法：画圆(横坐标 为 整数型,纵坐标 为 整数型,在指定点(横坐标,纵坐标)绘制指定半径半径 为 整数型) 的圆。

方法：画直线(起点横坐标 为 整数型,起点纵坐标 在指定起点和终点之间画线段。

为 整数型,终点横坐标 为 整数型,终点纵坐标 为

整数型)

方法：画点(横坐标 为 整数型,纵坐标 为 整数型)

属性：宽度

属性：高度

属性：背景颜色

密码编辑框

手机

在指定点(横坐标,纵坐标)画点。

本属性指定或获取相应组件的宽度。

本属性指定或获取相应组件的高度。

本属性指定或获取相应组件的背景颜色。

属性：画笔颜色 本属性指定或获取相应组件的画笔颜色。

事件：创建完毕() 当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

事件：被触摸(横坐标 为 整数型,纵坐标 为 整数画板被触摸事件，返回触摸位置的横坐型) 标和纵坐标。

属性：宽度 本属性指定或获取相应组件的宽度。

属性：高度 本属性指定或获取相应组件的高度。

属性：内容 本属性指定或获取相应组件的内容文本。

属性：字体大小 本属性指定或获取相应组件内容的字体大小。

属性：字体颜色 本属性指定或获取相应组件内容的字体颜色。

属性：对齐方式 本属性指定或获取相应组件内容的对齐方式。

属性：粗体 本属性指定或获取相应组件内容是否为粗体。

属性：斜体 本属性指定或获取相应组件内容是否为斜体。

属性：背景颜色 本属性指定或获取相应组件的背景颜色。

属性：可用 本属性指定或获取相应组件是否启用。

事件：创建完毕() 当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

事件：获得焦点() 组件获得焦点事件。

事件：失去焦点() 组件失去焦点事件。

方法：拨号(号码 为 文本型) 拨打电话，号码为文本型。

方法：振动(时长 为 整数型) 发出指定时长的振动，时长为整数形，单位为毫秒。

方法：发送短信(号码 为 文本型,内容 为 文本型,向指定号码发送短信，并发出提示（为提示 为 文本型) 了避免开发后台悄悄发送短信的程序，提示内容即使为空也会有默认提示消息）。

方法：发送邮件(地址 为 文本型,内容 为 文本型) 调用系统邮件程序向指定邮件地址发送邮件（发送过程需要用户确认）。

方法：跳转网址(网址 为 文本型) 调用系统默认浏览器打开指定网址。

位置传感器

方向传感器

时钟

进度条

方法：发送数据(地址 为 文本型,端口 为 整数型,发送网络数据。

数据 为 文本型)

属性：有效 本属性获取相应硬件是否有效。

事件：创建完毕() 当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

属性：有效 本属性获取相应硬件是否有效。

属性：可用 本属性指定或获取相应硬件是否启用。

属性：纬度 本属性获取手机所在位置的纬度。

属性：经度 本属性获取手机所在位置的经度。

属性：高度 本属性获取手机所在位置的高度。

属性：精度 本属性获取手机定位的精度。

属性：当前位置 本属性获取手机当前所在位置。

事件：创建完毕() 当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

事件：位置改变(纬度 为 双精度小数型,经度 为 双GPS位置发生变化时触发此事件，并得精度小数型,高度 为 双精度小数型) 到纬度、经度和高度三个返回值。

属性：有效 本属性获取相应硬件是否有效。

属性：可用 本属性指定或获取相应硬件是否启用。

属性：偏航角 本属性获取手机的偏航角，以Z轴为轴心，0°为北，90°为东，180°为南，270°为西。

属性：俯仰角 本属性获取手机的俯仰角，以X轴为轴心的倾角（-180°~180°）。

属性：横滚角 本属性获取手机的横滚角，以Y轴为轴心的倾角（-90°~90°）。

属性：倾斜角 本属性获取手机的倾斜角。

事件：创建完毕() 当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

事件：方向改变(偏航角 为 单精度小数型, 俯仰角 手机倾斜角度发生变化时触发此事件，为 单精度小数型, 横滚角 为 单精度小数型) 并获得三个方向的倾角。

属性：可用 本属性指定或获取相应硬件是否启用。

属性：时钟周期 本属性指定或获取时钟的时间间隔，单 位为毫秒。

事件：创建完毕() 当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

事件：周期事件() 时钟完成一次时钟周期时触发此事件。

属性：宽度 本属性指定或获取相应组件的宽度。

属性：高度 本属性指定或获取相应组件的高度。

属性：最大位置 本属性指定或获取进度条的最大位置，默认为100。

属性：位置 本属性指定或获取进度条的位置，必须为整数型。

事件：创建完毕()

浏览框 方法：跳转(网址 为 文本型)

方法：后退()

方法：前进()

方法：刷新()

方法：停止()

属性：宽度

属性：高度

属性：保存密码

属性：保存表单

属性：启用JS

属性：启用缩放

属性：启用缩放按钮

事件：创建完毕()

当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

跳转至指定网址，必须使用以开头的完整网址。

后退。

前进。

刷新。

停止。

本属性指定或获取相应组件的宽度。

本属性指定或获取相应组件的高度。

本属性指定浏览框是否保存密码。

本属性指定浏览框是否保存表单数据。

本属性指定浏览框是否启用JavaScript。

本属性指定浏览框是否启用缩放模式。

本属性指定浏览框是否启用缩放按钮。

当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。

九、 数据类型

类型

逻辑型

字节型

短整数型

整数型

长整数型

单精度小数型

双精度小数型

文本型

日期时间型

通用型

对象型

英文

Boolean

Byte

Short

Integer

Long

Single

Double

String

Date

Variant

Object

注释

表示两个逻辑值：真和假。

表示8位的有符号整数值，在-128到127之间。

表示16位的有符号整数值，在-32768到32767之间。

表示32位的有符号整数值，在-2147483648到2147483647之间。

表示64位的有符号整数值，从-92233729223372之间。

表示32位的单精度浮点数，遵循IEEE754标准。

表示64位的单精度浮点数，遵循IEEE754标准。

表示一系列的字符串，可以为空。

与型跟Java中的ar类相匹配。

可以表示任何顺序的其他数据类型(基本类型、数组，对象类型等)。

到