QQ
微信
8.18 报警浏览
8.18.1 功能概述
报警浏览构件是以表格样式显示报警信息，以历史报警和实时报警两种不同方式显示报警信息，并对选中的报警信息进行焦点显示。它只显示报警设置中设置过的变量的报警内容，如果变量没有在报警设置中设置则不显示。变量设置报警操作4.3章节。
8.18.2 构件加载
检查构件工具箱，观察是否存在报警浏览构件图标（如图8.18-1），若没有则点击组态软件菜单项“工具” |“动画构件管理”弹出如图8.18-2所示对话框，选中报警浏览构件并点击“增加”按钮将构件添加到工具箱中。使用时从构件工具箱中拖动构件进行绘制。
图8.18-1 构件工具箱
图8.18-2 动画构件管理对话框
8.18.3 组态配置
在组态中绘制好报警浏览构件后，双击构件可以弹出构件的属性配置页。
（1）基本属性页
字体和颜色设置页包括对标题的设置、数据区域显示背景色、数据区域显示文本颜色、焦点显示设置及网格设置，如图8.18-3和图8.18-4所示。
图8.18-3报警浏览基本属性设置
图8.18-4报警浏览基本属性设置
报警浏览字体和颜色设置包括如下几项：
l 标题背景颜色：设置标题行背景；
l 标题字符颜色：设置标题文本颜色；
l 标题字体：设置标题文本字体；
l 奇偶行：设置数据显示区域背景色按奇偶行进行设置
l 分类：设置数据显示区域背景色按报警分类进行设置
l 奇行背景颜色：设置报警内容奇行背景色，奇偶行设置时生效；
l 偶行背景颜色：设置报警内容偶数行背景色，奇偶行设置时生效；
l 报警新产生背景色：设置报警分类为报警新产生背景色，分类设置时生效；
l 响应未结束背景色：设置报警分类为响应未结束背景色，分类设置时生效；
l 结束未响应背景色：设置报警分类为结束未响应背景色，分类设置时生效；
l 结束且响应背景色：设置报警分类为结束且响应背景色，分类设置时生效；
l 断电前报警背景色：设置报警分类为断电前报警背景色，分类设置时生效；
l 报警新产生文本色：设置报警分类为报警新产生文本色；
l 响应未结束文本色：设置报警分类为响应未结束文本色；
l 结束未响应文本色：设置报警分类为结束未响应文本色；
l 结束且响应文本色：设置报警分类为结束且响应文本色；
l 断电前报警文本色：设置报警分类为断电前报警文本色；
l 网格颜色：设置网格颜色；
l 文字字体：设置报警内容文本字体；
l 焦点背景颜色：设置焦点背景颜色；
l 焦点文字颜色：设置焦点文字颜色；
l 水平滚动条：设置水平滚动条可见；
l 竖直滚动条：设置竖直滚动条可见；
（2）数据来源属性页
数据来源属性页可设置报警浏览的显示模式、基本显示参数、滚动方向，如图8.18-5所示。
图8.18-5报警浏览数据来源设置
显示模式包括如下两种：
l 实时报警数据：报警浏览实时显示当前发生的报警信息。
l 历史报警数据：显示历史报警数据信息。
l 基本显示参数设置包括如下几项：
l 报警对象：点击“？”按钮可以设置报警浏览构件显示的报警对象，报警对象为空时显示全部变量的报警，报警对象关联单个变量时只显示该变量的报警，报警对象关联组对象时显示该组对象所有成员变量的报警。
l 当选择整数或浮点数变量且该变量组态了报警，报警浏览构件运行时将只显示该变量产生的报警信息；
l 当选择组对象后，运行时将显示该组对象中所有组态了报警属性的成员变量的报警信息；
l 当未设置任何变量时，报警浏览构件将显示所有组态了报警功能的变量的报警信息。
l 排序方式：设置报警浏览显示内容的时间排列方式，“新报警在上”表示***新的报警信息在***前面，“新报警在下”表示***新的报警信息在***后面。
l 报警应答：实时报警模式有两种应答报警方式，单击应答和双击应答，在报警浏览构件上应答报警后，该条报警信息显示颜色将会改变，并记录应答报警的时间；
l 报警闪烁：实时报警模式可以组态报警闪烁，达到警示效果。报警闪烁只对未应答的报警有效，闪烁速度有快、中、慢三个等级可选；
l 时间选择：可指定报警的发生时间范围，包括***近一天、***近一周、***近一月、全部时间、自定义时间。指定自定义开始时间和结束时间绑定变量，变量类型是字符且输入格式为：“yyyy-mm-dd hh:mm:ss”，分割符可以是除数字以外的任意字符；
l 自动刷新：历史报警模式还可以指定是否“自动刷新历史数据”，勾选此选项后，若指定时间段的历史报警信息发生变化，报警显示内容会随之更新；
l 分组筛选：对报警数据的分组信息进行筛选，可以是形如枚举1,8,12或范围3-6或两者的组合，也可以关联变量在运行时动态设置；范围是0~255；为空时表示不进行筛选，显示全部分组；
l 分级筛选：对报警数据的分级信息进行筛选，可以是形如枚举1,8,12或范围3-6或两者的组合，也可以关联变量在运行时动态设置；范围是0~100；为空时表示不进行筛选，显示全部分级；
l 分类筛选：对报警数据的分类信息进行筛选，可以是形如枚举1,8,12或范围3-6或两者的组合，也可以关联变量在运行时动态设置；范围是0~4；为空时表示不进行筛选，显示全部分类。
（3）显示属性页
显示属性页可配置构件的显示内容及列宽、边框类型、时间日期格式，如图8.18-6所示。
图8.18-6 报警浏览构件显示格式
l 显示内容及列宽：指定报警信息的列字段及其列宽，列字段意义见表8.18-1。其中报警事件字段只有实时报警模式才能组态；编号和结束时间字段只有历史报警模式才能组态。列宽设置范围为：1~65535。其中，“日期”和“时间”指的是报警的发生时间，“报警值”为报警发生时的值，“报警时长”指报警产生到结束时间间隔，“分组”指的是组态时设置的报警分组，“分级”指的是组态时设置的报警分级。
l 边框类型：边框类型指定构件的表格样式，包括网格类型、边框类型、无网格类型、无纵线网格类型四类。
l 日期格式：指定字段中的日期格式，包括“yyyy/mm/dd”、“mm/dd/yyyy”、“dd/mm/yyyy”、“yyyy年mm月dd日”四种格式。
l 时间格式：指定字段中的时间格式和报警时长显示格式，包括“hh:mm:ss”、“hh/mm/ss”、“hh时mm分ss秒”三种格式。
l 行高：设置表格每一行行高，设置范围为1~65535；
l 起始行：仅实时报警模式有效，设置初始化时显示的起始行位置，设置范围为：0~10000；该值在运行中可通过脚本方法修改进而实现跳转；
表8.18-1 报警浏览列字段含义
列字段
报警模式
字段含义
编号
历史报警
历史报警信息排列序号，序号0开始
日期
实时报警、历史报警
报警产生日期
时间
实时报警、历史报警
报警产生时间
对象名
实时报警、历史报警
报警变量名称
报警类型
实时报警、历史报警
报警类型（上限报警、下限报警等）
报警事件
实时报警
当前报警信息状态（产生、应答）
报警值
实时报警、历史报警
报警产生时变量的值
界限值
暂不支持
当前报警类型的界限值
报警描述
实时报警、历史报警
当前报警类型对应报警描述
响应时间
实时报警、历史报警
报警应答时间
结束时间
实时报警、历史报警
报警结束时间
报警时长
实时报警、历史报警
报警产生到报警结束时间间隔
分组
实时报警、历史报警
报警分组信息
分级
实时报警、历史报警
报警分级信息
（4）信息输出属性页
信息输出页如图8.18-7所示，配置包括如下几项：
图8.18-7 报警浏览构件信息输出设置
l 报警变量名输出：关联一个字符串变量，将焦点行对应的变量名称输出到字符串变量中；
l 报警内容输出：关联一个字符串变量，将焦点行对应的报警描述输出到字符串变量中；
l 错误信息输出：关联一个字符串变量，构件操作中产生的错误将输出到该变量中。错误信息列表如表8.18-2所示。
表8.18-2 报警浏览错误信息列表
序号
错误信息内容
触发条件
1
"自定义开始时间和结束时间变量设置错误!正确格式 例如:2008-08-08 08:08:08"
历史报警模式下，自定义时间变量的时间格式错误时触发。
2
"设置起始行错误! 您设置的起始行: %d 正确的起始行: 起始行 >= 0, 起始行 <= %d"
通过脚本属性StartRow，或者脚本方法SetStartRow()更改起始行且起始行参数输入超限时，触发此错误信息
3
分组筛选格式错误!正确格式 例如:0,2,3或1-3
分组筛选字符串格式错误
4
分级筛选格式错误!正确格式 例如:0,2,3或1-3
分级筛选字符串格式错误
5
分类筛选格式错误!正确格式 例如:0,2,3或1-3
分类筛选字符串格式错误
6
查询终止，可用内存严重不足
内存不足
7
查询中止，查询时间超过阀值:%1毫秒，可能仅显示部分结果
查询超时
8
查询中止，查询条数超过阀值:%1，可能仅显示部分结果
查询结果超过预定值
8.18.4 构件方法
SetStartRow(nRow)
函数意义： 设置报警浏览显示起始行
参 数： nRow： 浮点数 设置起始行数
返 回 值： 整数
= 1，成功
=0，失败
实 例： reSetRow=构件方法.控件0.SetStartRow(10)，起始行设置为10，reSetRow=1
注意事项：nRow<0或nRow>总行数时执行失败
GetStartRow()
函数意义： 获取当前起始行
参 数： 无
返 回 值： 浮点数 起始行数
实 例： nStartRow = 构件方法.控件0.GetStartRow( )，nStartRow为起始行序号
GetRowCount()
函数意义： 获取报警信息总条数
参 数： 无
返 回 值： 浮点数 报警信息条数
实 例： nRow = 构件方法.控件0.GetRowCount( ) ，nRow为总行数
PageUp()
函数意义： 向上翻页
参 数： 无
返 回 值： 整数
= 1，成功
=0，失败
实 例： rePageUp=构件方法.控件0.PageUp()，rePageUp为1
注意事项： 返回值始终为1
PageDown()
函数意义： 向下翻页
参 数： 无
返 回 值： 整数
= 1，成功
=0，失败
实 例： rePageDown=构件方法.控件0.PageDown( )，rePageDown为1
注意事项： 返回值始终为1
RefreshHistoryData()
函数意义： 刷新历史记录（历史报警）
参 数： 无
返 回 值： 无
实 例： 构件方法.控件0.RefreshHistoryData( )
SetAlarmObject(ObjName)
函数意义： 运行时切换报警对象
参 数： ObjName: 字符串 报警对象名称，如果为空字符串则显示所有报警
返 回 值： 整数
=0，成功
=-1，变量名不存在
=-2，报警对象类型不正确，如报警对象类型为字符串
实 例： 构件方法.控件0.SetAlarmObject(报警变量)
8.18.5 构件属性
Name、Left、Top、Width、Height、Focus、Visible 属性参考8.2节。报警浏览的Width和Height属性为只读。
StartRow
属性意义：设置或获取报警浏览显示的起始行号
属性类型：浮点数。
读写属性：读写
注意事项：起始行号从序号0开始，写入值<0或写入值>总行数时无效
RowCount
属性意义：获取报警信息的总条数
属性类型：浮点数。
读写属性：只读
8.18.6 构件事件
构件事件参考8.2节。
昆仑通态触摸屏技术问题
