Class
OvalShape
Description
Used for drawing two-dimensional ellipses in a vector graphics environment.
Properties
Name |
Type |
Read-Only |
Shared |
---|---|---|---|
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.
See also
RectShape parent class; ArcShape, CurveShape, FigureShape, FolderItem, Group2D, Graphics, Picture, PixmapShape, RoundRectShape, TextShape classes.