CheckButton Action (Mobile Controls)

Applies to TestComplete 15.63, last modified on April 10, 2024
This method is available in legacy mobile tests that work with devices connected to the local computer. To learn how to simulate user actions in newer cloud-compatible mobile tests, see the Simulating user actions in tests section.


Simulates a series of touches, which put the control into the desired state.



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 objects:

View Mode

This method is available in the Object Browser panel and in other panels and dialogs in both Basic and Advanced view modes.


The method has the following parameter:


Specifies the state of the control.

Possible values:

Value Description
cbChecked, True or 1 The control is checked.
cbUnchecked, False or 0 The control is unchecked.

Result Value



To view an example that demonstrates how to use the CheckButton method, see Selecting and Clearing Check Boxes.

See Also

Testing Android Applications (Legacy)
Selecting and Clearing Check Boxes
Changing Switch State
Changing Toggle Button State
Touch Action (Mobile Objects)

Highlight search results