ClickCheckBoxWithText
Description:
Click a CheckBox on the current Document that has Text matching the specified Text.
Format:
ClickCheckBoxWithText (integer Session ID (optional), string Text, integer Occurrence (optional))
|
Parameters: |
Integer |
Session ID (optional) |
Browser Occurrence Number.
First Browser occurrence is 1
Default value is 1 |
|
String |
Text |
Text displayed on the CheckBox.
Wildcards ('*') are allowed |
|
Integer |
Occurrence (optional) |
CheckBox Occurrence Number.
First CheckBox occurrence is 1
Default value is 1 |
|
Return Value: |
Boolean |
Success Ind |
Success Indicator.
TRUE – Link was clicked
FALSE – Link was not clicked |
Usage:
Use this function to click on a CheckBox displaying the specified Text on the current Document. Text is what is displayed on the CheckBox not the internal HTML Name. Wildcards can be specified in the Text string to match on partial displayed Text on the CheckBox. The wildcard character is the asterisk ('*') and can be used on the beginning and/or end of the Text string. Use the optional CheckBox Occurrence Number when more than one CheckBox on the Document matches the Text string. Matches are not Case Sensitive.
Example 1:
Click on a CheckBox that displays the word 'Accept'.
Click
CheckBoxWithText ('Accept')
Example 2:
Click on the second CheckBox that displays the word 'Select'.
Click
CheckBoxWithText ('Select', 2)
Example 3:
Click on the second CheckBox that displays the word 'Delete' anywhere on the CheckBox text.
Click
CheckBoxWithText ('*Delete*', 2)
Example 4:
Click on the third CheckBox that displays the word 'Delete' at the beginning of the CheckBox text in the second occurrence of the Browser.
Click
CheckBoxWithText (2, 'Delete*', 3)
Example 5:
Click each CheckBox on a Document that displays the words 'Details'.
integer int
CheckBoxNum
intCheckBoxNum = 1
While ClickCheckBoxWithText ('Details', intCheckBoxNum)
intCheckBoxNum = intCheckBoxNum + 1
EndWhile