A simple colored geometric shape.

Syntax

[<oRef> =] new Shape(<container> [,<name expC>])

<oRef>

A variable or property—typically of <container>—in which to store a reference to the newly created Shape object.

<container>

The container—typically a Form object—to which you’re binding the Shape object.

<name expC>

An optional name for the Shape object. If not specified, the Shape class will auto-generate a name for the object.

Properties

The following tables list the properties of interest of the Shape class. (No particular events or methods are associated with this class.)

Property

Default

Description

baseClassName

SHAPE

Identifies the object as an instance of the Shape class

className

(SHAPE)

Identifies the object as an instance of a custom class. When no custom class exists, defaults to baseClassName

colorNormal

WindowText
/Window

The pen and fill color of the shape

drawMode

0 - Normal

An enumerated property used to create visual effects using the pen and fill color of the shape, and the color of the underlying object. See drawMode for details.

penStyle

Solid

The pen style used to draw the outline of the shape (0=Solid, 1=Dash, 2=Dot, 3=DashDot, 4=DashDotDot)

penWidth

1

Width of the outline in pixels

shapeStyle

Circle

The type of shape to draw (0=Round Rectangle, 1=Rectangle, 2=Ellipse, 3=Circle, 4=Round square, 5=Square)

 

The following table lists the common properties, events, and methods of the Shape class:

Property

 

Event

Method

before
dragEffect

form

height

left

name

pageno
parent

printable

top

visible

width

beforeRelease
canRender

onClose
onDesignOpen
onDragBegin
onOpen
onRender

drag( )
move( )

release( )

Description

Use a Shape object to draw a basic geometric shape on a form.

A Shape has no hWnd because it is drawn on the surface of the form; it is not a genuine Windows control. Despite its position in the form’s z-order, a Shape can never be drawn on top of another component (other than a Line or Shape).