> Template screen item object

The following objects are directly related to the templatescreenitem API.

Template screen item

The template screen item object defines an element displayed on a template screen. It has the following properties.

PropertyTypeDescription
screenitemidstring(readonly) ID of the template screen item.
resourceid
(required)
stringID of the object from the parent template displayed on the template screen item. Depending on the type of screen item, the resourceid property can reference different objects. Unused by clock and URL template screen items.

Note: the resourceid property always references an object used in the parent template object, even if the screen item itself is inherited on a host or template.
resourcetype
(required)
integerType of template screen item.

Possible values:
0 - graph;
1 - simple graph;
3 - plain text;
7 - clock;
11 - URL;
19 - simple graph prototype;
20 - graph prototype.
screenid
(required)
stringID of the template screen that the item belongs to.
colspanintegerNumber of columns the template screen item will span across.

Default: 1.
elementsintegerNumber of lines to display on the template screen item.

Default: 25.
halignintegerSpecifies how the template screen item must be aligned horizontally in the cell.

Possible values:
0 - (default) center;
1 - left;
2 - right.
heightintegerHeight of the template screen item in pixels.

Default: 200.
max_columnsintegerSpecifies the maximum amount of columns a graph prototype or simple graph prototype screen element can have.

Default: 3.
rowspanintegerNumber or rows the template screen item will span across.

Default: 1.
styleintegerTemplate screen item display option.

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.
urlstringURL of the webpage to be displayed in the template screen item. Used by URL template screen items.
valignintegerSpecifies how the template screen item must be aligned vertically in the cell.

Possible values:
0 - (default) middle;
1 - top;
2 - bottom.
widthintegerWidth of the template screen item in pixels.

Default: 320.
xintegerX-coordinates of the template screen item on the screen, from left to right.

Default: 0.
yintegerY-coordinates of the template screen item on the screen, from top to bottom.

Default: 0.