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
[[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. |
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 |