构件参数 构件属性 构件方法 故障分析

# 报警浏览构件帮助

## 1、 构件功能简介

本驱动构件功能：报警浏览构件是以表格样式显示报警信息，以历史报警和实时报警两种不同方式显示报警信息，并对选中的报警信息进行焦点显示和子显示。它只显示报警设置中设置过的报警内容，如果没有在报警设置中设置则不显示。

注：此构件只能在 MCGS 嵌入式 6.8 (01.0001)(含) 之上版本使用

## 2、 构件使用说明

构件文件分为：AlarmTableView.dll 、AlarmTableView_ARMV4.drv 、AlarmTableView.drv

1. 以上文件在安装组态软件后，被添加到在“\ActiveX\外挂版本构件\报警浏览动画构件”目录下。例如：mcgs 软件安装在Ｄ盘“D:\MCGSE\Program\ActiveX\报警浏览动画构件”目录为例。

2. 点击菜单项的 “工具”— “动画构件管理”，可见下图 ：

３．在工具栏中选择并绘制构件：

## 3、 构件参数设置

双击构件可以调出构件的属性配置页，如下：

1) 基本属性

此选项卡主要用来设置报警显示模式和表格的基本属性，具体设置如下：

构件属性 | 变量连接 | 属性说明
实时报警数据 | 组对象 报警变量（数值型、开关型） | 实时报警只显示当前正在发生的报警信息；如果该值为空，则显示所有报警对象信息，不为空，则显示指定对象的报警信息
历史报警数据 | 无 | 历史报警从报警记录库中调用报警信息并显示,可以指定最近一天、 一周、 一月、自定义时间段或者全部报警信息
开始时间 结束时间 | 字符型 | 指定自定义开始时间和结束时间绑定变量，变量类型是字符且输入值必须符合指定格式：“yyyy-mm-dd hh:mm:ss”，可以根据需要选择输入到月、日、分、秒。
行数 | 无 | 指定构件显示的行数
行间距 | 无 | 行与行间的距离
起始行 | 无 | 在有多个报警信息时，从第几条报警信息开始显示。可以用 GetRowCount()方法或 RowCount 属性获得行的总个数，用 SetStartRow()方法或 StartRow 属性设置起始行，此功能只对实时报警设置有效。
滚动方向 | 无 | 向上时，新报警信息显示在表格的第一行，反之，显示在最后一行

2) 显示格式

此选项卡主要用来设置报警信息显示内容及构件外观样式，具体设置如下：

构件属性 | 变量连接 | 属性说明
显示内容及列宽 | 无 | 指定显示报警信息的列字段及列宽
边框类型 | 无 | 指定报警浏览构件的边框类型
日期格式 | 无 | 指定日期的显示格式
时间格式 | 无 | 指定时间的显示格式

3) 字体和颜色

此选项卡主要用来设置报警信息字体颜色及焦点显示等内容，具体设置如下：

构件属性 | 变量连接 | 属性说明
背景颜色 | 无 | 设置报警浏览构件的背景颜色
字体颜色 | 无 | 设置字体显示大小及颜色
报警信息颜色 | 无 | 报警信息显示时的字体颜色，分别指定报警时、应答后等不同状态报警信息字体的颜色
焦点显示边线类型 | 无 | 选中报警信息时，报警信息边线的粗细类型
焦点显示边线颜色 | 无 | 选中报警信息时，报警信息的边线颜色
报警变量名输出 | 字符型 | 把当前焦点报警行的变量名输出到指定变量
报警内容输出 | 字符型 | 把当前焦点报警信息的子显示内容输出到指定变量
错误信息输出 | 字符型 | 在运行环境下，当构件相关操作错误时，用于输出错误提示信息 (将关联变量连接到窗口控件显示)

## 4、 构件属性说明

此构件特有属性如下：

构件属性 | 属性类型 | 属性说明
StartRow | 数值型变量 读写 | 起始行数（实时报警）
RowCount | 数值型变量 只读 | 报警信息总数（实时报警）

## 5、 构件方法说明

构件方法 | 方法说明
数值型 SetStartRow(int nRow) | 函数功能：设置起始行（实时报警） 函数参数：数值型，设置的起始行数 函数返回：数值型，0 表示执行失败；反之表示成功
数值型 GetStartRow() | 函数功能：获得当前起始行（实时报警） 函数参数：无 函数返回：数值型，起始行数
数值型 GetRowCount() | 函数功能：获得报警信息总条数（实时报警） 函数参数：无 函数返回：数值型，报警信息总条数
数值型 PageUp() | 函数功能：上翻页 函数参数：无 函数返回：数值型，0：表示执行失败；反之表示成功
数值型 PageDown() | 函数功能：下翻页 函数参数：无 函数返回：数值型，0：表示执行失败；反之表示成功
RefreshHistoryData() | 函数功能：刷新历史记录（历史报警） 函数参数：无 函数返回：无

注：未标明属性或方法实时报警和历史报警模式都可用

## 6、 常见使用故障分析

故障现象 | 分析 | 处理建议
历史报警没有数据 | 1. 数据报警信息未保存 2. 自定义时间段未正确设置时间 3. 未刷新构件 | 1. 检查组态下设置报警的数据是否设置自动保存产生的报警信息，如果未选择，选中即可 2. 检查运行时是否按照提示时间格式输入正确的时间 3. 历史报警数据在当前窗口是不能自动刷新的，可以通过切换窗口或者控件的脚本函数 RefreshHistoryData()来刷新构件
新报警不能实时显示在当前可见范围 | 当使用翻页功能时会改变起始行，当起始行不为 0 时，新报警将不会显示在最前 | 在组态设置或者运行状态下将起始行重设为 0 即可
切换页面后新报警信息不能实时显示在当前可见范围 | 当切换页面后，再回到当前页面时，构件设置会恢复组态下设定值，当组态下起始行设置不为 0 时，则不能实时显示当前发生的报警信息 | 1. 组态下将起始行设置为 0 2. 在运行时用函数或者属性设置脚本将起始行重新设置为 0

#