# reportX 库模块帮助文档

## reportX 成员列表 <a id="reportX" href="#reportX">&#x23;</a>

报表控件

### reportX() <a id="reportX()" href="#reportX()">&#x23;</a>
[返回对象:reportXObject](#reportXObject)

### reportX(窗口对象) <a id="reportX(窗口对象)" href="#reportX(窗口对象)">&#x23;</a>
创建reportX报表控件

## reportXObject 成员列表 <a id="reportXObject" href="#reportXObject">&#x23;</a>

### reportXObject.CellHeight <a id="reportXObject.CellHeight" href="#reportXObject.CellHeight">&#x23;</a>
单元格默认高度，创建报表控件时会根据屏幕 DPI 自动调整。

### reportXObject.CellWidth <a id="reportXObject.CellWidth" href="#reportXObject.CellWidth">&#x23;</a>
单元格默认宽度，创建报表控件时会根据屏幕 DPI 自动调整。

### reportXObject.DisplayColCount <a id="reportXObject.DisplayColCount" href="#reportXObject.DisplayColCount">&#x23;</a>
显示列数，只读。可通过 newReport 函数修改。

### reportXObject.DisplayRowCount <a id="reportXObject.DisplayRowCount" href="#reportXObject.DisplayRowCount">&#x23;</a>
显示行数，只读。可通过 newReport 函数修改。

### reportXObject.GetColBestWidth(列号) <a id="reportXObject.GetColBestWidth" href="#reportXObject.GetColBestWidth">&#x23;</a>
获取最佳宽度

### reportXObject.OnBeginPrintDoc <a id="reportXObject.OnBeginPrintDoc" href="#reportXObject.OnBeginPrintDoc">&#x23;</a>

```aardio
reportXObject.OnBeginPrintDoc = function(printer,title,titleChange){ 
    /*开始打印时执行，参数说明
printer：打印机句柄
Title：打印文档名
*/
}
```

### reportXObject.OnButtonClick <a id="reportXObject.OnButtonClick" href="#reportXObject.OnButtonClick">&#x23;</a>

```aardio
reportXObject.OnButtonClick = function(aCol,aRow,aNameText,scriptText){ 
    /*单击按钮类型单元格时执行，参数说明
aCol：列号
aRow：行号
aNameText：单元格按钮文本
aScriptText：单元格按钮脚本
*/
}
```

### reportXObject.OnCellChanged <a id="reportXObject.OnCellChanged" href="#reportXObject.OnCellChanged">&#x23;</a>

```aardio
reportXObject.OnCellChanged = function(aCol,aRow,aCellValue ){ 
    /*单元格的值改变后时执行，参数说明
aCol：列号
aRow：行号
aCellValue：单元格的值
*/
}
```

### reportXObject.OnCellChanging <a id="reportXObject.OnCellChanging" href="#reportXObject.OnCellChanging">&#x23;</a>

```aardio
reportXObject.OnCellChanging = function(aCol,aRow,aCellValue ){ 
    /*单元格的值正在改变时执行，参数说明
aCol：列号
aRow：行号
aCellValue：单元格的值
*/
}
```

### reportXObject.OnCellLDblClick <a id="reportXObject.OnCellLDblClick" href="#reportXObject.OnCellLDblClick">&#x23;</a>

```aardio
reportXObject.OnCellLDblClick = function(aCol,aRow ){ 
    /*鼠标左键双击单元格时执行，参数说明
aCol：列号
aRow：行号
*/
}
```

### reportXObject.OnCellLDown <a id="reportXObject.OnCellLDown" href="#reportXObject.OnCellLDown">&#x23;</a>

```aardio
reportXObject.OnCellLDown = function(aCol,aRow ){ 
    /*鼠标左键在单元格上落下时执行，参数说明
aCol：列号
aRow：行号
*/
}
```

### reportXObject.OnCellLUp <a id="reportXObject.OnCellLUp" href="#reportXObject.OnCellLUp">&#x23;</a>

```aardio
reportXObject.OnCellLUp = function(aCol,aRow ){ 
    /*鼠标左键在单元格上抬起时执行，参数说明
aCol：列号
aRow：行号
*/
}
```

### reportXObject.OnCellRDown <a id="reportXObject.OnCellRDown" href="#reportXObject.OnCellRDown">&#x23;</a>

```aardio
reportXObject.OnCellRDown = function(aCol,aRow,aScreenX,aScreenY ){ 
    /*鼠标右键下落时执行，参数说明
aCol：列号
aRow：行号
aScreenX：在屏幕上的横坐标
aScreenY：在屏幕上的纵坐标
*/
}
```

### reportXObject.OnError <a id="reportXObject.OnError" href="#reportXObject.OnError">&#x23;</a>

```aardio
reportXObject.OnSelectChange = function(aMessage ){ 
    /*发生错误时执行,参数说明
aMessage：错误信息*/
}
```

### reportXObject.OnInputChange <a id="reportXObject.OnInputChange" href="#reportXObject.OnInputChange">&#x23;</a>

```aardio
reportXObject.OnInputChange = function(aCol,aRow ){ 
    /*输入单元格改变时执行,参数说明
aCol：列号
aRow：行号*/
}
```

### reportXObject.OnKeyPress <a id="reportXObject.OnKeyPress" href="#reportXObject.OnKeyPress">&#x23;</a>

```aardio
reportXObject.OnKeyPress = function(keyCode){ 
    /*按键时执行,参数说明
keyCode：按键*/
}
```

### reportXObject.PoleHeight <a id="reportXObject.PoleHeight" href="#reportXObject.PoleHeight">&#x23;</a>
标题列高度，创建报表控件时会根据屏幕 DPI 自动调整。

### reportXObject.SetColWidth <a id="reportXObject.SetColWidth" href="#reportXObject.SetColWidth">&#x23;</a>
设置列宽度

### reportXObject.SetColWidth(列号,宽度) <a id="reportXObject.SetColWidth" href="#reportXObject.SetColWidth">&#x23;</a>
设置列宽度

### reportXObject.addCellPicture(列,行,图像路径,是否拉伸) <a id="reportXObject.addCellPicture" href="#reportXObject.addCellPicture">&#x23;</a>
添加图像

### reportXObject.addChartSeries(图表名,类型,样式,数据,单元格) <a id="reportXObject.addChartSeries" href="#reportXObject.addChartSeries">&#x23;</a>
添加图表内容  
详见帮助文档

### reportXObject.colCount <a id="reportXObject.colCount" href="#reportXObject.colCount">&#x23;</a>
列总数

### reportXObject.connectionString <a id="reportXObject.connectionString" href="#reportXObject.connectionString">&#x23;</a>
数据库连接串

### reportXObject.delCellPicture(列,行) <a id="reportXObject.delCellPicture" href="#reportXObject.delCellPicture">&#x23;</a>
删除图像

### reportXObject.editCellScript(列,行) <a id="reportXObject.editCellScript" href="#reportXObject.editCellScript">&#x23;</a>
插入脚本

### reportXObject.executeScript <a id="reportXObject.executeScript" href="#reportXObject.executeScript">&#x23;</a>
单元格改变时是否自动执行脚本

### reportXObject.exportExcel(文件路径,按显示值输出) <a id="reportXObject.exportExcel" href="#reportXObject.exportExcel">&#x23;</a>
导出excel表格,xls格式

### reportXObject.getCellValue(列,行) <a id="reportXObject.getCellValue" href="#reportXObject.getCellValue">&#x23;</a>
返回指定单元格的值

### reportXObject.getSelectCell() <a id="reportXObject.getSelectCell" href="#reportXObject.getSelectCell">&#x23;</a>
返回选区

### reportXObject.importExcel(文件路径,仅导入文本) <a id="reportXObject.importExcel" href="#reportXObject.importExcel">&#x23;</a>
导入excel表格,xls格式

### reportXObject.importExcelOle(文件路径,仅导入文本,列1,行1,列2,行2) <a id="reportXObject.importExcelOle" href="#reportXObject.importExcelOle">&#x23;</a>
导入excel表格，  
指定行列参数可省略

### reportXObject.lockUpdate <a id="reportXObject.lockUpdate" href="#reportXObject.lockUpdate">&#x23;</a>

```aardio
reportXObject.lockUpdate( function(){   
	/*暂停刷新并执行这里的代码*/  
	}  
)
```

### reportXObject.mergeSelected() <a id="reportXObject.mergeSelected" href="#reportXObject.mergeSelected">&#x23;</a>
合并选中单元格

### reportXObject.newReport(列数,行数) <a id="reportXObject.newReport" href="#reportXObject.newReport">&#x23;</a>
新建报表

### reportXObject.openDatabaseGuide() <a id="reportXObject.openDatabaseGuide" href="#reportXObject.openDatabaseGuide">&#x23;</a>
打开数据库连接向导

### reportXObject.openReport(报表文件路径) <a id="reportXObject.openReport" href="#reportXObject.openReport">&#x23;</a>
打开报表

### reportXObject.openString(报表字符串,是否压缩) <a id="reportXObject.openString" href="#reportXObject.openString">&#x23;</a>
从字符串载入报表

### reportXObject.printPreview <a id="reportXObject.printPreview" href="#reportXObject.printPreview">&#x23;</a>
打印预览

### reportXObject.printSetup <a id="reportXObject.printSetup" href="#reportXObject.printSetup">&#x23;</a>
打印设置

### reportXObject.printSheet <a id="reportXObject.printSheet" href="#reportXObject.printSheet">&#x23;</a>
直接打印

### reportXObject.rowCount <a id="reportXObject.rowCount" href="#reportXObject.rowCount">&#x23;</a>
行总数

### reportXObject.saveReport(报表文件路径) <a id="reportXObject.saveReport" href="#reportXObject.saveReport">&#x23;</a>
存储报表

### reportXObject.saveString(是否压缩) <a id="reportXObject.saveString" href="#reportXObject.saveString">&#x23;</a>
保存到字符串

### reportXObject.saved <a id="reportXObject.saved" href="#reportXObject.saved">&#x23;</a>
是否保存

### reportXObject.setCellBackColor(列,行,背景色) <a id="reportXObject.setCellBackColor" href="#reportXObject.setCellBackColor">&#x23;</a>
设置单元格背景色

### reportXObject.setCellBorder(列,行,边框类型,宽度,样式) <a id="reportXObject.setCellBorder" href="#reportXObject.setCellBorder">&#x23;</a>
边框类型  
    0：四周 1：左边 2：上边 3：右边 4：下边 5：斜线 6：反斜线  

边框样式  
    0：实线；1：虚线；2：点；3：点虚线；4点点虚线

### reportXObject.setCellControl(列号,行号,输入控制) <a id="reportXObject.setCellControl" href="#reportXObject.setCellControl">&#x23;</a>
输入控制  
0：无  
1：字母  
2：自然数  
3：整数  
4：字母数字  
5：字母数字  
6：实数

### reportXObject.setCellExpression(列,行,公式) <a id="reportXObject.setCellExpression" href="#reportXObject.setCellExpression">&#x23;</a>
设置公式

### reportXObject.setCellExpression(列数,行数,公式) <a id="reportXObject.setCellExpression" href="#reportXObject.setCellExpression">&#x23;</a>
设置单元格公式。  
支持标准函数+、-、*、/、\整除、%取余、^乘方、  
PI、Abs、Sqrt、Ln、Exp、Sin、Cos、Tg、ArcTan、  
Fac阶乘、（左扩号、）右扩号  
支持自定义函数Sum(aCol1，aRow1、aCol2、aRow2)、  
Average(aCol1，aRow1、aCol2、aRow2)、Max(aCol1，aRow1、aCol2、aRow2)、  
Min(aCol1，aRow1、aCol2、aRow2)、Stdev(aCol1，aRow1、aCol2、aRow2)

### reportXObject.setCellFontColor(列,行,字体颜色) <a id="reportXObject.setCellFontColor" href="#reportXObject.setCellFontColor">&#x23;</a>
设置单元格字体颜色

### reportXObject.setCellFontStyle(列,行,字体样式,是否设置) <a id="reportXObject.setCellFontStyle" href="#reportXObject.setCellFontStyle">&#x23;</a>
设置字体样式（0：粗体；1：斜体；2：下滑线；3：删除线）

### reportXObject.setCellFontStyle(列数,行数,样式类型,是否设置) <a id="reportXObject.setCellFontStyle" href="#reportXObject.setCellFontStyle">&#x23;</a>
参数@3可选字体类型如下:  
0：粗体；1：斜体；2：下滑线；3：删除线

### reportXObject.setCellFormat(列号,行号,1,"##,###.00") <a id="reportXObject.setCellFormat" href="#reportXObject.setCellFormat">&#x23;</a>
输入1234.5 显示1,234.50

### reportXObject.setCellFormat(列号,行号,1,"0.00") <a id="reportXObject.setCellFormat" href="#reportXObject.setCellFormat">&#x23;</a>
输入1234.5 显示1234.50

### reportXObject.setCellFormat(列号,行号,1,"0.00%") <a id="reportXObject.setCellFormat" href="#reportXObject.setCellFormat">&#x23;</a>
输入1234.5 显示1234.50%

### reportXObject.setCellFormat(列号,行号,2,"3") <a id="reportXObject.setCellFormat" href="#reportXObject.setCellFormat">&#x23;</a>
输入1234.5 显示1230

### reportXObject.setCellFormat(列号,行号,3 "yyyy'年'MM'月'dd'日'") <a id="reportXObject.setCellFormat" href="#reportXObject.setCellFormat">&#x23;</a>
输入1-01-01 显示2001年01月01日

### reportXObject.setCellFormat(列号,行号,3 "yyyy-MMM-dd DDD") <a id="reportXObject.setCellFormat" href="#reportXObject.setCellFormat">&#x23;</a>
输入1-01-01 显示2001-一月-01 星期一

### reportXObject.setCellFormat(列号,行号,3,"yyyy-MM-dd") <a id="reportXObject.setCellFormat" href="#reportXObject.setCellFormat">&#x23;</a>
输入1-01-01 显示2001-01-01

### reportXObject.setCellFormat(列号,行号,4, "h:mm:ss AM/PM") <a id="reportXObject.setCellFormat" href="#reportXObject.setCellFormat">&#x23;</a>
输入1:01:01 显示1:01:01 AM

### reportXObject.setCellFormat(列号,行号,4,"hh'时'mm'分'ss'秒'") <a id="reportXObject.setCellFormat" href="#reportXObject.setCellFormat">&#x23;</a>
输入1:01:01 显示01时01分01秒

### reportXObject.setCellFormat(列号,行号,4,"hh:mm:ss") <a id="reportXObject.setCellFormat" href="#reportXObject.setCellFormat">&#x23;</a>
输入1:01:01 显示01:01:01

### reportXObject.setCellValue(列号,行号,值) <a id="reportXObject.setCellValue" href="#reportXObject.setCellValue">&#x23;</a>
修改单元格的值

### reportXObject.setFrozenCol(起始列,结束列) <a id="reportXObject.setFrozenCol" href="#reportXObject.setFrozenCol">&#x23;</a>
设置冻结列

### reportXObject.setFrozenRow(起始行,结束行) <a id="reportXObject.setFrozenRow" href="#reportXObject.setFrozenRow">&#x23;</a>
设置冻结行

### reportXObject.setLeftPoleText(行,标题) <a id="reportXObject.setLeftPoleText" href="#reportXObject.setLeftPoleText">&#x23;</a>
设置行标题

### reportXObject.setSelectCell(起始行,起始列,结束行,结束列) <a id="reportXObject.setSelectCell" href="#reportXObject.setSelectCell">&#x23;</a>
设置选区

### reportXObject.setTopPoleText(列,标题) <a id="reportXObject.setTopPoleText" href="#reportXObject.setTopPoleText">&#x23;</a>
设置列标题
