class CheckBox

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.

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

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 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.