力控组态软件ForceControl V7.0的专家报表的表页函数3
SetCellAlign
语法: #Report.SetCellAlign(nSheetIndex,nRow,nCol,nAlign);
说明: 设置单元格的对齐方式
返回值: 设置成功返回 1, 否则返回 0
参数: nSheetIndex:当前要操作的页 , -1 表示当前页;页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nRow:要设置的单元格的行;-1 表示所有行,-2 表示鼠标所选的行
nCol:要设置的单元格的列;-1 表示所有列,-2 表示鼠标所选的列
nAlign:对齐方式 1- 为左对齐 2- 为右对齐 4- 为水平居中 8- 为居上对齐 16- 为居下对齐 32- 为垂直居中 64- 水平分散对齐 128- 垂直分散对齐
示例: #Report.SetCellAlign(-1,1,-1,4);// 将当前表页第一行的所有列设置为水平居中
SetCellBackColor
语法: #Report.SetCellBackColor(nSheetIndex, nColIndex, nRowIndex, nColor);
说明: 设置指定表格的背景颜色
返回值: 设置成功返回 1, 否则返回 0
参数: nSheetIndex:当前要操作的页 , -1 表示当前页;页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nRowIndex: 要设置的单元格的行索引;-1 表示所有行,-2 表示鼠标所选的行
nColIndex: 要设置的单元格的列索引;-1 表示所有列,-2 表示鼠标所选的列
nColor: 力控颜色 (0 表示红色 )
如果 nColIndex 和 nRowIndex 同时为 -1,表示所选的所有行和所有列
说明: 设置指定表格的背景颜色
示例: #Report.SetCellBackColor(0,1,-1, 32); // 将第一个表单的第一行的所有单元表格的背景颜色设置为绿色
SetCellDigital
语法: #Report.SetCellDigital(nSheetIndex,nRow,nCol,nNum);
说明: 设置单元格的数值显示的小数位数
返回值: 设置成功返回 1, 否则返回 0
参数: nSheetIndex:当前要操作的页 , -1 表示当前页;页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nRow:要设置的单元格的行;-1 表示所有行,-2 表示鼠标所选的行
nCol:要设置的单元格的列;-1 表示所有列,-2 表示鼠标所选的列
nNum:小数位数
示例: #Report.SetCellDigital(-1,-1,-1,2);// 将当前表页的单元格的数值设置为两位小数
SetCellDouble
语法: nResult=#Report.SetCellDouble(nSheetIndex,nRowIndex,nColIndex,dbData,nAllowUpdate);
说明: 设置指定表页中指定的单元格值 (double 类型 )。
返回值: int 执行成功返回 1,否则返回 0
参数: nSheetIndex:当前要操作的表页索引号,-1 表示当前页;表页索引号取值范围 0 到表页数减 1
nRowIndex:行号;-1 表示所有行,-2 表示当前行;其范围是 1 到表页行数减 1
nColIndex:列号;-1 表示所有列,-2 表示当前列;其范围是 1 到表页列数减 1
dbData:要写入的值(浮点数)
nAllowUpdate:是否允许报表自动刷新,1 表示允许,0 表示不允许
示例: #Report.SetCellDouble(0, 1, 1, 123.123, 1);// 设置第一页单元格行号和列号都为 1 的单元格的值为 123.123
SetCellString
语法: #Report.SetCellString(nSheetIndex, nRowIndex, nColIndex, strInput, nAllowUpdate);
说明: 设置单元格值
返回值: int 执行成功返回 1,否则返回 0
参数: nSheetIndex:当前要操作的表页索引号,-1 表示当前页;表页索引号取值范围 0 到表页数减 1
nRowIndex:行号;-1 表示所有行,-2 表示当前行;其范围是 1 到表页行数减 1
nColIndex:列号;-1 表示所有列,-2 表示当前列;其范围是 1 到表页列数减 1
strInput:要写入的字符串
nAllowUpdate:是否允许报表自动刷新,1 表示允许,0 表示不允许
说明: 设置指定表页中指定的单元格值 ( 字符串类型 )
示例: #Report.SetCellString(0, 1, 1, “hello”, 1); // 设置第一页单元格行号和列号都为 1 的单元格的值为 hello
SetCellIgnore
语法: #Report.SetCellIgnore(nSheetIndex,nRowIndex,nColIndex,nValue,nOperator);
说明: 设置指定表格的忽略数值
返回值: 设置成功返回 1, 否则返回 0
参数: nSheetIndex:当前要操作的页 , -1 表示当前页;页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nRowIndex: 要设置的单元格的行索引;-1 表示所有行,-2 表示鼠标所选的行
nColIndex: 要设置的单元格的列索引;-1 表示所有列,-2 表示鼠标所选的列
nValue: 相比较的值
nOperator: 操作符 0-“=”,1-“!=”,2-“<“,3-“>”,4-“<=”,5-“>=”
示例: #Report.SetCellIgnore(0,-1,-1,0,2);// 将第 1 表页所有单元表格中小于 0 的数值删除
SetCellImage
语法: #Report.SetCellImage(nSheetIndex,nRow,nCol,nSytle,lhAlign,lvAlign,strImagePath);
说明: 设置单元格图片
返回值: 设置成功返回 1, 否则返回 0
参数: nSheetIndex:当前要操作的页 , -1 表示当前页;页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nRow:要设置的单元格的行号;-1 表示所有行,-2 表示当前行
nCol:要设置的单元格的列号;-1 表示所有列,-2 表示当前列
nSytle:图片的显示风格;BIT0( 即:1) 表示自动调整图片大小; BIT1( 即:2) 图片尽量充满整个单元格;BIT2( 即:4) 图片平铺填满整个单元格。
lhAlign:图片水平对齐方式。0 单元格内水平居左 1 单元格内水平居左 2 单元格内水平居中单元格内水平居右
vAlign:图片垂直对齐方式。0 单元格内水平居垂直上;1 单元格内水平居垂直上;2 单元格内水平居垂直中;3 单元格内水平居垂直下
strImagePath:要设置的图片的路径 , 支持 .jpg.bmp 格式。
示例: #Report.SetCellImage(-1,-2,-2,1,2,2, “C:\Water.jpg”); // 把 C:\Water.jpg 设置当前页当前所选中的单元格