Class

OvalShape


Description

Used for drawing two-dimensional ellipses in a vector graphics environment.

Methods

Name

Parameters

Returns

Shared

Contains

X As Double, Y As Double

Boolean

Property descriptions


OvalShape.BorderColor

BorderColor As Color

The color of the object's border.


OvalShape.BorderOpacity

BorderOpacity As Double

Indicates the level of opacity.

Degrees of transparency is currently supported only on macOS and Windows. On other platforms, the border is either visible (100%) or invisible.

The following code adds a border to an OvalShape:

Var a As New OvalShape
a.Height = 100
a.BorderOpacity = 100
a.FillColor = Color.Red
g.DrawObject(a)

OvalShape.BorderWidth

BorderWidth As Double

The width of the border, in points. The default is 1.

The width a Double value with a default of 1.0.


OvalShape.FillColor

FillColor As Color

The color of the interior of the shape.


OvalShape.FillOpacity

FillOpacity As Double

The opacity of the interior, from 0 (completely transparent) to 100 (opaque).

This example sets the Fill to 50% opacity.

Var a As New OvalShape
a.Height = 100
a.FillOpacity = 50
a.FillColor = Color.Red
g.DrawObject(a)

OvalShape.Height

Height As Double

The height of the oval.

This example sets the height and width of the shape to 150 pixels.

Var r As New OvalShape
r.Width = 150
r.Height = 150
r.Border = 100
r.BorderColor = Color.Black
r.FillColor = Color.Teal
r.BorderWidth = 2.5
r.Rotation = -0.78
g.DrawObject(r)

OvalShape.Rotation

Rotation As Double

Clockwise rotation, in radians, around the X, Y point. Only set the rotation after you have drawn all your objects.

This code rotates the OvalShape 0.9 radians.

Var a As New OvalShape
a.Height = 150
a.Width = 150
a.Rotation = 0.90
g.DrawObject(a)

OvalShape.Scale

Scale As Double

The scaling factor relative to the object's original size.

The following code rescales the arc by a factor of 1.5.

Var a As New OvalShape
a.Height = 100
a.Scale = 1.5
g.DrawObject(a)

OvalShape.Segments

Segments As Integer

The number of polygon sides to use when approximation is needed. Zero means it's up to the renderer.

This example specifies the number of segments to use.

Var o As New OvalShape
o.Width = 60
o.Height = 120
o.Segments = 5
o.FillColor = Color.Red
g.DrawObject(o, o.Width, o.Height)

OvalShape.Width

Width As Double

The width of the oval.

This example sets the Width to 150 pixels.

Var r As New OvalShape
r.Width = 150
r.Height = 150
r.Border = 100
r.BorderColor = Color.Black
r.FillColor = Color.Teal
r.BorderWidth = 2.5
r.Rotation = -0.78
g.DrawObject(r)

OvalShape.X

X As Double

The horizontal position of the center or main anchor point.

This example sets the horizontal position to 100 pixels from the left of the containing Canvas.

Var a As New OvalShape
a.Height = 150
a.Width = 150
a.X = 100
g.DrawObject(a)

OvalShape.Y

Y As Double

The vertical position (down from top) position of the center or anchor point.

This example moves the position of the OvalShape down 100 pixels from the top of the containing Canvas.

Var a As New OvalShape
a.Height = 150
a.Width = 150
a.Y = 100
g.DrawObject(a)

Method descriptions


OvalShape.Contains

Contains(X As Double, Y As Double) As Boolean

Tests whether the object contains the point X, Y. Returns True if the oval contains the point specified by X, Y.

This code tests whether the OvalShape contains the passed point:

Var r As New OvalShape
r.Width = 75
r.Height = 75
r.Border = 100
r.BorderColor = Color.RGB(0, 0, 0) ' black
r.FillColor = Color.RGB(0, 127, 127) ' teal
r.BorderWidth = 2.5
r.Rotation = -0.78
If r.Contains(50, 50) Then
  ' draw something here..
End If
g.DrawObject(r)

Sample code

Place the following method in the Paint event handler of a Window. It will draw an oval in the window whenever it updates:

Var o As New OvalShape
o.Width = 60
o.Height = 120

o.FillColor = Color.RGB(127, 127, 255)
g.DrawObject(o, o.Width, o.Height)

Compatibility

Desktop and web project types on all supported operating systems.