表格-table
描述
表格，父对象为ui，无子对象
事件
- selectionchange：选中的行号发生变化时触发，事件函数定义：onSelectionChange(row, column)，row表示行号, column表示列号。
- savedone: 另存为结束时触发，事件函数定义：onSaveDone(result), result表示保存结果，1－表示成功，0－表示失败。
- userevent: 当订阅了某自定义事件，通过service.ctl.emitEvent(name, value)广播时触发, 事件函数定义: onUserEvent(name,value)，参数name为事件名，value为数据
属性
| 名称 | 功能说明 | 脚本例子 |
|---|---|---|
| geometryLocked | 区域锁定，锁定后控件的位置及大小不能修改 | 无 |
| x | x坐标 （只读属性） | var x = ui.form-name.table-name.x; 获取对象的x坐标 |
| y | y坐标 （只读属性） | var y = ui.form-name.table-name.y; 获取对象的y坐标 |
| width | 宽 （只读属性） | var width = ui.form-name.table-name.width; 获取对象的宽 |
| height | 高 （只读属性） | var height = ui.form-name.table-name.width; 获取对象的高 |
| marginRight | 右外边距 （只读属性） | 无 |
| marginBottom | 底外边距 （只读属性） | 无 |
| enabled | 使能：如果选中，对象处于激活状态，否则处于“禁止”状态，对所有触摸操作无反应。 | ui.form-name.table-name.enabled=0 禁止对象 |
| geometry | 几何尺寸：对象的坐标位置（X, Y），长和宽 | 无 |
| visible | 可见：如果选中，对象可见，否则隐藏 | ui.form-name.table-name.visible=0 隐藏对象 |
| rowCount | 行数，如果要删除表格的所有行，可以设置行数为0 | ui.form-name.table-name.rowCount=3 设置行数为3 ui.form-name.table-name.rowCount=0 删除所有行 |
| columnCount | 列数 | ui.form-name.table-name.columnCount=4 设置列数为4 |
| columnLabel | 列标签 | ui.form-name.table-name.columnLabel='aaa,bbb,ccc' 设置列标签，用逗号分隔每列 |
| rowLabel | 行标签 | ui.form-name.table-name.rowLabel='aaa,bbb,ccc' 设置行标签，用逗号分隔每行 |
| rowHeaderVisible | 行表头可见 | ui.form-name.table-name.rowHeaderVisible=false 隐藏行表头 |
| columnHeaderVisible | 列表头可见 | ui.form-name.table-name.columnHeaderVisible=false 隐藏列表头 |
| rowWrapContent | 行高适应内容 | ui.form-name.table-name.rowWrapContent=true 每一行的高度按内容高度自适应 |
| columnWrapContent | 列宽适应内容 | ui.form-name.table-name.columnWrapContent=true 每一列的宽度按内容宽度自适应 |
| headerTextColor | 表头文字颜色 | ui.form-name.table-name.headerTextColor='#ff0000' 设置表头文字为红色 |
| headerBackgroundColor | 表头背景颜色 | ui.form-name.table-name.headerBackgroundColor='#0000ff' 设置表头背景颜色为蓝色 |
| headerBackgroundColorType | 表头背景色类型：0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选 | ui.form-name.table-name.headerBackgroundColorType=4 设置表头的背景颜色类型为Circle |
| selectionMode | 选择模式：0-NoSelection，1-SingleSelection，2-MultiSelection | ui.form-name.table-name.selectionMode=2;//设置模式为多选 |
| textAlign | 文字对齐方式: 0-Center, 1-Left，2-Right，3-Top，4-Bottom | ui.form-name.table-name.textAlign=0 设置表格文本居中对齐 |
| textColor | 文字颜色, 颜色定义参看 控件对象 | ui.form-name.table-name.textColor='#ff0000' 设置文字颜色为红色 |
| backgroundColor | 背景色，颜色定义参看 控件对象 | ui.form-name.table-name.backgroundColor='#0000ff' 设置背景色为蓝色 |
| backgroundColorType | 背景色类型：0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选 | ui.form-name.table-name.backgroundColorType=4 设置表格背景颜色类型为Circle |
| borderColor | 边框颜色，颜色定义参看 控件对象 | ui.form-name.table-name.borderColor='#ff0000' 设置边框颜色为红色 |
| borderWidth | 边框宽度，单位：像素 | ui.form-name.table-name.borderWidth=5 设置边框宽为5个像素 |
| borderRadius | 边框拐角弧度半径，单位：像素 | ui.form-name.table-name.borderRadius=8 设置边框拐角半径为8个像素 |
| borderType | 边框类型: 0-Solid，1-Dotted，2-No_Border | ui.form-name.table-name.borderType=2设置无边框 |
| scrollBarVisible | 滚动条可见 | ui.form-name.table-name.scrollBarVisible=true 显示滚动条 |
| autoScroll | 自动滚动，表格内容变化时，自动滚动到最后一行 | ui.form-name.table-name.autoScroll=true 设置自动滚动 |
方法
| 名称 | 功能说明 | 脚本例子 |
|---|---|---|
| setFontSize(size) | 设置字体大小 | ui.form-name.table-name.setFontSize(12) 设置字体为12号 |
| setItemTextColor(row, column, color) | 设置单元格的文字颜色 | ui.form-name.table-name.setItemTextColor(0, 2, '#ff0000') 设置第0行，第2列文字颜色为红色 |
| setItemBackgroundColor(row, column, color) | 设置单元格的背景颜色 | ui.form-name.table-name.setItemBackgroundColor(0, 2, '#0000ff') 设置第0行，第2列背景颜色为蓝色 |
| getItemText(row, column) | 获取单元格内容 | var text = ui.form-name.table-name.getItemText(0, 2) 获取第0行，第2列的文字 |
| setItem(row, column, text) | 设置单元格内容：设置第row行，第column列文字为text, 注意行和列的索引都从0开始 | ui.form-name.table-name.setItem(0, 2, 'abc') 设置第0行，第2列的文字为abc |
| setRowItem(row, text) | 设置整行内容：row为行索引，text字符串，中间用逗号分隔每列的内容 | ui.form-name.table-name.setRowItem(0, 'aaa,bbb,ccc') 设置第0行的内容为aaa bbb ccc |
| setColumnWidth(column, width) | 设置某列的宽度：column 为列索引，width为宽度，单位像素 | ui.form-name.table-name.setColumnWidth(3, 40) 设置索引为3的列宽度为40像素 |
| setRowHeight(row, height) | 设置某行的高度：row 为行索引，height为高度，单位像素 | ui.form-name.table-name.setRowHeight(2, 30) 设置索引为2的行高度为30像素 |
| getRowHeaderWidth() | 获取行表头的宽度 | var width = ui.form-name.table-name.getRowHeaderWidth(); 获取行表头宽度 |
| getColumnHeaderHeight() | 获取列表头的高度 | var height = ui.form-name.table-name.getColumnHeaderHeight() 获取列表头高度 |
| setRowVisible(row, visible) | 设置某行可见 | ui.form-name.table-name.setRowVisible(1,false); //隐藏索引为1的行 |
| setColumnVisible(column, visible) | 设置某列可见 | ui.form-name.table-name.setColumnVisible(1,false);//隐藏索引为1的列 |
| selectRow(row) | 选中某一行 | ui.form-name.table-name.selectRow(1); //选中索引为1的行 |
| selectAll() | 选中所有行 | ui.form-name.table.name.selectAll(); //选中所有行 |
| insertRow(row) | 在指定位置插入一个空行 | ui.form-name.table-name.insertRow(0) 在第0行插入一个空行 |
| insertRowItem(row, text) | 在指定位置插入一行并填充内容 | ui.form-name.table-name.insertRowItem(2, 'aaa,bbb,ccc') 在第2行插入一个行并填充内容 |
| removeRow(row) | 删除一行：row为行索引 | ui.form-name.table-name.removeRow(4); 删除索引为4的行 |
| removeAllRows() | 删除所有行 | ui.form-name.table-name.removeAllRows(); 删除所有行 |
| currentRow() | 获取当前选中的行索引 | var row = currentRow() 返回当前选中的行索引 |
| getSelectedRows() | 获取多选模式下当前选中的行索引数组 | var rows = ui.form-name.table-name.getSelectedRows();获取选中的行索引，返回值为数组 |
| currentColumn() | 获取当前选中的列索引 | var col = currentColumn() 返回当前选中的列索引 |
| clearContents() | 清除表格所有单元格内容（不包含表头标签） | ui.form-name.table-name.clearContents() 清除表格所有单元格内容 |
| clearSelection() | 清除选中状态 | ui.form-name.table-name.clearSelection() 清除选中状态 |
| clear() | 清除表格所有内容，包含表头自定义的标签 | ui.form-name.table-name.clearContents() 清除表格所有内容 |
| saveAs(path) | 1.8.0新增方法，表格内容另存为CSV格式的文件，path参数为完整路径名 | ui.form-name.table-name.saveAs('/storage/d0/table.csv') 保存表格数据到U盘上 |
| saveAs(path, hasColumnLabel) | 1.8.1新增方法，表格内容另存为CSV格式的文件，path参数为完整路径名, hasColumnLabel参数为是否显示表头 | ui.form-name.table-name.saveAs('/storage/d0/table.csv', false) 保存表格数据(去除表头)到U盘上 |
| saveAs(path, startRow, endRow, startColumn, endColumn) | 1.8.0新增方法，表格内容另存为CSV格式的文件，path参数为完整路径名，startRow为起始行索引，endRow为结束行索引，startColumn为起始列索引，endColumn为结束列索引。索引值从0开始。 | ui.form-name.table-name.saveAs('/storage/d0/table.csv', 0, 10, 0, 2) 保存表格从第0行到第10行，第0列到第2列的数据到U盘上 |
| saveAs(path, startRow, endRow, startColumn, endColumn, hasColumnLabel) | 1.8.1新增方法，表格内容另存为CSV格式的文件，path参数为完整路径名，startRow为起始行索引，endRow为结束行索引，startColumn为起始列索引，endColumn为结束列索引（索引值从0开始），hasColumnLabel为是否显示表头。 | ui.form-name.table-name.saveAs('/storage/d0/table.csv', 0, 10, 0, 2, false) 保存表格不显示表头，从第0行到第10行，第0列到第2列的数据到U盘上 |
| move(x,y) | 移动对象：将对象移动到(x,y)坐标位置，坐标系的原点在屏幕的左上角。 | ui.form-name.table-name.move(10,10) 移动对象到坐标（10，10） |
| resize(width, height) | 设置对象宽和高 | ui.form-name.table-name.resize(30,20) 设置对象宽30像素，高20像素 |