文件-file
描述
文件，父对象为form，不可见，为功能性控件，无子对象。
事件
无
属性
| 名称 | 功能说明 | 脚本例子 |
|---|---|---|
| path | 文件路径，用户可以访问/user目录下的板载存储空间，目前为48MB。如果需要访问U盘，也可设置为U盘路径 | ui.form-name.file-name.path='/user/test.txt' 设置文件路径为/user/test.txt |
| mode | 文件打开模式，值为整型（0-ReadWrite, 1-WriteOnly, 2-Append），默认值为 0 | ui.form-name.file-name.mode=0 设置打开模式为可读可写 |
| encoding | 文件操作的字符编码 | ui.form-name.file-name.encoding='UTF-8' 设置字符编码为UTF-8 |
方法
| 名称 | 功能说明 | 脚本例子 |
|---|---|---|
| open() | 打开路径为属性path的文件，返回布尔值，true 表示打开成功 | ui.form-name.file-name.open() 打开指定的文件 |
| read(count) | 二进制方式读取count个字节 | var a=ui.form-name.file-name.read(10) 从指定文件读取10个字节内容 |
| readAll() | 二进制方式读取文件所有内容 | var a=ui.form-name.file-name.readAll() 从指定文件读取所有内容 |
| readLine() | 读取一行文本，行以'\n'作为结束符 | var a=ui.form-name.file-name.readLine() 从指定文件读取一行文本 |
| readLines(index, count) | 读取指定索引行开始的多行内容，返回字符串 | var a=ui.form-name.file-name.readLines(5,10)从第6行开始读取10行文本 |
| readAllLines() | 读取全部行文本，行以'\n'作为结束符 | var a=ui.form-name.file-name.readAllLines() 从指定文件读取所有行文本 |
| readStartLines(count) | 读取文本文件起始的几行，返回字符串数组，数组长度为count | var a=ui.form-name.file-name.readStartLines(5); 读取文件开头的5行，返回为字符串数组 |
| readEndLines(count) | 读取文本文件末尾的几行，返回字符串数组，数组长度为count | var a=ui.form-name.file-name.readEndLines(5); 读取文件末尾的5行，返回为字符串数组 |
| seek(offset) | 设置文件读写的偏移位置 | ui.form-name.file-name.seek(10) 设置读写的偏移位置为10个字节 |
| write(data) | 写入数据 | ui.form-name.file-name.write(0xaa) 向指定文件写入16进制数aa |
| writeAsync(data) | 异步方式写入数据 | ui.form-name.file-name.writeAsync(0xaa)向指定文件写入16进制数aa |
| writeLine(line) | 写入字符串行，自动添加'\n'作为行结束符 | ui.form-name.file-name.writeLine('this is a test') 向指定文件写入文本行'this is a test\n' |
| writeLineAsync(line) | 异步方式写入字符串行，自动添加'\n'作为行结束符 | ui.form-name.file-name.writeLineAsync('this is a test') 向指定文件写入文本行'this is a test\n' |
| close() | 关闭文件 | ui.form-name.file-name.close() 关闭指定文件 |
| sync() | 同步，强制缓存数据写入文件 | ui.form-name.file-name.sync() 强制缓存数据写入指定文件 |
| isOpen() | 返回文件是否已打开，只有打开的文件才能进行读，写，同步等操作 | var opened=ui.form-name.file-name.isOpen() 返回指定文件是否已打开 |
| atEnd() | 返回文件的读写位置是否已到文件尾 | var a=ui.form-name.file-name.atEnd() 返回指定文件是否已读写到结尾 |
| offset() | 返回文件的读写位置 | var a=ui.form-name.file-name.offset() 返回指定文件读写位置 |
| length() | 返回文件的大小 | var l=ui.form-name.file-name.length() 返回指定文件大小 |
| exists() | 返回指定文件是否存在 | var l=ui.form-name.file-name.exists('/user/test.txt') 检查/user/test.txt是否存在 |
| isReadable() | 返回文件是否可读 | var readable=ui.form-name.file-name.isReadable('/user/test.txt') 检查/user/test.txt是否可读 |
| isWritable() | 返回文件是否可写 | var writable=ui.form-name.file-name.isWritable('/user/test.txt') 检查/user/test.txt是否可写 |
| copyTo(destination) | 拷贝指定文件到destination路径 | ui.form-name.file-name.copyTo('/user/test.txt') 将指定文件拷贝到'/user/test.txt' |
| rename(new_name) | 重新命名文件 | ui.form-name.file-name.rename('/user/test2.txt') 将文件重命名为test2.txt |
| saveAsPdf(pdf_name) | 另存为PDF文件 | ui.form-name.file-name.saveAsPdf('/storage/d0/test.pdf') 另存为PDF到U盘 |
| remove() | 删除当前文件 | ui.form-name.file-name.remove() 删除当前文件 |