分类： 力控组态软件ForceControl V7.0

力控组态软件ForceControl V7.0的专家报表的表页函数4

RemoveCellImage
语法： #Report.RemoveCellImage(nSheetIndex, nRow, nCol);
说明： 删除单元格图片
返回值： 设置成功返回 1, 否则返回 0
参数： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nRow：要设置的单元格的行号；-1 表示所有行，-2 表示当前行
nCol：要设置的单元格的列号；-1 表示所有列，-2 表示当前列
示例： #Report.SetCellImage(-1, -1, -1); // 删除当前页所有单元格中的图片

SetCellNumType
语法： #Report.SetCellNumType(nSheetIndex,nRow,nCol,nNumType);
说明： 设置单元格的数值显示类型
返回值： 设置成功返回 1, 否则返回 0
参数： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nRow：要设置的单元格的行；-1 表示所有行，-2 表示鼠标所选的行
nCol：要设置的单元格的列；-1 表示所有列，-2 表示鼠标所选的列
nNumType：0 缺省 1 普通数值 2 货币 3 日期 4 时间 5 百分比 6 科学计数 7 文本 8 货币大写
示例： #Report.SetCellNumType(-1,1,-1,4);// 将当前表页第一行的所有列的设置为时间类型

SetCellReadOnly
语法： #Report.SetCellReadOnly(nSheetIndex,nRow, nCol,nOperation);
说明： 设置指定单元格的只读属性
返回值： 设置成功返回 1, 否则返回 0
参数： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nStartRow：要设置的单元格的起始的行号；-1 所有行 -2 当前鼠标选择的行
nStartCol：要设置的单元格的起始的列号；-1 所有列 -2 当前鼠标选择的列
nOperation：操作内容：0 表示取消只读，1 表示设置为只读
示例： #Report.SetCellReadOnly(-1,-1,-1,1);// 设置当前表页的单元格为只读

MergeCells
语法： #Report.MergeCells(nSheetIndex,nStartRow,nStartCol,nEndRow,nEndCol)
说明： 合并单元格
返回值： 设置成功返回 1, 否则返回 0
参数： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nStartRow：要合并的单元格起始行；-1 表示所有行，-2 表示鼠标所选的行
nStartCol：要合并的单元格起始列；-1 表示所有列，-2 表示鼠标所选的列
nEndRow： 要合并的单元格结束行；取值范围为 1 到表行数减 1；nStartRow<0 时无效
nEndCol：要合并的单元格结束列；取值范围为 1 到表列数减 1；nStartCol<0 时无效
示例： #Report.MergeCells(-1,-2,-1,1,1); // 合并当前表页所选行中的所有列的单元格

UnmergeCells
语法： #Report.UnmergeCells(nSheetIndex,nStartRow,nStartCol,nEndRow,nEndCol)
说明： 取消合并单元格
返回值： 设置成功返回 1, 否则返回 0
参数： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nStartRow：要取消合并的单元格起始行；-1 表示所有行，-2 表示鼠标所选的行
nStartCol：要取消合并的单元格起始列；-1 表示所有列，-2 表示鼠标所选的列
nEndRow：要取消合并的单元格结束行；取值范围为 1 到表行数减 1；nStartRow<0时无效
nEndCol：要取消合并的单元格结束列；取值范围为 1 到表列数减 1；nStartCol<0 时无效
示例： #Report.UnmergeCells(-1,-2,-1,1,1);// 取消合并当前表页所选行中所有列的单元格

力控组态软件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 设置当前页当前所选中的单元格

力控组态软件ForceControl V7.0的专家报表的表页函数2

GetCellDouble
语法： #report. GetCellDouble(nSheetIndex, nRowIndex, nColIndex)
说明： 获取指定表页中指定单元格的值 (double 类型 )。
返回值： string 返回指定单元格的值 (double)
参数： nSheetIndex：当前要操作的表页索引号，-1 表示当前页；表页索引号取值范围 0 到表页数减 1
nRowIndex： 行号；-1 表示最后一行；-2 表示鼠标所选行；其范围是 1 到表页行数减 1
nColIndex：列号；-1 表示最后一列；-2 表示鼠标所选列；其范围是 1 到表页列数减 1
示例： #Report.GetCellDouble(0, 1, 1);// 获取第一页单元格行号和列号都为 1 的单元格的值

GetCellString
语法： #report.GetCellString(nSheetIndex, nRowIndex, nColIndex);
说明： 获取指定表页中指定单元格的值 ( 字符串类 )。
返回值： string 返回指定单元格的值 ( 字符型 )
参数： nSheetIndex：当前要操作的表页索引号，-1 表示当前页；表页索引号取值范围 0 到表页数减 1
nRowIndex： 行号；-1 表示最后一行；-2 表示鼠标所选行；其范围是 1 到表页行数减 1
nColIndex；列号；-1 表示最后一列；-2 表示鼠标所选列；其范围是 1 到表页列数减 1
示例： #Report.GetCellString(0,1,1);// 获取第一页单元格行号和列号都为 1 的单元格的值

GetColWidth
语法： #Report.GetColWidth(nSheetIndex,nColIndex);
说明： 获取单元格的列宽
返回值： 列宽的大小 ( 像素值 )
参数： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nColIndex：所在的列号，列号从 1 开始，取值范围为 0 到表列数减 1
示例： #Report.GetColWidth(-1,1); // 获取当前页第一列的列宽

GetRowHeight
语法： #Report.GetRowHeight(nSheetIndex,nRowIndex);
说明： 获取单元格的行高
返回值： 行高的大小 ( 像素值 )
参数 ： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nRowIndex：所在的行号，行号从 1 开始，取值范围为 0 到表行数减 1
示例： #Report.GetRowHeight(-1,1); // 获取当前页第一行的行高

GetCurColIndex
语法： #report.GetCurColIndex（）;
说明： 获取当前选中的列的索引。
返回值： 执行成功返回获得的列索引，否则返回 -1。
参数： 无。
示例： nColIndex = #report.GetCurColIndex(); // 返回当前列索引

GetCurRowIndex
语法： #report.GetCurRowIndex（）;
说明： 获取当前选中的行的索引。
返回值： 执行成功返回获得的行索引，否则返回 -1。
参数： 无
示例： nRowIndex = #report.GetCurRowIndex(); // 返回当前行索引

GetCurSheet
语法： #report.GetCurSheet（）;
说明： 获取当前表页索引。
返回值： 获取成功返回当前表页索引，否则返回 -1。
参数： 无。
示例： index = #report.GetCurSheet();

GetSheetCols
语法： #report.GetSheetCols(nSheetIndex);
说明： 获取指定表页的列数
返回值： 执行成功返回获得的列数，否则返回 -1。
参数： nSheetIndex：当前要操作的页，-1 表示当前页；页索引号从 0 开始，取值范围为 0 到表页数减 1。
示例： #report.GetSheetCols(0);

GetSheetRows
语法： #report.GetSheetRows(nSheetIndex);
说明： 获取指定表页的行数
返回值： 执行成功返回获得的行数 , 否则返回 -1
参数： nSheetIndex：当前要操作的页，-1 表示当前页；页索引号从 0 开始，取值范围为 0 到表页数减 1。
示例： #report.GetSheetRows(0);