ZLine

(Engine-Level Function)

Description:	Draws a line between given x and y coordinates in a window.
Returns:	Nothing
Usage:	Steady State only.
Function Groups:	Graphics
Related to:	GUIPolygon | Line
Format:	ZLine(X1, Y1, X2, Y2, Pen)
Parameters:

X1, Y1

Required. Any numeric expressions for the X and Y coordinates of the first endpoint of the line.

X2, Y2

Required. Any numeric expressions for the X and Y coordinates of the second endpoint of the line.

Pen

Required. Any expression that returns the PEN object to use to draw the line. A color value is also acceptable here, which may be any of the following: An RGB string in the form, "<RRGGBB>" A Constants for System Colors A VTScada Color Palette number from the palette. -1 (transparent)

Comments:

Although this is a layered graphic, it cannot be edited using the Idea Studio. It is for use within text mode editing only.

Example:

  ZLine(0, 0 { First endpoint for line },
        799, 599 { Second endpoint for line }, 
        14 { Line is yellow }); 

This statement draws a yellow line diagonally from the upper left corner to the lower right corner of the window.