OptionButton

Object List Hierarchy Next Object

Definition:

An OptionButton displays an on/off choice. OptionButtons are often used as part of a group of choices from which a user can select only one.

Icon:

images/Phx00207.gif

Specialized Features:

The following table lists and describes the properties added by OptionButton. There are no added methods or events.

Properties Use to...

Ctrl3d Enable the 3-D effects for the Control.

Value Check or read the state of the OptionButton control.

Events Use to...

Click Perform an action when the user presses and releases a mouse button while on an object, or when the value of a control is changed in code.

DblClick Perform an action when the user presses and releases a mouse button twice in rapid succession over an object.

GotFocus Define what occurs when an object is given the focus.

KeyDown Define what occurs when the user presses a key while an object has the focus.

KeyPress Define what occurs when the user presses and releases an ANSI key.

KeyUp Define what occurs when the user releases a key while an object has the focus.

LostFocus Define what occurs when an object loses the focus.

Copied Features:

images/Phx00208.gif Properties images/Phx00209.gif Methods images/Phx00210.gif Events

Details:

An OptionButton includes a small circle and descriptive text. If the button is selected, it is filled with a smaller, solid circle. You can draw these option buttons directly on the form or group them visually by using a frame.

Option buttons are often grouped by function to present a user with several sets of mutually-exclusive choices. To create two or more option button groups, draw all the option buttons you would like in the first group in sequential order, then break this sequence by drawing another control (such as a frame). Finally, resume drawing option buttons to create the second group. Each time you "break" a sequence of option buttons by drawing another type of object, then resume drawing another sequence of option buttons, you create a new group.

A user can only select one OptionButton from a particular group, meaning other option buttons in the group are automatically cancelled as a result. CheckBoxes also present a user with choices, however, selecting a CheckBox has no effect on the other CheckBoxes. This allows you to select as many CheckBoxes as you like.