index    previous    next
 
check_frame

CHECK_FRAME

The CHECK_FRAME control is used to bind together CHECKBOXs and RADIO_BUTTONs on a form. The CHECK_FRAME must be used even when there is only one CHECKBOX or RADIO_BUTTON on the form.

Several CHECK_FRAMES can be placed on a single form. Each CHECK_FRAME defines a seperate and distinct group. CHECKBOXs and RADIO_BUTTONs can be mixed on a single CHECK_FRAME.

The CHECK_FRAME has a log function associated with it. When any of the CHECKBOXs or RADIO_BUTTONs in the CHECK_FRAME has its value changed due to user interaction, the CHECK_FRAME log function is invoked with the new value of the CHECK_FRAME (the bitwise OR of all the values of all selected CHECKBOXs and RADIO_BUTTONs).

The actual patern of selected and deselected CHECKBOXs and RADIO_BUTTONs will depend on the truth value assigned to each CHECKBOX and RADIO_BUTTON in the group.

The programmer refers to the log function as the "log_func". It can be set via the "log_func_name" property in the "check frame control" dialog.

Using checkboxs, radio_buttons and check_frames