pltIDrawControl DrawLine

Draws a line.

Syntax

pltIDrawControl_handle DrawLine x1, y1, x2, y2, style, width, color

Application

Tcl Modify

Description

Returns 0 = HW_Success or 3 = HW_InvalidHandle.

Inputs

x1
X-coordinate of the line’s starting point.
y1
Y-coordinate of the line’s starting point.
x2
X-coordinate of the line’s endpoint.
y2
Y-coordinate of the line’s endpoint.
style
The index of the style to be used (must be non-negative).
width
The width to be used (must be non-negative).
color
The index of the color to be used (must be non-negative).

Example

To draw a line from (-1, 1) to (7, 4) with a style index of 1, a width of 3, and a color index of 2:
hwi GetSessionHandle mySessionName
mySessionName GetProjectHandle myProjectName
myProjectName GetPageHandle myPageName
myPageName GetWindowHandle myWindowName
myWindowName GetClientHandle myPlotName
myPlotName GetDrawControlHandle myDrawer
myDrawer DrawLine -1 1 7 4 1 3 2

Errors

None.