DrawLine Method

Draws a line. Returns an instance of the Shape object that corresponds to the created shape.

Applies to: Page object, Shape object

Syntax

[[Set] shapeRet =] object.DrawLine ( xBegin, yBegin, xEnd, yEnd )

The DrawLine method syntax has these parts:

Part Description
object Required. An expression that returns an instance of an object from the Applies to list.
xBegin Required. An expression that returns a Double value, representing the X-coordinate of the line's begin point.

yBegin

Required. An expression that returns a Double value, representing the Y-coordinate of the line's begin point.
xEnd Required. An expression that returns a Double value, representing the X-coordinate of the line's end point.
yEnd Required. An expression that returns a Double value, representing the Y-coordinate of the line's end point.
shapeRet Optional. A Shape type variable.

Remarks

If object is a page or a group, the DrawLine method draws the shape on the page or in the group. In the shape it adds a new geometry that describes the line with the specified coordinates. Then it returns an instance of the Shape object that corresponds to the new shape. If DrawLine was called after the BeginShape method, it adds a new geometry to the current Basic shape and then returns an instance of the Shape object, corresponding to that shape.

If object is a simple shape (not a group), the DrawLine method draws a line in this shape and returnsobject.

The coordinates of the points are specified in the coordinate system of the shape, group or page to which the instance of object corresponds. The unit of measure for the coordinates are the internal units (InternalUnit).

 

See Also

BeginShape method, DrawOval method, DrawRect method, DrawSector method, EndShape method, LineTo method