A check box on a form.

Syntax

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

<oRef>

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

<container>

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

<name expC>

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

Properties

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

Property

Default

Description

baseClassName

CHECKBOX

Identifies the object as an instance of the CheckBox class

className

(CHECKBOX)

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 checkbox’s text label

dataLink

 

The Field object that is linked to the CheckBox

group

 

The group to which the check box belongs

text

<same as name>

The text label that appears beside the check box

textLeft

false

Whether the check box’s text label appears to the left or to the right of the check box

transparent

false

Whether the CheckBox object has the same background color or image as its container

value

 

The current value of the check box (true or false)

 

Event

Parameters

Description

onChange

 

After the check box is toggled

 

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

Property

 

Event

 

Method

before
borderStyle

dragEffect

enabled

fontBold

fontItalic

fontName

fontSize

fontStrikeout

fontUnderline

form

height

helpFile

helpId

hWnd

id
left

mousePointer

name

pageno

parent

printable

speedTip

statusMessage

systemTheme
tabStop

top

visible

width

onDesignOpen
onDragBegin

onGotFocus

onHelp

onLeftDblClick

onLeftMouseDown

onLeftMouseUp

onLostFocus

onMiddleDblClick

onMiddleMouseDown
onMiddleMouseUp

onMouseMove

onOpen

onRightDblClick

onRightMouseDown

onRightMouseUp

when

drag( )
move( )

release( )

setFocus( )

Description

Use a CheckBox component to represent a true/false value.