DrawCircle Method

Description

Creates a circle or ellipse on a document to be printed.

Syntax

Visual Basic
Public Sub DrawCircle( _ ByVal X As Single, _ ByVal Y As Single, _ ByVal Radius As Single, _ ByVal penColor As OLE_COLOR, _ ByVal Aspect As Single _ )

Parameters

X: Single-precision value indicating the x coordinate for the center point of the circle or ellipse.
Y: Single-precision value indicating the y coordinate for the center point of the circle or ellipse.
Radius: Single-precision value indicating the radius of the circle or ellipse.
penColor: Long integer value indicating the RGB color of the circle’s outline. You can use the Visual Basic RGB function or QBColor function to specify the color.
Aspect: Single-precision value indicating the aspect ratio of the circle. The value 1.0 yields a perfect (non-elliptical) circle on any screen.

Remarks

The coordinates of the center point must be within the physical area of the printed page.

To fill a circle, set the FillColor and FillStyle properties of the object on which the circle or ellipse is drawn.

The width of the line used to draw the circle or ellipse depends on the setting of the DrawWidth property.

The way the circle is drawn on the background depends on the setting of the DrawMode and DrawStyle properties.

You can omit an argument in the middle of the syntax, but you must include the argument’s comma before including the next argument. If you omit an optional argument, omit the comma following the last argument you specify.

If a printer has not been selected or a document has not been started, the DrawCircle method will select the default printer and start a new document. When DrawCircle executes, the CurrentX and CurrentY properties are set to the center point of the circle or ellipse.