E4A使用手册.docx

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

2、！一、搭建开发环境下载E4A安装程序，安装好后（安装路径不能有中文和空格），运行E4A，首次运行会出现如下界面，E4A已经内置了安卓1.5开发包，但是需要您额外下载Java1.6开发包，点击界面上的下载链接，下载好后安装该Java开发包，安装好后请在路径设置中设置您的JDK安装目录，并保存。E4A会自动据此设置JAVA_HOME。二、IDE界面介绍：为了能让广大易友快速上手，E4A的IDE界面尽量和易语言界面靠拢，几乎都差不多，就不多费口舌了。这里着重说明一下两个菜单： 编译：将您的工程直接编译生成APK文件。安装：将编译好的APK文件安装到虚拟机或手机。卸载：将之前安装在设备上的APK卸载。

3、启动AVD：启动虚拟机管理器，用于调试编译好的APK文件，需要您事先安装好安卓虚拟机，至于如何安装，网上有大把教程，这里我就不再赘述了。三、新建工程：您可以直接打开运行E4A，然后会出现新建工程面板，输入英文包名和应用名称即可，工程会被保存在E4A安装目录的projects文件夹中，编译后生成的APK文件会跟工程文件在同一目录中。您也可以直接单击鼠标右键新建E4A工程。四、可视化界面设计：E4A的界面设计比较特殊，其实是按照行和列来排列组件的，在设计窗口界面时系统会自动帮您对齐到网格，这里需要注意的是，设计添加组件时，同一行的组件高度必须一致，而且组件不能叠在一起，否则会造成解析错误！五、代码

4、输入：E4A拥有易语言那样的智能语法提示，所以您完全不必担心因为输入中文代码而废掉更多的时间，您只需要输入关键词的首拼即可获得即时语法提示。另外，将鼠标停留在关键词或命令上，系统会自动为您显示语法提示块。 六、调试运行：源码成APK文件后，您可以选择把它安装到安卓虚拟机进行调试，也可以安装到手机进行调试，首先要开启您的虚拟机或者把您的手机开启调试模式后连接到电脑。具体如何操作，请问度娘。七、功能函数集合：类别名称格式注释文本操作寻找文本寻找文本(被搜寻的文本 为 文本型,欲寻找的文本 为 文本型,起始搜寻位置 为 整数型)为 整数型返回一个整数值，指定一文本在另一文本中最先出现的位置。倒找文本

5、倒找文本(被搜寻的文本 为 文本型,欲寻找的文本 为 文本型,起始搜寻位置 为 整数型)为 整数型返回一个整数值，指定一文本在另一文本中最后出现的位置。到小写到小写(传址 待转换的文本 为 文本型)将文本转换成小写。到大写到大写(传址 待转换的文本 为 文本型)将文本转换成大写。取文本左边取文本左边(欲取其部分的文本 为 文本型,欲取出字符的数目 为 整数型)为 文本型返回一个文本，其中包含指定文本中从左边算起指定数量的字符。取文本右边取文本右边(欲取其部分的文本 为 文本型,欲取出字符的数目 为 整数型)为 文本型返回一个文本，其中包含指定文本中从右边算起指定数量的字符。取文本中间取文本中间

6、(欲取其部分的文本 为 文本型,起始取出位置 为 整数型,欲取出字符的数目 为 整数型)为 文本型返回一个文本，其中包含指定文本中从指定位置算起指定数量的字符。取文本长度取文本长度(文本数据 为 文本型)为 整数型取文本型数据的长度。删首空删首空(传址 欲删除空格的文本 为 文本型)删除文本左边的空格。删尾空删尾空(传址 欲删除空格的文本 为 文本型)删除文本右边的空格。删首尾空删首尾空(传址 欲删除空格的文本 为 文本型)删除文本左右两边的空格。子文本替换子文本替换(传址 欲被替换的文本 为 文本型,欲被替换的子文本 为 文本型,用作替换的子文本 为 文本型,进行替换的起始位置 为 整数型,

7、替换进行的次数 为 整数型)将文本中指定的子文本替换成另一子文本，并且替换发生的次数也是被指定的。参数五：替换进行的次数，-1表示替换全部子文本。文本比较文本比较(待比较文本一 为 文本型,待比较文本二 为 文本型)为 整数型如果返回值小于0，表示文本一小于文本二；如果等于0，表示文本一等于文本二；如果大于0，表示文本一大于文本二。翻转文本翻转文本(传址 文本数据 为 文本型)翻转指定文本数据。转换操作到文本到文本(待转换的数据 为 通用型)为 文本型将指定数据转换成文本。到数值到数值(待转换的数据 为 通用型)为 双精度小数型将指定数据转换成数值。字符转代码字符转代码(字符 为 文本型)为

8、整数型字符转ASCII码，返回首字符的unicode值。代码转字符代码转字符(代码 为 整数型)为 文本型ASCII码转字符，返回给定unicode值的字符文本。到十六进制到十六进制(数值 为 通用型)为 文本型将指定数值转换成16进制文本。算术运算取绝对值取绝对值(数值 为 通用型)为 通用型返回数值的绝对值。求反正切求反正切(数值 为 双精度小数型)为 双精度小数型返回数值的反正切值。求余弦求余弦(数值 为 双精度小数型)为 双精度小数型返回数值的余弦值。求反对数求反对数(数值 为 双精度小数型)为 双精度小数型返回e(自然对数的底)的某次方。取整取整(数值 为 通用型)为 长整数型注释：

9、返回数值的整数部分。求自然对数求自然对数(数值 为 双精度小数型)为 双精度小数型返回数值的自然对数。取最大值取最大值(数值一 为 通用型,数值二 为 通用型)为 通用型返回数值一和数值二中的最大值。取最小值取最小值(数值一 为 通用型,数值二 为 通用型)为 通用型返回数值一和数值二中的最小值。取随机数函数：取随机数()为 双精度小数型返回一个随机数。求正弦求正弦(数值 为 双精度小数型)为 双精度小数型返回数值的正弦值。取符号取符号(数值 为 双精度小数型)为 整数型返回数值符号(1：正，0：零，-1：负)。求平方根求平方根(数值 为 双精度小数型)为 双精度小数型返回数值的平方根。求正切

10、求正切(数值 为 双精度小数型)为 双精度小数型返回数值的正切值。角度转弧度角度转弧度(角度 为 双精度小数型)为 双精度小数型角度转弧度。弧度转角度弧度转角度(弧度 为 双精度小数型)为 双精度小数型弧度转角度。文件操作打开文件打开文件(文件名 为 文本型)为 整数型打开一个文件，返回文件号。打开文件2打开文件2(完整路径文件名 为 文本型)为 整数型打开一个文件，需提供文件完整的路径，返回文件号。关闭文件关闭文件(文件号 为 整数型)关闭指定文件号的文件。是否在文件尾是否在文件尾(文件号 为 整数型)为 逻辑型判断当前读写位置是否在文件的尾部。写出文本写出文本(文件号 为 整数型,欲写出文

11、本 为 文本型)写出一段文本数据到文件中当前读写位置处。读入文本读入文本(文件号 为 整数型)为 文本型从文件中当前读写位置读取并返回一段文本数据。写出数值写出数值(文件号 为 整数型,欲写出数值 为 整数型)写出一个数值数据到文件中当前读写位置处。读入数值读入数值(文件号 为 整数型)为 整数型从文件中当前读写位置读取并返回一个数值数据。修改文件名修改文件名(旧文件名 为 文本型,新文件名 为 文本型)重命名指定文件。删除文件删除文件(文件名 为 文本型)删除指定文件。删除文件2删除文件2(完整路径文件名 为 文本型)删除指定文件，需提供完整路径。文件是否存在文件是否存在(文件名 为 文本型

12、)为 逻辑型判断文件是否存在。文件是否存在2文件是否存在2(完整路径文件名 为 文本型)为 逻辑型判断文件是否存在，需提供完整路径。是否为文件夹是否为文件夹(名称 为 文本型)为 逻辑型判断指定名称是否为文件夹。是否为文件夹2是否为文件夹2(名称 为 文本型)为 逻辑型判断指定名称是否为文件夹，需提供完整路径。新建文件夹新建文件夹(文件夹名 为 文本型)新建一个文件夹。新建文件夹2新建文件夹2(文件夹名 为 文本型)新建一个文件夹，需提供完整路径。删除文件夹删除文件夹(文件夹名 为 文本型)删除指定文件夹。删除文件夹2删除文件夹2(文件夹名 为 文本型)删除指定文件夹，需提供完整路径。置读写位

13、置置读写位置(文件号 为 整数型,位置 为 长整数型)为 长整数型重置读写位置，返回偏移之后的新地址。取文件尺寸取文件尺寸(文件号 为 整数型)为 长整数型返回文件的尺寸大小。应用操作添加菜单添加菜单(菜单项 为 文本型)添加一个菜单。切换窗口切换窗口(新 窗口名称 为 窗口)切换到指定窗口，例如：切换窗口(新 窗口2)。弹出提示弹出提示(提示信息 为 文本型)弹出提示信息。信息框信息框(标题 为 文本型,信息 为 文本型,按钮标题 为 文本型)弹出信息框。取时间取时间()为 文本型获取当前时间。取日期取日期()为 文本型获取当前日期。播放音乐播放音乐(文件名 为 文本型)播放APK资源中的音

14、乐。播放音乐2播放音乐2(完整路径文件名 为 文本型)播放SD卡中的音乐，需提供完整路径。SQL执行SQL执行(数据库名称 为 文本型,SQL命令 为 文本型)对sqlite3数据库执行SQL命令。SQL查询SQL查询(数据库名称 为 文本型,SQL命令 为 文本型,列分隔符 为 文本型,行分隔符 为 文本型)为 文本型对数据库执行SQL查询命令，返回查询结果，每条记录中的项目用指定列分隔符连接，各条记录之间用指定行分隔符连接。数组操作过滤数组过滤数组(要过滤的文本数组 为 文本型(),要寻找的子文本 为 文本型,是否保留 为 逻辑型)为 文本型()在一个文本数组中寻找指定子文本，如果保留则返

15、回包含该子文本的数组，否则返回不含该子文本的数组。连接数组成员连接数组成员(文本数组 为 文本型(),连接文本 为 文本型)为 文本型将一个文本数组的成员用指定文本连接起来，返回连接后的文本。分割文本分割文本(待分割的文本 为 文本型,用作分割的文本 为 文本型,分割次数 为 整数型)为 文本型()将指定文本进行分割，返回分割后的文本数组。取数组下标取数组下标(数组 为 通用型,维度 为 整数型)为 整数型返回指定数组维度可用的最大下标。流程控制如果如果 表达式 则语句否则如果 表达式 则语句否则语句结束 如果判断判断 分支 表达式分支 表达式列表 语句分支 否则语句结束 判断判断循环首判断循

16、环首 条件表达式语句判断循环尾变量循环首变量循环首 循环变量 = 起始值 至 结束值 步进 步进值语句变量循环尾容错处理首容错处理首分支语句容错处理尾调用事件调用事件 事件名称退出退出 循环或函数或过程结束程序结束程序()集合项目总数项目总数返回集合的项目总数，该属性为只读属性。加入项目加入项目(项目 为 通用型)向集合中加入项目，可以是任意类型的数据。清空清空()清空集合中所有的项目。是否包含是否包含(项目 为 通用型)为 逻辑型判断集合中是否存在某个项目，返回真或假。取项目取项目(索引 为 整数型)为 通用型取指定索引的项目，返回项目数据。删除项目删除项目(项目 为 通用型)删除指定项目。

17、八、控件类别属性、方法、事件注释窗口属性：标题本属性指定或获取相应组件的标题文本。属性：背景颜色本属性指定或获取相应组件的背景颜色。事件：创建完毕()当窗口被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：按下某键(键代码 为 整数型)当用户按下某键后产生此事件。菜单被选择(菜单名 为 文本型)当用户选择菜单后产生此事件。触摸手势(方向 为 整数型)当用户触摸滑动屏幕后产生此事件。按钮属性：宽度本属性指定或获取相应组件的宽度。属性：高度本属性指定或获取相应组件的高度。属性：标题本属性指定或获取相应组件的标题。属性：字体大小本属性指定或获取相应组件标题的字体大小。属性：粗体本属性指

18、定或获取相应组件标题是否为粗体。属性：斜体本属性指定或获取相应组件标题是否为斜体。属性：可用本属性指定或获取相应组件是否启用。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：被单击()按钮被单击事件。事件：获得焦点()组件获得焦点事件。事件：失去焦点()组件失去焦点事件。编辑框属性：宽度本属性指定或获取相应组件的宽度。属性：高度本属性指定或获取相应组件的高度。属性：内容本属性指定或获取相应组件的内容文本。属性：字体大小本属性指定或获取相应组件内容的字体大小。属性：字体颜色本属性指定或获取相应组件内容的字体颜色。属性：对齐方式本属性指定或获取相应组件内容的

19、对齐方式。属性：粗体本属性指定或获取相应组件内容是否为粗体。属性：斜体本属性指定或获取相应组件内容是否为斜体。属性：背景颜色本属性指定或获取相应组件的背景颜色。属性：可用本属性指定或获取相应组件是否启用。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：获得焦点()组件获得焦点事件。事件：失去焦点()组件失去焦点事件。标签属性：宽度本属性指定或获取相应组件的宽度。属性：高度本属性指定或获取相应组件的高度。属性：标题本属性指定或获取相应组件的标题。属性：字体大小本属性指定或获取相应组件标题的字体大小。属性：字体颜色本属性指定或获取相应组件标题的字体颜色。属性

20、：对齐方式本属性指定或获取相应组件内容的对齐方式。属性：粗体本属性指定或获取相应组件标题是否为粗体。属性：斜体本属性指定或获取相应组件标题是否为斜体。属性：背景颜色本属性指定或获取相应组件的背景颜色。属性：可用本属性指定或获取相应组件是否启用。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：被单击()标签被单击事件。图片框属性：宽度本属性指定或获取相应组件的宽度。属性：高度本属性指定或获取相应组件的高度。属性：背景颜色本属性指定或获取相应组件的背景颜色。属性：图像本属性指定或获取相应组件的图像。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件

21、期间做一些初始化工作。事件：被单击()图片框被单击事件。单选框属性：宽度本属性指定或获取相应组件的宽度。属性：高度本属性指定或获取相应组件的高度。属性：标题本属性指定或获取相应组件的标题。属性：字体大小本属性指定或获取相应组件标题的字体大小。属性：字体颜色本属性指定或获取相应组件标题的字体颜色。属性：对齐方式本属性指定或获取相应组件内容的对齐方式。属性：粗体本属性指定或获取相应组件标题是否为粗体。属性：斜体本属性指定或获取相应组件标题是否为斜体。属性：背景颜色本属性指定或获取相应组件的背景颜色。属性：选中本属性指定或获取相应组件是否被选中。属性：可用本属性指定或获取相应组件是否启用。事件：创建

22、完毕()当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：选择改变()单选框的选择状态被改变事件。事件：获得焦点()组件获得焦点事件。事件：失去焦点()组件失去焦点事件。选择框属性：宽度本属性指定或获取相应组件的宽度。属性：高度本属性指定或获取相应组件的高度。属性：标题本属性指定或获取相应组件的标题。属性：字体大小本属性指定或获取相应组件标题的字体大小。属性：字体颜色本属性指定或获取相应组件标题的字体颜色。属性：对齐方式本属性指定或获取相应组件内容的对齐方式。属性：粗体本属性指定或获取相应组件标题是否为粗体。属性：斜体本属性指定或获取相应组件标题是否为斜体。属性：背景颜色本

23、属性指定或获取相应组件的背景颜色。属性：选中本属性指定或获取相应组件是否被选中。属性：可用本属性指定或获取相应组件是否启用。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：选择改变()选择框的选择状态被改变事件。事件：获得焦点()组件获得焦点事件。事件：失去焦点()组件失去焦点事件。画板方法：清空()清空画布中所有绘制内容。方法：画圆(横坐标 为 整数型,纵坐标 为 整数型,半径 为 整数型)在指定点(横坐标,纵坐标)绘制指定半径的圆。方法：画直线(起点横坐标 为 整数型,起点纵坐标 为 整数型,终点横坐标 为 整数型,终点纵坐标 为 整数型)在指定起点

24、和终点之间画线段。方法：画点(横坐标 为 整数型,纵坐标 为 整数型)在指定点(横坐标,纵坐标)画点。属性：宽度本属性指定或获取相应组件的宽度。属性：高度本属性指定或获取相应组件的高度。属性：背景颜色本属性指定或获取相应组件的背景颜色。属性：画笔颜色本属性指定或获取相应组件的画笔颜色。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：被触摸(横坐标 为 整数型,纵坐标 为 整数型)画板被触摸事件，返回触摸位置的横坐标和纵坐标。密码编辑框属性：宽度本属性指定或获取相应组件的宽度。属性：高度本属性指定或获取相应组件的高度。属性：内容本属性指定或获取相应组件的内

25、容文本。属性：字体大小本属性指定或获取相应组件内容的字体大小。属性：字体颜色本属性指定或获取相应组件内容的字体颜色。属性：对齐方式本属性指定或获取相应组件内容的对齐方式。属性：粗体本属性指定或获取相应组件内容是否为粗体。属性：斜体本属性指定或获取相应组件内容是否为斜体。属性：背景颜色本属性指定或获取相应组件的背景颜色。属性：可用本属性指定或获取相应组件是否启用。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：获得焦点()组件获得焦点事件。事件：失去焦点()组件失去焦点事件。手机方法：拨号(号码 为 文本型)拨打电话，号码为文本型。方法：振动(时长 为 整

26、数型)发出指定时长的振动，时长为整数形，单位为毫秒。方法：发送短信(号码 为 文本型,内容 为 文本型,提示 为 文本型)向指定号码发送短信，并发出提示（为了避免开发后台悄悄发送短信的程序，提示内容即使为空也会有默认提示消息）。方法：发送邮件(地址 为 文本型,内容 为 文本型)调用系统邮件程序向指定邮件地址发送邮件（发送过程需要用户确认）。方法：跳转网址(网址 为 文本型)调用系统默认浏览器打开指定网址。方法：发送数据(地址 为 文本型,端口 为 整数型,数据 为 文本型) 发送网络数据。属性：有效本属性获取相应硬件是否有效。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件期间做

27、一些初始化工作。位置传感器属性：有效本属性获取相应硬件是否有效。属性：可用本属性指定或获取相应硬件是否启用。属性：纬度本属性获取手机所在位置的纬度。属性：经度本属性获取手机所在位置的经度。属性：高度本属性获取手机所在位置的高度。属性：精度本属性获取手机定位的精度。属性：当前位置本属性获取手机当前所在位置。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：位置改变(纬度 为 双精度小数型,经度 为 双精度小数型,高度 为 双精度小数型)GPS位置发生变化时触发此事件，并得到纬度、经度和高度三个返回值。方向传感器属性：有效本属性获取相应硬件是否有效。属性：可用

28、本属性指定或获取相应硬件是否启用。属性：偏航角本属性获取手机的偏航角，以Z轴为轴心，0为北，90为东，180为南，270为西。属性：俯仰角本属性获取手机的俯仰角，以X轴为轴心的倾角（-180180）。属性：横滚角本属性获取手机的横滚角，以Y轴为轴心的倾角（-9090）。属性：倾斜角本属性获取手机的倾斜角。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：方向改变(偏航角 为 单精度小数型, 俯仰角 为 单精度小数型, 横滚角 为 单精度小数型)手机倾斜角度发生变化时触发此事件，并获得三个方向的倾角。时钟属性：可用本属性指定或获取相应硬件是否启用。属性：时钟周期本属性指定或获取时钟的时间间隔，单位为毫秒。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：周期事件()时钟完成一次时钟周期时触发此事件。进度条属性：宽度本属性指定或获取相应组件的宽度。属性：高度本属性指定或获取相应组件的高度。属性：最大位置本属性指定或获取进度条的最大位置，默认为100。属性：位置本属性指定或获取进度条的位置，必须为整数型。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。浏览框方法：跳转(网址 为 文本型)跳转至指定网址，必