表格-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 <br> 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像素 |