数据浏览控件的控件事件
TagSelected
事件描述： 点选择事件
返回值： 无
参数： int nTagCount- 选中点的个数
String strLongTagName- 选中点的长点名，以“，”分隔
数据浏览控件的控件属性
SelTagCount
描述： 进行点选择操作后，选中的点的个数
类型： int
说明： 需要配合 TagSelected 方法使用
示例： nSelTagName=#name.SelTagCount
AddPVName
语法： int #name.AddPVName(string strVarName,string strTitle)
说明： 增加点名
参数： strVarName 点名
strTitle 标题
返回值： 整型 , 表示插入点的位置 ( 从零开始 ), 如果插入失败就返回 -1
注意： 标题的设置和标题类型有关 , 只有标类型为 ” 自定义 “, 才需要填写 strTitle, 否则可置空字符串。
示例： #name.AddPVName(“a.pv”,”abc”);// 在列表后插入第一个点为 a. 标题是 abc
GetPVName
语法： #name.GetPVName(int nPos)
说明： 获取点名
参数： nPos 序号
返回值： 字符串型
示例： #report.GetPVName(0);// 获取第一个点的点名
ModifPVName
语法： int #report.ModifPVName(int nPos,string strVarName,string strTitle)
说明： 修改点名
参数： nPos 序号 ( 从零开始 )
strVarName 点名
strTitle 标题
返回值： 整型，(1) 修改成功，(0) 修改失败 ( 如果 nPos 位置上没有点 , 或参数不正确会修改失败。
注意： 标题的设置和标题类型有关 , 只有标类型为 ” 自定义 “, 才需要填写 strTitle , 否则可置空字符串
示例： #report.AddPVName(0,”a.pv”,”abc”);// 把 0 位置的点修改成 a.pv
NowTime
语法： #report.NowTime()
说明： 设置报表结束时间为当时间
参数： 无
返回值： 整型， 1 代表设置成功；0 代表设置失败。
示例： #report.NowTime();// 以当前时间为报表结束时间 , 计算历史数据的起始时间
OffDay
语法： #report.OffDay(int nDays)
说明： 设置报表开始时间
参数： nDays 表示从设定日期开始往后 ( 正整数 ) 或者往前 ( 负整数 ) 的天数
返回值： 整型
1 代表设置成功
0 代表设置失败
示例： #report.OffDay(1);// 设置报表开始时间为原始时间的后一天
OffHour
语法： #report.OffHour(int nHours)
说明： 设置报表开始时间
参数： nHours 表示从设定日期开始往后 ( 正整数 ) 或者往前 ( 负整数 ) 的小时数
返回值： 为整型
1 代表设置成功
0 代表设置失败
示例： #report.OffHour(1);// 设置报表开始时间为原始时间的后一小时
OffMinute
语法： #report.OffMinute(int nMinutes)
说明： 设置报表开始时间
参数： nMinutes 表示从设定日期开始往后 ( 正整数 ) 或者往前 ( 负整数 ) 的分钟数
返回值： 为整型
1 代表设置成功
0 代表设置失败
示例： #report.OffMinute(1);// 设置报表开始时间为原始时间的后一分钟
PrePrint
语法： #report.PrePrint()
说明： 打印报表预览
参数： 无
返回值： 无
示例： #report.PrePrint();// 报表打印预览
Print
语法： #report.Print()
说明： 打印报表
参数： 无
返回值： 无
示例： #report.Print();// 打印报表
SaveCSV
语法： #report.SaveCSV(char * strFileName);
说明： 保存报表到 CSV 文件
参数： strFileName 保存的文件名参数必须为绝对路径，不能使用相对路径
返回值： 整型
1 代表保存成功
0 代表保存失败
示例： #report.SaveCSV(“d:\f.csv”);// 将报表保存到 “d:\f.csv” 文件中
SetTime
语法： #report.SetTime(int nYear,int nMonth,int nDay,int nHour,int nMinute,int nSecond)
说明： 设置报表开始时间
参数： nYear 报表开始年
nMonth 报表开始月
nDay 报表开始日
nHour 报表开始时
nMinute 报表开始分
nSecond 报表开始秒
返回值： 为整型
1 代表设置成功
0 代表设置失败
示例： #report.SetTime(2007,3,27,10,12,26);// 设置报表开始时间为 2007 年 3 月 27 日 10点 12 分 26 秒
SetTimeEx
语法： #report.SetTimeEx(int nTime)
说明： 设置报表开始时间
参数： nTime 设置报表开始时间，时间为自 1970 年 1 月 1 日零时逝去的秒数
返回值： 整型：
1 代表设置成功
0 代表设置失败
示例： #report.SetTimeEx(LongTime(“2007/3/27 10:12:26”));// 设置报表开始时间为 2007年 3 月 27 日 10 点 12 分 26 秒
SetTimeSpan
语法： #report.SetTimeSpan(int nRange,int nSpace)
说明： 设置报表时间范围，间隔
参数： nRange 报表时间范围 ( 秒 )
nSpace 报表时间间隔 ( 秒 )
返回值： 为整型
1 代表设置成功
0 代表设置失败
示例： #report.SetTimeSpan(3600,60);// 设置报表的时间范围为 1 小时 , 时间间隔为 1 分钟
ExecuteSQL
语法： #report.ExecuteSQL(nSheetIndex, strSQL);
说明： 执行标准 SQL 语句。
返回值： 执行成功返回 1；否则返回 0。
参数： nSheetIndex：当前要操作的页，-1 表示当前页；页索引号从 0 开始，取值范围为 0 到表页数减 1。
strSQL：要执行的 SQL 语句。
示例： #Report.ExecuteSQL(-1,”select * from table1″);// 在当前表页执行 SQL
SqlQuery
语法： #report.SqlQuery(nSheetIndex, nModeSql);
说明： 按条件查询。
返回值： 执行成功返 1，否则返回 0。
参数： nSheetIndex：当前要操作的页，-1 表示当前页；页索引号从 0 开始，取值范围为 0 到表页数减 1。
nModeSql：取值范围 0 和 1；0 表示使用向导生成查询条件；1 表示调用组态时设置好的查询条件。
示例： #report.SqlQuery(0, 1); 当前页调用组态时设置好的查询条件查询
SqlQueryEx
语法： #Report.SqlQueryEx(nSheetIndex, strModeSql);
说明： 条件查询
返回值： 设置成功返回 1, 否则返回 0
参数： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1
strModeSql：要使用的查询语句
示例 ： #Report.SqlQuery(0, “select [ 时间 ],[ 字段 1],[ 字段 2], from [tab1] “);
UpdateRecord
语法： #report.UpdateRecord(nSheetIndex);
说明： 数据提交函数，修改数据后，调用该函数写入关系数据库。
返回值： 执行成功返回 1；否则返回 0。
参数： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1。
示例： #report.UpdateRecord(0); // 将第一表页的数据写入其关联的关系数据库
UpdateRecordEx
语法： #Report.UpdateRecordEx(nSheetIndex, nStartRow, nRecordCnt);
说明： 数据提交函数
返回值： 设置成功返回 1, 否则返回 0
参数： nSheetIndex：当前要操作的页 , -1 表示当前页；页索引号从 0 开始 , 取值范围为 0 到表页数减 1
nStartRow：需要更新的关系数据库中的在表页中的起始行，-2 表示当前所选行
nRecordCnt：需要更新的记录条数
示例： #Report.UpdateRecord(-1, 1, 2);// 将当前页从第 1、2 行的数据写入关系数据库
SetConnectStr
语法： nResult = #report.SetConnectStr(nSheetIndex,nConnectType,strConnectStr,strTableName)
说明： 设置关系数据库连接字符串，并打开指定表格
返回值： 执行成功返回 1，否则返回 0
参数： nSheetIndex: 指定要操作的表页，-1 表示当前页；表页索引号取值范围 0 到表页数减 1
nConnectType: 连接串类型，0- 连接字符串；1- 组态下已配置好的数据源名称
strConnectStr: 数据库连接串或已配置好的数据源名称
strTableName: 要打开的数据表的名称，如果为空则打开第一个表格
示例： #report.SetConnectStr(-1, 1, “Test”,”test”); // 打开数据源名称为 Test 的数据库的 test 表