昆仑通态触摸屏McgsPro软件动画构件-存盘数据浏览
1、昆仑通态触摸屏McgsPro软件动画构件功能概述
存盘数据浏览构件的功能在于对历史数据和历史报警数据进行浏览和操作。具体方法是通过在“数据源”属性页中，选择存盘组对象进行关联，并且在显示属性页中的数据列与组对象中的成员进行关联。通过这种方式可以对历史存盘数据进行浏览和操作。
与历史数据进行关联时，存盘数据浏览构件支持时间筛选功能，在组态的构件属性页进行配置。
存盘数据浏览构件还提供了部分命令用于更好的浏览数据、设置外观、和获取变量值。

2、昆仑通态触摸屏McgsPro软件动画构件组态配置
存盘数据浏览构件包括基本属性，数据来源，显示属性，时间条件4个属性页。
（1）基本属性页
基本属性页主要用于设置标题的属性，内容的属性和焦点的属性，例如：字体、颜色和行高等。基本属性页见图1。


● 标题背景颜色：设置标题行背景颜色。
● 标题字体设置：设置标题文字颜色和字体。
● 表格行高：设置每一行的行高。
● 内容字体设置：设置内容文字颜色和字体。
● 奇行颜色：设置内容奇行背景颜色。
● 偶行颜色：设置内容偶行背景颜色。
● 网格颜色：设置网格的颜色。
● 是否显示滚动条：设置是否显示滚动条。
● 焦点行背景色：设置焦点行背景颜色。
● 焦点单元格色：设置焦点单元格背景颜色。
● 字体颜色：设置焦点行文字颜色。

（2）数据来源属性页
数据来源属性页用于设置选择数据的来源，数据来源属性页见图2。


● 组对象：浏览自建的组对象的历史数据，通过下拉选择框选择需要浏览的组对象。
● 报警浏览：浏览报警历史数据，报警组对象中的变量名如表1如示。

表1 报警组对象变量名

变量名	变量描述
MCGS序号	行序号
VALNAME	Variable Name: 报警变量名称
TIMES	Time Start: 报警开始时间
TIMEE	Time End: 报警结束时间
TIMEA	Time Answer: 报警应答时间
ALARMTYPE	Alarm Type: 报警类型（如：上限报警）
VALUE	Value: 变量报警值
STANDVALUE	Standard Value: 变量基准值
INFO	Information: 报警信息

● 操作日志：浏览构件操作日志，操作日志组对象的变量名如表2所示

表2 操作日志变量名

变量名	变量描述
MCGS_TIME	操作时间，精度为秒
MCGS_TIMEMS	操作时间，精度为毫秒
MCGS_LOG_USER_NAME	操作的用户
MCGS_LOG_WND_NAME	操作窗口的名称
MCGS_LOG_OBJ_NAME	操作的构件的名称
MCGS_LOG_ACTION	操作执行的动作
MCGS_LOG_INFO	操作的描述

（3）显示属性页
显示属性页用于设置显示的数据列名，显示标题，输出变量，显示格式，对齐方式以及列宽。同时可以设置时间显示格式，复位键可以根据选定的组对象自动列出相应的列名，显示属性页见图3。


● 数据列名：用于设置表格中对应列显示的变量。
● 显示标题：设置表格中对应列的标题，支持多语言，详情请参考第十三章。
● 输出变量：设置一个输出变量，运行时输出焦点所在行的变量的值。
● 单位：设置该列数据的显示单位。与数据一起显示在表格内，支持多语言，详情请参考第十三章。
● 显示格式：该列指定数据的显示格式。指定格式的方式见“6 注意事项”。
● 对齐方式：指定表格对齐方式，有左对齐、中对齐、右对齐。
● 列宽度：用于指定存盘数据浏览构件的对应列的宽度。只支持正整数，异常值请见“注意事项”。
● 时间显示格式：设置时间列中显示时间的格式。如勾选了时、分、秒，就在时间列中显示 hh：mm：ss，例如12:13:25。如果勾选了年、月、日。就在时间列中显示yyyy-MM-dd，例如2017-7-17。

（4）时间条件
时间条件用于设置被浏览数据的时间范围和排序方式。排序方式有升序和降序，选择升序则按时间的升序进行排列，反之按照时间的降序进行排列。提供四种选择时间范围的方式，时间条件属性页见图4。


● 排序方式：根据数据源的时间列进行升序或者降序排列。如果数据源为组对象，时间列为MCGS_Time；如果数据源为报警数据时间列为TIMES。
● 数据筛选：根据数据源中的时间列筛选数据。如果数据源为组对象，时间列为MCGS_Time；如果数据源为报警数据时间列为TIMES。
● 所有存盘数据：处理所有时间段的存盘数据
● zui近时间：处理zui近分钟内的存盘数据
● 固定时间：处理从某个固定时间点开始的存盘数据，固定时间可以分为当天、前一天、本星期、前星期、本月、前一月。对于当天和前一天时间分割点的含义是小时，数值应该在0-23之间；对于本星期和前星期时间分割点的含义是星期几，数值范围应该在1-7之间；对于本月和前月时间分割点的含义是天，数值范围应该在1-31之间。具体时间范围如表8.15-3所示。
● 按变量设置的时间范围处理存盘数据：处理从开始时间到结束时间时间段内的存盘数据。开始时间和结束时间关联字符串变量，时间变量格式为“YYYY-MM-DD HH:MM:SS”，结束时间需大于开始时间，若设置时间格式错误则视为无效，建议开始时间和结束时间范围在1970-2099。如开始时间字符串变量值为：2020-7-10 15:00:00，结束时间字符串变量值为2020-7-10 17:00:00，表示显示7月10日15点到17点时间段内存盘数据。

表3 固定时间范围说明

3 昆仑通态触摸屏McgsPro软件动画构件构件方法
存盘浏览函数方法是一组脚本命令，用于程序运行时用户通过组态实现用脚本控制存盘浏览构件进行翻页、移动、调整构件外观、和获取表格值。
GetRowSelect(RowNo)
函数意义： 检查行是否被选中
参 数： RowNo，整数，检查的行号，从1开始计算
返 回 值： 整数
= 0，没被选中
= 1，行被选中
实 例： ret = 属性.控件0.GetRowSelect(5)，如果焦点在第5 行上，ret的值为1，否则为0
注意事项： 当RowNo<1 或 RowNo>总行数时始终返回0。

SetRowSelect(RowNo, n)
函数意义： 设置行是否被选中
参 数： RowNo，整数，要设置的行号，从1开始计算
n，整数，选择标志，n=非0值为选中；n=0为不选
返 回 值： 浮点数，恒为0
实 例： ret = 属性.控件0.SetRowSelect(5，1)，ret值为0
注意事项： 当RowNo=<1时，设置选中（不选中）时，都是对第1行操作；
当RowNo>=总行数时，则是对zui末行操作

GetColSelect( ColNo )
函数意义： 检查列是否被选中
参 数： ColNo，整数，要检查的列，从1开始，zui大不超过总列数
返 回 值： 整数
=0，没有选中
=1，列被选中
实 例： ret =属性.控件0.GetColSelect(5)，如果焦点在第5列上，ret的值
为1，否则为0
注意事项： 当ColNo<1 或 ColNo>总列数时始终返回0。

SetColSelect( ColNo, n)
函数意义： 设置列是否被选中。
参 数： ColNo，整数，要设置的列号
n，整数，选择标志，n=非0值 为选中；n=0 为不选
返 回 值： 浮点数
=0，设置成功
<>0，设置不成功。
实 例： ret = 属性.控件0.SetColSelect(5，1)，ret值为0
注意事项： 当ColNo=<1时，设置选中（不选中）时，都是对第 一列操作；
当ColNo>=总列数时，则是对zui末列操作

GetCellValue( RowNo , ColNo)
函数意义： 获得指定表格内的值
参 数： RowNo，整数，指定的行号，从0开始计算。
ColNo，整数，指定的列号，从0开始计算。
返 回 值： 字符型，指定表格内的值。
实 例： strRet = 属性.控件0.GetCellValue(1,2)，获取表格中第1行第
2列的数据，返回的结果是一个字符串值。
注意事项： 当RowNo<0 或 RowNo>=总行数时返回空字符串；
当ColNo<0 或 ColNo>=大于总列数时返回空字符串。

PageUp( )
函数意义： 向上翻页
参 数： 无参数
返 回 值： 浮点数
返回值为0
实 例： 属性.控件0.PageUp()

PageDown()
函数意义： 向下翻页
参 数： 无参数
返 回 值： 浮点数，恒为0
实 例： 属性.控件0.PageDown()

MoveUp()
函数意义： 向上移动一行
参 数： 无参数
返 回 值： 浮点数
返回值为0
实 例： 属性.控件0.MoveUp()

MoveDown()
函数意义： 向下移动一行
参 数： 无参数
返 回 值： 浮点数
返回值为0
实 例： 属性.控件0.MoveDown()

Home()
函数意义： 向上翻页到存盘数据的开头。
参 数： 无参数
返 回 值： 浮点数，恒为0
实 例： 属性.控件0.Home()

End()
函数意义： 向下翻页到存盘数据的末端
参 数： 无参数
返 回 值： 浮点数，恒为0
实 例： 属性.控件0.End()

MoveLeft()
函数意义： 向左移动10个像素
参 数： 无参数
返 回 值： 浮点数，恒为0
实 例： 属性.控件0.MoveLeft()

MoveRight()
函数意义： 向右移动10个像素
参 数： 无参数
返 回 值： 浮点数，恒为0
实 例： 属性.控件0.MoveRight()

SeekToPosition(n)
函数意义： 直接定位到指定的位置
参 数： n，整数，为指定的跳转位置。
返 回 值： 浮点数，恒为0
实 例： 属性.控件0.SeekToPosition(5)，存盘数据浏览构件定位到行号5
注意事项： 当RowNo<=1时，是对第 一行操作；当RowNo>=总行数时，则是对zui末行操作

GetColWidth(ColNo)
函数意义： 获取指定列的宽度。
参 数： ColNo，整数，指定的列号。
返 回 值： 整数，指定列的宽度，当指定的列不存在时返回值为0.
实 例： ret = 属性.控件0.GetColWidth(5)，获取存盘数据浏览构件第5列的宽度，ret是第5列的返回值

SetColWidth(ColNo ,Width)
函数意义： 设置指定列的宽度
参 数： ColNo，整数，指定的列号
Width，整数，要设置的宽度，范围是1~65535。
如果指定的列号不存在，则设置宽度不起作用
如果设置的宽度超出范围，则设置也不起作用
返 回 值： 浮点数
=-1，Width超出1~65535的范围
= 0，设置成功
实 例： 属性.控件0.SetColWidth(5,100)，设置存盘数据浏览构件第5
列的宽度值为100

SetTimeDialog()
函数意义： 打开时间条件设置对话框
参 数： 无参数
返 回 值： 浮点数，恒为0
实 例： 属性.控件0.SetTimeDialog()，打开时间设置对话框

Refresh()
函数意义： 刷新列表数据
参 数： 无参数
返 回 值： 浮点数
=0，刷新成功
=1，刷新失败
实 例: ret = 属性.控件0.Refresh()

ExportToFile(FileName,FileType)
函数意义： 根据存盘浏览当前数据筛选条件导出历史数据。
参 数： FileName，字符串，指定导出文件的路径名，不存在子目录时自动创建;若路径以“$MCGS_DIR_USER”开头，表示导出到用户分区，否则表示导出到U盘根目录
FileType，整数，指定导出文件的类型，0表示csv格式，当前只支持csv格式。
返 回 值： 整数
=0，调用成功
<>0，调用失败
=-1020，导出的开始时间大于结束时间
=-1021，U盘没有插入
=-1024,文件操作失败
=-1025，导出路径为空
=-1026，导出路径不合法
=-1029，不支持的导出文件类型
实 例: ret = 属性.控件0.ExportToFile()
注意事项：
(1)序号列不支持导出；
(2)导出csv文件的首行为标题行，标题字符串不能包含英文的冒号、逗号、引号，如果有这些符号则该列导出失败；
(3)导出的数据为统一格式，不支持按存盘浏览的显示格式导出。
(4)以存盘浏览的时间条件进行数据筛选导出，如存盘浏览未及时刷新，则导出的数据与存盘浏览显示的数据条数可能不一致。
(5)如文件目录已存在与导出文件相同名称的文件，则会覆盖原有文件。
zui大导出条数为2000条。

GetColTitle（ColNo）
函数意义： 获取指定列的标题字符串
参 数： ColNo，整数，指定列号，从0开始，如果列号小于0则视为0，如果列号大于列数则视为zui后一列。
返 回 值： 字符型,列的标题字符串
实 例: ret = 属性.控件0.GetColTitle(1)

SetColTitle（ColNo，Char）
函数意义：设置指定列的标题
参 数： ColNo，整数，指定列号，从0开始，如果列号小于0则视为0，如果列号大于列数则视为zui后一列。
Char,字符型，要指定的标题字符串
返 回 值： 浮点数，恒为0
实 例: ret = 属性.控件0.SetColTitle(1,”序号”)

GetColUnit（ColNo）
函数意义： 获取指定列的单位字符串
参 数： ColNo，整数，指定列号，从0开始，如果列号小于0则视为0，如果列号大于列数则视为zui后一列。
返 回 值： 字符型,列的单位字符串
实 例: ret = 属性.控件0.GetColUnit(1)

SetColUnit（ColNo，Char）
函数意义：设置指定列的单位
参 数： ColNo，整数，指定列号，从0开始，如果列号小于0则视为0，如果列号大于列数则视为zui后一列。
Char,字符型，要指定的单位字符串
返 回 值： 浮点数，恒为0
实 例: ret = 属性.控件0.SetColUnit (1,”千克”)

4、昆仑通态触摸屏McgsPro软件动画构件构件属性
存盘数据浏览构件的属性Name，Left，Top，Height，Width，Focus，Visible等常规属性构件属性参考8.2节，这里介绍存盘数据浏览构件的扩展属性。

Row
属性意义：获得、设置当前屏表格的当前行
对象类型：浮点数、整数
读写类型：读写
注意事项：当写入值<1时设置表格首行为当前行，当写入值>表格行数时设置表格末行为当前行

Col
属性意义：获得、设置表格的当前列
对象类型：浮点数、整数
读写类型：读写
注意事项：当写入值<1时设置首列为当前列，当写入值>总列数时设置末列为当前列

Cols
属性意义：获得表格的总列数
数值类型：浮点数、整数
读写类型：只读

DataRows
属性意义：获得表格的总行数
数值类型：浮点数、整数
读写类型：只读

DataRow
属性意义：获得表格当前选中的序号
数值类型：浮点数、整数
读写类型：读写
注意事项：当写入值<1时设置首行为当前选中行，当写入值>总行数时设置末行为当前选中行

DataFirstVisibleRow
属性意义：当前屏表格第 一个可见行的序号
数值类型：浮点数、整数
读写类型：读写
注意事项：当写入值<1时设置首行为当第 一个可见行，当写入值>总行数时设置末行为第 一个可见行

RowsPerPage
属性意义：每页显示的行数
数值类型：浮点数
读写类型：只读

5、昆仑通态触摸屏McgsPro软件动画构件构件属性
构件属性请参考（昆仑通态触摸屏McgsPro软件动画构件-公共属性）。

6、昆仑通态触摸屏McgsPro软件动画构件注意事项
（1）存盘数据浏览构件连接的组对象，必须设置开启存盘功能方能显示历史数据。
（2）显示属性页中的显示格式，有如下关系：
当连接的变量是浮点数对象或整数对象且希望输出数值型格式时，格式化字符串应写为 ：“数字1|数字2”的样式。在这里，“数字1”指的是输出的数值应该具有小数位的位数，“数字2”指的是输出的字符串后面，应该带有的空格个数，在这两个数字的中间，用符号 “|” 分开。如：“3|2”表示输出的数值有三位小数和附加两个空格，小数位数范围为[0,15]，空格个数范围为[0,1024]。
当连接的变量是浮点数对象或整数对象且希望输出开关型格式时，格式化字符串应写为：“字符串1|字符串2”的样式。其中，“字符串1”指的是当变量的值为非零时，在此表格表单元内应显示的内容；“字符串2”的内容则在变量的值为零时显示。两者之间用 “|”隔开。如：“有效｜无效”，“开|关”，“正确|错误”等都可作为开关型格式的输出格式化字符串。
当连接的变量是浮点数且希望输出为自然小数位数时，格式化字符串应写为：“-1|数字”，其中数字指的是输出字符串后面空格的个数。如格式为“-1|0”时，浮点数1.234格式化后的字符串为“1.234”，且格式化后zui大有效位数为6。
当连接的变量是字符型对象时，不按格式化字符串处理，显示字符串对象内容。
当字符串不能被识别时，McgsPro组态软件将简单地用缺省的格式显示变量的值。
（3）McgsPro组态软件中不支持数值条件的筛选功能。
（4）此构件列宽值只支持正整数，其他负数、字母、特殊字符为无效，使用默认值50；输入浮点数时会向下取整。

本文摘自：网络