DrawOval Method

Draws an ellipse. Returns an instance of the Shape object which corresponds to the drawn shape or the shape in which the ellipse was built.

Applies to: Page object, Shape object

Syntax

[[Set] shapeRet =] object.DrawOval ( xLeft, yTop, xRight, yBottom )

The DrawOval method syntax has these parts:

Part Description
object Required. An expression that returns an instance of an object from the Applies to list.
xLeft Required. An expression that returns a Double value. It represents the X-coordinate of the top left corner of the rectangle circumscribing the ellipse.
yTop Required. An expression that returns a Double value. It represents the Y-coordinate of the top left corner of the rectangle circumscribing the ellipse.
xRight Required. An expression that returns a Double value. It represents the X-coordinate of the bottom right corner of the rectangle circumscribing the ellipse.
yBottom Required. An expression that returns a Double value. It represents the Y-coordinate of the bottom right corner of the rectangle circumscribing the ellipse.
shapeRet Optional. A Shape type variable.

Remarks

The ellipse is drawn by the specified coordinates of the rectangle, circumscribing the ellipse. The sides of the rectangle are equal to the diameters of the ellipse.

If object is a page or a group, the DrawOval method creates on that page or group a shape containing a geometry that describes the ellipse with the specified size and coordinates. Then it returns an instance of the Shape object, that corresponds to the created shape. If the DrawOval method was called after the BeginShape method, it adds a geometry describing the ellipse to the current Basic shape. Then it returns an instance of the Shape object, that corresponds to the current Basic shape of the page or group.

If object is a simple shape, the DrawOval method draws the ellipse in this shape and returns object.

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 coordinates are measured in the internal units (InternalUnit).

 

See Also

BeginShape method, DrawLine method, DrawRect method, DrawSector method, EndShape method