CheckBox Dialog Item Definition

Syntax CheckBox X, Y, DX, DY, Title$, .Field[, Options]

Group User Dialog

Description Define a checkbox item.

Parameter Description

X This number value is the distance from the left edge of the dialog box. It is measured in 1/8 ths of the average character width for the dialog's font.

Y This number value is the distance from the top edge of the dialog box. It is measured in 1/12 ths of the character height for the dialog's font.

DX This number value is the width. It is measured in 1/8 ths of the average character width for the dialog's font.

DY This number value is the height. It is measured in 1/12 ths of the character height for the dialog's font.

Field The value of the check box is accessed via this field. Unchecked is 0, checked is 1 and grayed is 2.

Options This numeric value controls the type of check box. Choose one value from following table. (If this numeric value omitted then zero is used.)

Option Description

0 Check box is either check or unchecked.

1 Check box is either check, unchecked or grayed, and it switches between checked and unchecked when clicked.

2 Check box is either check, unchecked or grayed, and it cycles through all three states as the button is clicked.

See Also Begin Dialog.

Example            '#Language "WWB-COM"
Sub Main
    Begin Dialog UserDialog 200,120
        Text 10,10,180,15,"Please push the OK button"
        CheckBox 10,25,180,15,"&Check box",.Check
        OKButton 80,90,40,20
    End Dialog
    Dim dlg As UserDialog
    dlg.Check = 1
    Dialog dlg ' show dialog (wait for ok)
    Debug.Print dlg.Check
EndSub