A rectangle with a caption.

Syntax

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

<oRef>

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

<container>

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

<name expC>

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

Properties

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

Property

Default

Description

baseClassName

RECTANGLE

Identifies the object as an instance of the Rectangle class

border

true

Whether the Rectangle object’s rectangle is visible

borderStyle

Default

Specifies the rectangle style (0=Default, 1=Raised, 2=Lowered, 3=None, 4=Single, 5=Double, 6=Drop Shadow, 7=Client, 8=Modal, 9=Etched In, 10=Etched Out)

className

(RECTANGLE)

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

colorNormal

BtnText/BtnFace

The color of the caption and the rectangle fill

patternStyle

Solid

The fill pattern style (0=Solid, 1=BDiagonal, 2=Cross, 3=Diagcross, 4=FDiagonal, 5=Horizontal, 6=Vertical)

text

<same as name>

The text caption that appears at the top right of the rectangle

 

transparent

false

Determines if the interior of rectangle is, or is not, transparent.

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

Property

 

Event

 

Method

before
borderStyle

dragEffect

fontBold

fontItalic

fontName

fontSize

fontStrikeout

fontUnderline

form

height

hWnd
left

mousePointer

name

pageno

parent

printable

speedTip

systemTheme
top

visible

width

onDesignOpen
onDragBegin

onLeftDblClick

onLeftMouseDown

onLeftMouseUp

onMiddleDblClick

onMiddleMouseDown
onMiddleMouseUp

onMouseMove

onOpen

onRightDblClick

onRightMouseDown

onRightMouseUp

drag( )
move( )

release( )

Description

Use a Rectangle object to enclose an area of a form. For example, you can use a Rectangle object to draw a border around a group of related objects, such as a group of RadioButtons.

To assign a label that describes the group of objects, use the text property. The label appears in the top left corner of the rectangle.

A Rectangle object does not affect other objects. The user can't give focus to the Rectangle object, and it doesn't display or modify data.