This method is not supported in web tests (including cross-platform web tests) that use XPath expressions and CSS selectors to locate web elements. This method can be only used in tests that locate web objects by using internal identification properties provided by TestComplete.

Description

The ClickButton action moves the mouse pointer to a check box, and then sets its state according to the State parameter.

Declaration

TestObj.ClickButton(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.

Parameters

The method has the following parameter:

State

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.
`cbGrayed` or `2`	The control is grayed. The following controls do not support this value: The following controls do not support this value:The following controls do not support this value: Bootstrap Checkbox Bootstrap Toogle Button Ext JS Toggle Button Ext JS Checkbox Field Java Swing CheckBox JavaFX ToggleButton jQuery Mobile Checkbox jQuery Mobile FlipSwitch Oracle Forms Checkbox Telerik RadCheckBox for WinForms Telerik RadToggleButton for WinForms YUI 2 Checkbox Button

If the control does not support the indeterminate state, ClickButton(2) fails and posts an error message to the test log.

Result Value

None.

Remarks

If the State parameter corresponds to the control's state (for example, State is cbChecked and the control is already checked), ClickButton performs no action and reports in the test log that the operation was executed successfully. To toggle the control without moving the mouse pointer, use wState.

Example

To view an example that demonstrates how to use the ClickButton method, see Selecting and Clearing Check Boxes in Desktop Windows Applications.

ClickButton Action (CheckBox and ToggleButton Controls)