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查询命令，返回查询结果，每条记录中的项目用指定列分隔符连接，各条记录之间用指定行分隔符连接。数组操作过滤数组过滤数组(要过滤的文本数组为文本型(),要寻找的子文本为文本型,是否保留为逻辑型)为文本型()在一个文本数组中寻找指定子文本，如果保留则返回包含该子文本的数组，否则返回不含该子文本的数组。连接数组成员连接数组成员(文本数组为文本型(),连接文本为文本型)为文本型将一个文本数组的成员用指定文本连接起来，返回连接后的文本。分割文本分割文本(待分割的文本为文本型,用作分割的文本为文本型,分割次数为整数型)为文本型()将指定文本进行分割，返回分割后的文本数组。取数组下标取数组下标(数组为通用型,维度为整数型)为整数型返回指定数组维度可用的最大下标。流程控制如果如果表达式则[语句][否则如果表达式则][语句][否则][语句]结束如果判断判断分支表达式[分支表达式列表][语句][分支否则][语句]结束判断判断循环首判断循环首条件表达式[语句]判断循环尾变量循环首变量循环首循环变量=起始值至结束值[步进步进值][语句]变量循环尾容错处理首容错处理首[分支][语句]容错处理尾调用事件调用事件事件名称退出退出[循环]或[函数]或[过程]结束程序结束程序()集合项目总数项目总数返回集合的项目总数，该属性为只读属性。加入项目加入项目(项目为通用型)向集合中加入项目，可以是任意类型的数据。清空清空()清空集合中所有的项目。是否包含是否包含(项目为通用型)为逻辑型判断集合中是否存在某个项目，返回真或假。取项目取项目(索引为整数型)为通用型取指定索引的项目，返回项目数据。删除项目删除项目(项目为通用型)删除指定项目。八、控件类别属性、方法、事件注释窗口属性：标题本属性指定或获取相应组件的标题文本。属性：背景颜色本属性指定或获取相应组件的背景颜色。事件：创建完毕()当窗口被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：按下某键(键代码为整数型)当用户按下某键后产生此事件。菜单被选择(菜单名为文本型)当用户选择菜单后产生此事件。触摸手势(方向为整数型)当用户触摸滑动屏幕后产生此事件。按钮属性：宽度本属性指定或获取相应组件的宽度。属性：高度本属性指定或获取相应组件的高度。属性：标题本属性指定或获取相应组件的标题。属性：字体大小本属性指定或获取相应组件标题的字体大小。属性：粗体本属性指定或获取相应组件标题是否为粗体。属性：斜体本属性指定或获取相应组件标题是否为斜体。属性：可用本属性指定或获取相应组件是否启用。事件：创建完毕()当组件被创建后产生此事件，可以在响应此事件期间做一些初始化工作。事件：被单击()按钮被单击事件。事件：获得焦点()组件获得焦点事件。事件：失去焦点()组件失去焦点事件。编辑框属