E4A使用手册.docx

E4A使用手册.docx

《E4A使用手册.docx》由会员分享，可在线阅读，更多相关《E4A使用手册.docx（27页珍藏版）》请在冰豆网上搜索。

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，表示文本一大于文本二。

翻转文本

翻转文本（传址文本数据为文本型）

翻转指定文本数据。

转换操作

到文本

到文本（待转换的数据为通用型）为文本型

将指定数据转换成文本。

到数值

到数值（待转换的数据为通用型）为双精度小数型

将指定数据转换成数值。

字符转代码

字符转代码（字符为文本型）为整数型

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

代码转字符

代码转字符（代码为整数型）为文本型

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

到十六进制

到十六进制（数值为通用型）为文本型

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

算术运算

取绝对值

取绝对值（数值为通用型）为通用型

返回数值的绝对值。

求反正切

求反正切（数值为双精度小数型）为双精度小数型

返回数值的反正切值。

求余弦

求余弦（数值为双精度小数型）为双精度小数型

返回数值的余弦值。

求反对数

求反对数（数值为双精度小数型）为双精度小数型

返回e（自然对数的底）的某次方。

取整

取整（数值为通用型）为长整数型

注释：

返回数值的整数部分。

求自然对数

求自然对数（数值为双精度小数型）为双精度小数型

返回数值的自然对数。

取最大值

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

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

取最小值

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

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

取随机数

函数：

取随机数（）为双精度小数型

返回一个随机数。

求正弦

求正弦（数值为双精度小数型）为双精度小数型

返回数值的正弦值。

取符号

取符号（数值为双精度小数型）为整数型

返回数值符号（1：

正，0：

零，-1：

负）。

求平方根

求平方根（数值为双精度小数型）为双精度小数型

返回数值的平方根。

求正切

求正切（数值为双精度小数型）为双精度小数型

返回数值的正切值。

角度转弧度

角度转弧度（角度为双精度小数型）为双精度小数型

角度转弧度。

弧度转角度

弧度转角度（弧度为双精度小数型）为双精度小数型

弧度转角度。

文件操作

打开文件

打开文件（文件名为文本型）为整数型

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

打开文件2

打开文件2（完整路径文件名为文本型）为整数型

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

关闭文件

关闭文件（文件号为整数型）

关闭指定文件号的文件。

是否在文件尾

是否在文件尾（文件号为整数型）为逻辑型

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

写出文本

写出文本（文件号为整数型,欲写出文本为文本型）

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

读入文本

读入文本（文件号为整数型）为文本型

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

写出数值

写出数值（文件号为整数型,欲写出数值为整数型）

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

读入数值

读入数值（文件号为整数型）为整数型

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

修改文件名

修改文件名（旧文件名为文本型,新文件名为文本型）

重命名指定文件。

删除文件

删除文件（文件名为文本型）

删除指定文件。

删除文件2

删除文件2（完整路径文件名为文本型）

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

文件是否存在

文件是否存在（文件名为文本型）为逻辑型

判断文件是否存在。

文件是否存在2

文件是否存在2（完整路径文件名为文本型）为逻辑型

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

是否为文件夹

是否为文件夹（名称为文本型）为逻辑型

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

是否为文件夹2

是否为文件夹2（名称为文本型）为逻辑型

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

新建文件夹

新建文件夹（文件夹名为文本型）

新建一个文件夹。

新建文件夹2

新建文件夹2（文件夹名为文本型）

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

删除文件夹

删除文件夹（文件夹名为文本型）

删除指定文件夹。

删除文件夹2

删除文件夹2（文件夹名为文本型）

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

置读写位置

置读写位置（文件号为整数型,位置为长整数型）为长整数型

重置读写位置，返回偏移之后的新地址。

取文件尺寸

取文件尺寸（文件号为整数型）为长整数型

返回文件的尺寸大小。

应用操作

添加菜单

添加菜单（菜单项为文本型）

添加一个菜单。

切换窗口

切换窗口（新窗口名称为窗口）

切换到指定窗口，例如：

切换窗口（新窗口2）。

弹出提示

弹出提示（提示信息为文本型）

弹出提示信息。

信息框

信息框（标题为文本型,信息为文本型,按钮标题为文本型）

弹出信息框。

取时间

取时间（）为文本型

获取当前时间。

取日期

取日期（）为文本型

获取当前日期。

播放音乐

播放音乐（文件名为文本型）

播放APK资源中的音乐。

播放音乐2

播放音乐2（完整路径文件名为文本型）

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

SQL执行

SQL执行（数据库名称为文本型,SQL命令为文本型）

对sqlite3数据库执行SQL命令。

SQL查询

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

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

数组操作

过滤数组

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

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

连接数组成员

连接数组成员（文本数组为文本型（）,连接文本为文本型）为文本型

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

分割文本

分割文本（待分割的文本为文本型,用作分割的文本为文本型,分割次数为整数型）为文本型（）

将指定文本进行分割，返回分割后的文本数组。

取数组下标

取数组下标（数组为通用型,维度为整数型）为整数型

返回指定数组维度可用的最大下标。

流程控制

如果

如果表达式则

[语句]

[否则如果表达式则]

[语句]

[否则]

[语句]

结束如果

判断

判断分支表达式

[分支表达式列表]

[语句]

[分支否则]

[语句]

结束判断

判断循环首

判断循环首条件表达式

[语句]

判断循环尾

变量循环首

变量循环首循环变量=起始值至结束值[步进步进值]

[语句]

变量循环尾

容错处理首

容错处理首

[分支]

[语句]

容错处理尾

调用事件

调用事件事件名称

退出

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

结束程序

结束程序（）

集合

项目总数

项目总数

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

加入项目

加入项目（项目为通用型）

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

清空

清空（）

清空集合中所有的项目。

是否包含

是否包含（项目为通用型）为逻辑型

判断集合中是否存在某个项目，返回真或假。

取项目

取项目（索引为整数型）为通用型

取指定索引的项目，返回项目数据。

删除项目

删除项目（项目为通用型）

删除指定项目。

八、控件

类别

属性、方法、事件

注释

窗口

属性：

标题

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

属性：

背景颜色

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

事件：

创建完毕（）

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

事件：

按下某键（键代码为整数型）

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

菜单被选择（菜单名为文本型）

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

触摸手势（方向为整数型）

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

按钮

属性：

宽度

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

属性：

高度

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

属性：

标题

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

属性：

字体大小

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

属性：

粗体

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

属性：

斜体

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

属性：

可用

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

事件：

创建完毕（）

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

事件：

被单击（）

按钮被单击事件。

事件：

获得焦点（）

组件获得焦点事件。

事件：

失去焦点（）

组件失去焦点事件。

编辑框

属性：

宽度

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

属性：

高度

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

属性：

内容

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

属性：

字体大小

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

属性：

字体颜色

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

属性：

对齐方式

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

属性：

粗体

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

属性：

斜体

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

属性：

背景颜色

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

属性：

可用

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

事件：

创建完毕（）

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

事件：

获得焦点（）

组件获得焦点事件。

事件：

失去焦点（）

组件失去焦点事件。

标签

属性：

宽度

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

属性：

高度

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

属性：

标题

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

属性：

字体大小

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

属性：

字体颜色

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

属性：

对齐方式

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

属性：

粗体

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

属性：

斜体

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

属性：

背景颜色

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

属性：

可用

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

事件：

创建完毕（）

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

事件：

被单击（）

标签被单击事件。

图片框

属性：

宽度

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

属性：

高度

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

属性：

背景颜色

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

属性：

图像

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

事件：

创建完毕（）

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

事件：

被单击（）

图片框被单击事件。

单选框

属性：

宽度

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

属性：

高度

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

属性：

标题

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

属性：

字体大小

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

属性：

字体颜色

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

属性：

对齐方式

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

属性：

粗体

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

属性：

斜体

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

属性：

背景颜色

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

属性：

选中

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

属性：

可用

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

事件：

创建完毕（）

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

事件：

选择改变（）

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

事件：

获得焦点（）

组件获得焦点事件。

事件：

失去焦点（）

组件失去焦点事件。

选择框

属性：

宽度

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

属性：

高度

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

属性：

标题

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

属性：

字体大小

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

属性：

字体颜色

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

属性：

对齐方式

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

属性：

粗体

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

属性：

斜体

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

属性：

背景颜色

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

属性：

选中

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

属性：

可用

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

事件：

创建完毕（）

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

事件：

选择改变（）

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

事件：

获得焦点（）

组件获得焦点事件。

事件：

失去焦点（）

组件失去焦点事件。

画板

方法：

清空（）

清空画布中所有绘制内容。

方法：

画圆（横坐标为整数型,纵坐标为整数型,半径为整数型）

在指定点（横坐标,纵坐标）绘制指定半径的圆。

方法：

画直线（起点横坐标为整数型,起点纵坐标为整数型,终点横坐标为整数型,终点纵坐标为整数型）

在指定起点和终点之间画线段。

方法：

画点（横坐标为整数型,纵坐标为整数型）

在指定点（横坐标,纵坐标）画点。

属性：

宽度

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

属性：

高度

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

属性：

背景颜色

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

属性：

画笔颜色

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

事件：

创建完毕（）

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

事件：

被触摸（横坐标为整数型,纵坐标为整数型）

画板被触摸事件，返回触摸位置的横坐标和纵坐标。

密码编辑框

属性：

宽度

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

属性：

高度

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

属性：

内容

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

属性：

字体大小

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

属性：

字体颜色

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

属性：

对齐方式

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

属性：

粗体

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

属性：

斜体

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

属性：

背景颜色

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

属性：

可用

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

事件：

创建完毕（）

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

事件：

获得焦点（）

组件获得焦点事件。

事件：

失去焦点（）

组件失去焦点事件。

手机

方法：

拨号（号码为文本型）

拨打电话，号码为文本型。

方法：

振动（时长为整数型）

发出指定时长的振动，时长为整数形，单位为毫秒。

方法：

发送短信（号码为文本型,内容为文本型,提示为文本型）

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

方法：

发送邮件（地址为文本型,内容为文本型）

调用系统邮件程序向指定邮件地址发送邮件（发送过程需要用户确认）。

方法：

跳转网址（网址为文本型）

调用系统默认浏览器打开指定网址。

方法：

发送数据（地址为文本型,端口为整数型,数据为文本型）

发送网络数据。

属性：

有效

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

事件：

创建完毕（）

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

位置传感器

属性：

有效

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

属性：

可用

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

属性：

纬度

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

属性：

经度

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

属性：

高度

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

属性：

精度

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

属性：

当前位置

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

事件：

创建完毕（）

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

事件：

位置改变（纬度为双精度小数型,经度为双精度小数型,高度为双精度小数型）

GPS位置发生变化时触发此事件，并得到纬度、经度和高度三个返回值。

方向传感器

属性：

有效

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

属性：

可用

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

属性：

偏航角

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

属性：

俯仰角

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

属性：

横滚角

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

属性：

倾斜角

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

事件：

创建完毕（）

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

事件：

方向改变（偏航角为单精度小数型,俯仰角为单精度小数型,横滚角为单精度小数型）

手机倾斜角度发生变化时触发此事件，并获得三个方向的倾角。

时钟

属性：

可用

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

属性：

时钟周期

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

事件：

创建完毕（）

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

事件：

周期事件（）

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

进度条

属性：

宽度

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

属性：

高度

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

属性：

最大位置

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

属性：

位置

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

事件：

创建完毕（）

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

浏览框

方法：

跳转（网址为文本型）

跳转至指定网址，必