Table of Contents
> 对象
The following objects are directly related to the screenitem API. 以下类直接关联到screenitem API.
Screen item 聚合类型项
The screen item object defines an element displayed on a screen. It has the following properties. 聚合类型项定义一个展示元素在聚合图形上，他拥有以下属性
| Property | Type | Description |
|---|---|---|
| screenitemid | string | (readonly) ID of the screen item. (只读) 聚合图形项的ID |
| resourcetype (required) |
integer | Type of screen item. Possible values: 0 - graph; 1 - simple graph; 2 - map; 3 - plain text; 4 - hosts info; 5 - triggers info; 6 - system information; 7 - clock; 8 - screen; 9 - triggers overview 10 - data overview; 11 - URL; 12 - history of actions; 13 - history of events; 14 - latest host group issues; 15 - problems by severity; 16 - latest host issues; 19 - simple graph prototype; 20 - graph prototype. 聚合图形项的类型 可能的值：0 - 图形; 1 - 简图; 2 -拓扑图; 3 -纯文本; 4 -主机信息; 5 -触发信息;6 -系统信息; 7 -时钟; 8 -聚合图形; 9 -触发概览 10 -资料概览; 11 - URL; 12 -动作日志; 13 -历史事件; 14 -最新的主机组问题; 15 -严重程度的问题; 16 -最新的主机问题; 19 -简易图形原型; 20 -图形原型。 |
| screenid (required) |
string | ID of the screen that the item belongs to. 监控项所属聚合图形的id |
| application | string | Application or part of application name by which data in screen item can be filtered. Applies to resource types: "Data overview" and "Triggers overview". 应用程序或应用程序名称的一部分，通过它可以过滤聚合图形项中的数据。适用于资源类型: "Data overview" and "Triggers overview". |
| colspan | integer | Number of columns the screen item will span across. Default: 1. 屏幕项将跨越的列数。 \\默认：1 |
| dynamic | integer | Whether the screen item is dynamic. Possible values: 0 - (default) not dynamic; 1 - dynamic. 聚合图形项是否是动态的 可能的值： 0 - (默认) 不是动态的 1 - 动态的 |
| elements | integer | Number of lines to display on the screen item. Default: 25. 每行可以展示聚合图像项的个数。 默认：25 |
| halign | integer | Specifies how the screen item must be aligned horizontally in the cell. Possible values: 0 - (default) center; 1 - left; 2 - right. 指定聚合图形项必须在单元格中水平对齐的方式。 可能的值：0 - (default) 中心 ；1 - 左边 ；2 - 右边 |
| height | integer | Height of the screen item in pixels. Default: 200. 聚合图像项的高度，单位是像素 默认：200 |
| max_columns | integer | Specifies the maximum amount of columns a graph prototype or simple graph prototype screen element can have. Default: 3. 指定图形原型或简单图形原型聚合图形元素可以拥有的最大列数。 默认：200 |
| resourceid | string | ID of the object displayed on the screen item. Depending on the type of a screen item, the resourceid property can reference different objects.Required for data overview, graph, map, plain text, screen, simple graph and trigger overview screen items. Unused by local and server time clocks, history of actions, history of events, hosts info, system information, problems by severity and URL screen items. 显示在屏幕项上的对象的ID。根据屏幕项目的类型， resourceid属性可以引用不同的对象。关于数据概述、图表、拓扑图、纯文本、屏幕、简单图形和触发器概述屏幕项目的要求。不使用本地和服务器时间时钟、操作历史、事件历史、主机信息、系统信息、严重程度问题和URL屏幕项。 |
| rowspan | integer | Number or rows the screen item will span across. Default: 1. 数字或行将跨越聚合图形项。 默认：1 |
| sort_triggers | integer | Order in which actions or triggers must be sorted. Possible values for history of actions screen elements: 3 - time, ascending; 4 - time, descending; 5 - type, ascending; 6 - type, descending; 7 - status, ascending; 8 - status, descending; 9 - retries left, ascending; 10 - retries left, descending; 11 - recipient, ascending; 12 - recipient, descending. Possible values for latest host group issues and latest host issues screen items: 0 - (default) last change, descending; 1 - severity, descending; 2 - host, ascending. 操作或触发器必须排序。 \\拓扑图元素历史记录的可能值: 3 - 时间，上升的 4 - 时间，下降的 5 - 类型，上升的 6- 类型，下降的 7 - 状态，升序 8 - 状态，降序 9 -重试，升序 10 - 重试，降序 11-接受者，升序 12-接受者，降序 最新主机组问题和最新主机问题聚合图形项的可能值: 0 - （默认） 最后修改，降序 1 - 级别，降序 2 - 主机，升序 |
| style | integer | Screen item display option. Possible values for data overview and triggers overview screen items: 0 - (default) display hosts on the left side; 1 - display hosts on the top. Possible values for hosts info and triggers info screen elements: 0 - (default) horizontal layout; 1 - vertical layout. Possible values for clock screen items: 0 - (default) local time; 1 - server time; 2 - host time. Possible values for plain text screen items: 0 - (default) display values as plain text; 1 - display values as HTML. 聚合图形项展示操作 可能的数据概述和触发概述聚合图形项目: 0-(默认)显示主机在左边 1-显示主机在顶部 可能的主机信息和触发器信息聚合图形的值： 0-(默认) 水平布局 1-垂直布局 时钟聚合图形项可能的值： 0 - （默认） 本地时间 1 - server时间 2 - 主机时间 纯文本聚合图形项目的可能值: 0-（默认） 显示纯文本信息的值 1-显示HTML的值 |
| url | string | URL of the webpage to be displayed in the screen item. Used by URL screen items. 将显示在聚合图形项中的网页的URL。用于URL屏幕项。 |
| valign | integer | Specifies how the screen item must be aligned vertically in the cell. Possible values: 0 - (default) middle; 1 - top; 2 - bottom. 指定聚合图形项必须在单元格中垂直对齐的方式。 \\可能的值： 0-(默认)中间 1-顶部 2-底部 |
| width | integer | Width of the screen item in pixels. Default: 320. 聚合图形项的宽度，单位是像素 默认是：320 |
| x | integer | X-coordinates of the screen item on the screen, from left to right. Default: 0. 屏幕上的屏幕项的x坐标，从左到右。 默认：0 |
| y | integer | Y-coordinates of the screen item on the screen, from top to bottom. Default: 0. 屏幕上的屏幕项的y坐标，从左到右。 默认：0 |