CheckBox Object

  • Article
FormField
CheckBox

Represents a single check box form field.

Using the CheckBox Object

Use FormFields(index), where index is index number or the bookmark name associated with the check box, to return a single FormField object. Use the CheckBox property with the FormField object to return a CheckBox object. The following example selects the check box form field named "Check1" in the active document.

ActiveDocument.FormFields("Check1").CheckBox.Value = True

The index number represents the position of the form field in the FormFields collection. The following example checks the type of the first form field; if it's a check box, the check box is selected.

If ActiveDocument.FormFields(1).Type = wdFieldFormCheckBox Then
    ActiveDocument.FormFields(1).CheckBox.Value = True
End If

The following example determines whether the ffield object is valid before changing the check box size to 14 points.

Set ffield = ActiveDocument.FormFields(1).CheckBox
If ffield.Valid = True Then 
    ffield.AutoSize = False
    ffield.Size = 14
Else
    MsgBox "First field is not a check box"
End If

Use the Add method with the FormFields object to add a check box form field. The following example adds a check box at the beginning of the active document, sets the name to "Color", and then selects the check box.

With ActiveDocument.FormFields.Add(Range:=ActiveDocument.Range _
    (Start:=0,End:=0), Type:=wdFieldFormCheckBox)
    .Name = "Color"
    .CheckBox.Value = True
End With

Properties | Application Property | AutoSize Property | Creator Property | Default Property | Parent Property | Size Property | Valid Property | Value Property

Parent Objects | FormField Object

Child Objects

See Also | DropDown Object | TextInput Object