<< Click to Display Table of Contents >> CheckBox (object)

Access paths:

▪Application à Documents à Item à FormFields à Item à CheckBox

▪Application à ActiveDocument à FormFields à Item à CheckBox

 1  Description

A CheckBox object represents one individual form object of the type CheckBox and allows you to retrieve and change its value.

CheckBox is a child object of FormField.

 2  Access to the object

The CheckBox object can be accessed solely through its parent object FormField.

Only if the property CheckBox.Valid returns the value True, the form object really represents a check box – and not a text field or a drop-down list.

An example:

' Check the type of the first form object.

' If it is a CheckBox object,

' output its value (True or False).

 

If tm.ActiveDocument.FormFields(1).CheckBox.Valid Then

 MsgBox tm.ActiveDocument.FormFields(1).CheckBox.Value

End If

 3  Properties, objects, collections and methods

Properties:

▪Value (default property)

▪Text

▪Valid R/O

 

Objects:

▪Application → Application

▪Parent → FormField

Value (property)

Data type: Boolean

Gets or sets the property whether the check box is checked or not (True or False).

Text (property)

Data type: String

Gets or sets the text of the check box.

Valid (property, R/O)

Data type: Boolean

Returns False if the object is not a CheckBox object.

Application (pointer to object)

Data type: Object

Returns the Application object.

Parent (pointer to object)

Data type: Object

Returns the parent object, i.e. an object of the type FormField.