This property 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.

Description

Check box, toggle button and switch controls can be in the checked or unchecked state. Use the wState property to specify the current state of a control.

Declaration

TestObj.wState

Read-Write Property

Integer

TestObj

A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section

Applies To

The property is applied to the following objects:

Android Checkbox, Android Switch, Android ToggleButton and 2 more objects, iOS Switch, Xamarin.Forms Switch « Collapse the list

View Mode

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

Property Value

The wState property can have one of the following values:

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

Example

The example below demonstrates how you can obtain and change the wState property of the check box:

JavaScript, JScript

function Test()
{
  var p, Checkbox

  // Select the Android device
  Mobile.SetCurrent("MyDevice");

  // Obtain the CheckBox object
  p = Mobile.Device().Process("com.example.myapp");
  Checkbox = p.RootLayout("").Layout("layoutTop").Layout("layout1").CheckBox("check1");

  // Record the checkbox state to the log
  Log.Message(Checkbox.wState);

  // Change the chechbox state to "Checked"
  Checkbox.wState = cbChecked;
}

Python

def Test():
  # Select the Android device
  Mobile.SetCurrent("MyDevice")

  # Obtain the CheckBox object
  p = Mobile.Device().Process("com.example.myapp")
  Checkbox = p.RootLayout("").Layout("layoutTop").Layout("layout1").CheckBox("check1")
  
  # Record the checkbox state to the log
  Log.Message(Checkbox.wState)
  
  # Change the chechbox state to "Checked"
  Checkbox.wState = cbChecked

VBScript

Sub Test
  Dim p, Checkbox

  ' Select the Android device
  Mobile.SetCurrent("MyDevice")

  ' Obtain the CheckBox object
  Set p = Mobile.Device.Process("com.example.myapp")
  Set Checkbox = p.RootLayout("").Layout("layoutTop").Layout("layout1").CheckBox("check1")

  ' Record the checkbox state to the log
  Log.Message(Checkbox.wState)

  ' Change the chechbox state to "Checked"
  Checkbox.wState = cbChecked
End Sub

DelphiScript

procedure Test;
  var p, Checkbox;
begin
  // Select the Android device
  Mobile.SetCurrent('MyDevice');

  // Obtain the CheckBox object
  p := Mobile.Device.Process('com.example.myapp');
  Checkbox := p.RootLayout('').Layout('layoutTop').Layout('layout1').CheckBox('check1');

  // Record the checkbox state to the log
  Log.Message(Checkbox.wState);

  // Change the chechbox state to 'Checked'
  Checkbox.wState := cbChecked;
end;