Check Action (CheckItem Objects)

Applies to TestComplete 15.64, last modified on May 16, 2024


The Check action moves the mouse pointer to the item and sets its state (checked, unchecked or grayed) depending on the State parameter.



TestObj A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section
State [in]    Required    Variant    
Result None

Applies To

The method is applied to the following object:

View Mode

To view this method in the Object Browser panel and in other panels and dialogs, activate the Advanced view mode.


The method has the following parameter:


Specifies whether the item is to be checked or unchecked. Possible values are:

Value Description
cbUnchecked, False or 0 The item is unchecked.
cbChecked, True or 1 The item is checked.
cbGrayed or 2 The item is switched to grayed (indeterminate) state.

Result Value



If the specified item was clicked, but its state did not changed, CheckItem posts a warning message to the test log.

See Also

Click Action (ClickItem and CheckItem Objects)

Highlight search results