Working With Check Box Controls in Web Applications

1. Add the On-Screen Action operation to your keyword test. TestComplete will show the Operation Parameters wizard.

2. In the wizard, specify the check box you want to select or clear. You can do it by pointing to the check box on the web page.

3. Select the check box object’s method to call. To simulate selecting or clearing a check box, use the ClickChecked method.

4. To select or clear the check box, set the method’s parameter to True or False respectively.

5. Click Finish to add the operation and close the wizard.

Click the image to enlarge it.

To simulate selecting or clearing a check box, use the WebCheckBoxObj.ClickChecked(Checked) method.

The script sample below shows how to simulate selecting a check box on a web page:

def Sample_Select_CheckBox():
  url = "https://services.smartbear.com/samples/TestComplete15/smartstore/login"
  Browsers.Item[btChrome].Run(url)

  cb = Sys.Browser().Page(url).FindElement("#RememberMe")

  # Select the Remember me check box
  cb.ClickChecked(True)

def Sample_Select_CheckBox():
  url = "https://services.smartbear.com/samples/TestComplete15/smartstore/login"
  Browsers.Item[btChrome].Run(url)

  PropNames = ["ObjectType", "ObjectIdentifier"]
  PropValues = ["Checkbox", "RememberMe"]

  cb = Sys.Browser().Page(url).FindChildEx(PropNames, PropValues, 15, True);

  # Select the Remember me check box
  cb.ClickChecked(True)

In keyword tests, to get the check box state and perform various actions depending on the result, you can use the If … Then and Else operations:

1. Add the If … Then operation to your test.

2. Specify the condition that will get the check box state and compare it against the expected value. For example:

   1. In the Value 1 column of the Operation Parameters dialog, click the ellipsis button.

   2. In the resulting Edit Value dialog, set the mode to Object Property.

   3. Set the value to Onscreen Object.

   4. Point to the check box on the web page.

   5. To get the check box state, select the checked property or the attributes property, and then the value attribute. Which property to use depends on the check box implementation.

   6. Click OK to close the dialog.

   7. In the Value 2 column, enter the baseline value against which the check box state will be compared: true for selected and false for cleared.

   8. Click OK to save the changes and close the Operation Parameters dialog.

3. To specify operations to run if the check box has the expected state, add them as child items of the If … Then operation.

4. To make the operation run otherwise, add the Else operation right after the If … Then operation, and then add the needed operations as child items of the Else operation.

Click the image to enlarge it.

To get the state of a check box in script tests, you can use properties of the Web Check Box object. For example, you can use the checked property provided by a web browser or you can use the value attribute of the underlying web element, depending on the check box implementation. The following code sample shows how you can get the state of a check box:

def Sample_CheckBox_State():
  url = "https://services.smartbear.com/samples/TestComplete15/smartstore/login"
  Browsers.Item[btChrome].Run(url)

  cb = Sys.Browser().Page(url).FindElement("#RememberMe")

  # Check if the Remember me check box is selected
  if (cb.checked):
    Log.Message("The Remember me check box is selected.")
  else:
    Log.Message("The Remember me check box is cleared.")

def Sample_CheckBox_State():
  url = "https://services.smartbear.com/samples/TestComplete15/smartstore/login"
  Browsers.Item[btChrome].Run(url)

  PropNames = ["ObjectType", "ObjectIdentifier"]
  PropValues = ["Checkbox", "RememberMe"]

  cb = Sys.Browser().Page(url).FindChildEx(PropNames, PropValues, 15, True);

  # Check if the Remember me check box is selected
  if (cb.checked):
    Log.Message("The Remember me check box is selected.")
  else:
    Log.Message("The Remember me check box is cleared.")