public class ComboBox extends GenericObject
| Modifier | Constructor and Description |
|---|---|
protected |
ComboBox(java.lang.String compname) |
|
ComboBox(java.lang.String winname,
java.lang.String compname)
Constructor
Create an instance of pseudo-component representing
a specific component in a specific window.
|
|
ComboBox(Window window,
java.lang.String compname)
Constructor
Create an instance of pseudo-component representing
a specific component in a specific window.
|
| Modifier and Type | Method and Description |
|---|---|
void |
captureItemsToFile(StepTestTable table,
java.lang.String[] parameters)
Capture Items To a File specified (if not abs, then to test dir)
Capture Items To a File specified (if not abs, then to test dir)
|
void |
captureItemsToFile(StepTestTable table,
java.lang.String fileName,
java.lang.String fileEncoding)
Capture Items To a File specified (if not abs, then to test dir)
Capture Items To a File specified (if not abs, then to test dir)
|
ComponentFunction |
captureItemsToFile(java.lang.String[] parameters)
Capture Items To a File specified (if not abs, then to test dir)
Capture Items To a File specified (if not abs, then to test dir)
|
ComponentFunction |
captureItemsToFile(java.lang.String fileName,
java.lang.String fileEncoding)
Capture Items To a File specified (if not abs, then to test dir)
Capture Items To a File specified (if not abs, then to test dir)
|
ComponentFunction |
click()
Attempts to perform a standard Click on the ComboBox
Attempts to perform a standard Click on the ComboBox.
|
void |
click(StepTestTable table)
Attempts to perform a standard Click on the ComboBox
Attempts to perform a standard Click on the ComboBox.
|
ComponentFunction |
hideList()
Hide the combo box list (equivalent to an ESC or two ESCs).
|
void |
hideList(StepTestTable table)
Hide the combo box list (equivalent to an ESC or two ESCs).
|
void |
select(StepTestTable table,
java.lang.String[] parameters)
Select an item by its text value from a combobox.
|
void |
select(StepTestTable table,
java.lang.String textValue,
java.lang.String forceRefresh)
Select an item by its text value from a combobox.
|
ComponentFunction |
select(java.lang.String[] parameters)
Select an item by its text value from a combobox.
|
ComponentFunction |
select(java.lang.String textValue,
java.lang.String forceRefresh)
Select an item by its text value from a combobox.
|
void |
selectIndex(StepTestTable table,
java.lang.String[] parameters)
Select an item by its index from a combobox.
|
void |
selectIndex(StepTestTable table,
java.lang.String indexValue,
java.lang.String forceRefresh)
Select an item by its index from a combobox.
|
ComponentFunction |
selectIndex(java.lang.String[] parameters)
Select an item by its index from a combobox.
|
ComponentFunction |
selectIndex(java.lang.String indexValue,
java.lang.String forceRefresh)
Select an item by its index from a combobox.
|
void |
selectPartialMatch(StepTestTable table,
java.lang.String[] parameters)
Select an item via a partial text match in a combobox.
|
void |
selectPartialMatch(StepTestTable table,
java.lang.String textValue,
java.lang.String forceRefresh)
Select an item via a partial text match in a combobox.
|
ComponentFunction |
selectPartialMatch(java.lang.String[] parameters)
Select an item via a partial text match in a combobox.
|
ComponentFunction |
selectPartialMatch(java.lang.String textValue,
java.lang.String forceRefresh)
Select an item via a partial text match in a combobox.
|
void |
selectUnverified(StepTestTable table,
java.lang.String[] parameters)
Select an item by its text value from a combobox without verifying the
selection.
|
void |
selectUnverified(StepTestTable table,
java.lang.String textValue,
java.lang.String forceRefresh)
Select an item by its text value from a combobox without verifying the
selection.
|
ComponentFunction |
selectUnverified(java.lang.String[] parameters)
Select an item by its text value from a combobox without verifying the
selection.
|
ComponentFunction |
selectUnverified(java.lang.String textValue,
java.lang.String forceRefresh)
Select an item by its text value from a combobox without verifying the
selection.
|
void |
selectUnverifiedPartialMatch(StepTestTable table,
java.lang.String[] parameters)
Select an item via a partial text match in a combobox without verification.
|
void |
selectUnverifiedPartialMatch(StepTestTable table,
java.lang.String textValue,
java.lang.String forceRefresh)
Select an item via a partial text match in a combobox without verification.
|
ComponentFunction |
selectUnverifiedPartialMatch(java.lang.String[] parameters)
Select an item via a partial text match in a combobox without verification.
|
ComponentFunction |
selectUnverifiedPartialMatch(java.lang.String textValue,
java.lang.String forceRefresh)
Select an item via a partial text match in a combobox without verification.
|
void |
setTextValue(StepTestTable table,
java.lang.String textValue)
Set the text of the combobox
This action sets the text of the combobox.
|
ComponentFunction |
setTextValue(java.lang.String textValue)
Set the text of the combobox
This action sets the text of the combobox.
|
void |
setUnverifiedTextValue(StepTestTable table,
java.lang.String textValue)
Set the text of the combobox without verification
This action sets the text of the combobox.
|
ComponentFunction |
setUnverifiedTextValue(java.lang.String textValue)
Set the text of the combobox without verification
This action sets the text of the combobox.
|
ComponentFunction |
showList()
Show the combo box list (expose it).
|
void |
showList(StepTestTable table)
Show the combo box list (expose it).
|
void |
verifySelected(StepTestTable table,
java.lang.String textValue)
Verify Selected item is equal to specified parameter
Verify Selected item is equal to specified parameter
|
ComponentFunction |
verifySelected(java.lang.String textValue)
Verify Selected item is equal to specified parameter
Verify Selected item is equal to specified parameter
|
altLeftDrag, altLeftDrag, click, click, click, click, clickScreenImage, clickScreenImage, clickScreenLocation, clickScreenLocation, clickScreenPoint, clickScreenPoint, compareStoredData, compareStoredData, compareStoredData, compareStoredData, compareStoredProperties, compareStoredProperties, compareStoredProperties, compareStoredProperties, ctrlAltLeftDrag, ctrlAltLeftDrag, ctrlClick, ctrlClick, ctrlClick, ctrlClick, ctrlClickScreenImage, ctrlClickScreenImage, ctrlLeftDrag, ctrlLeftDrag, ctrlRightClick, ctrlRightClick, ctrlRightClick, ctrlRightClick, ctrlRightClickScreenImage, ctrlRightClickScreenImage, ctrlShiftLeftDrag, ctrlShiftLeftDrag, doubleClick, doubleClick, doubleClick, doubleClick, doubleClickScreenImage, doubleClickScreenImage, doubleClickScreenLocation, doubleClickScreenLocation, doubleClickScreenPoint, doubleClickScreenPoint, doubleTap, doubleTap, dragTo, dragTo, dragTo, dragTo, flick, flick, flick, flick, flickDown, flickDown, flickLeft, flickLeft, flickRight, flickRight, flickUp, flickUp, hScrollTo, hScrollTo, javaMenuSelect, javaMenuSelect, leftDrag, leftDrag, mouseClick, mouseClick, multiClick, multiClick, multiClick, multiClick, multiClickScreenImage, multiClickScreenImage, multiClickScreenImage, multiClickScreenImage, press, press, rightClick, rightClick, rightClick, rightClick, rightClickScreenImage, rightClickScreenImage, rightClickScreenLocation, rightClickScreenLocation, rightClickScreenPoint, rightClickScreenPoint, rightDrag, rightDrag, shiftClick, shiftClick, shiftClick, shiftClick, shiftClickScreenImage, shiftClickScreenImage, shiftLeftDrag, shiftLeftDrag, tap, tap, twoFingerTap, twoFingerTap, verifyImage, verifyImage, vScrollTo, vScrollToassignPropertyVariable, assignPropertyVariable, assignPropertyVariable, assignPropertyVariable, captureObjectDataToFile, captureObjectDataToFile, captureObjectDataToFile, captureObjectDataToFile, capturePropertiesToFile, capturePropertiesToFile, capturePropertiesToFile, capturePropertiesToFile, capturePropertyToFile, capturePropertyToFile, capturePropertyToFile, capturePropertyToFile, clearAppMapCache, clearAppMapCache, clearCache, clearCache, executeScript, executeScript, executeScript, executeScript, getComputedStyle, getComputedStyle, getGUIImage, getGUIImage, getGUIImage, getGUIImage, getTextFromGUI, getTextFromGUI, getTextFromGUI, getTextFromGUI, gUIDoesExist, gUIDoesExist, gUIDoesNotExist, gUIDoesNotExist, hoverMouse, hoverMouse, hoverMouse, hoverMouse, hoverScreenLocation, hoverScreenLocation, hoverScreenLocation, hoverScreenLocation, inputCharacters, inputCharacters, inputKeys, inputKeys, isPropertyExist, isPropertyExist, isPropertyExist, isPropertyExist, locateScreenImage, locateScreenImage, locateScreenImage, locateScreenImage, saveTextFromGUI, saveTextFromGUI, saveTextFromGUI, saveTextFromGUI, sendEvent, sendEvent, sendEvent, sendEvent, setPropertyValue, setPropertyValue, setPropertyValue, setPropertyValue, showOnPage, showOnPage, typeChars, typeChars, typeEncryption, typeEncryption, typeEncryption, typeEncryption, typeKeys, typeKeys, verifyArrayPropertyToFile, verifyArrayPropertyToFile, verifyArrayPropertyToFile, verifyArrayPropertyToFile, verifyBinaryFileToFile, verifyBinaryFileToFile, verifyBinaryFileToFile, verifyBinaryFileToFile, verifyClipboardToFile, verifyClipboardToFile, verifyClipboardToFile, verifyClipboardToFile, verifyClipboardVP, verifyClipboardVP, verifyComputedStyle, verifyComputedStyle, verifyFileToFile, verifyFileToFile, verifyFileToFile, verifyFileToFile, verifyGUIImageToFile, verifyGUIImageToFile, verifyGUIImageToFile, verifyGUIImageToFile, verifyObjectDataToFile, verifyObjectDataToFile, verifyObjectDataToFile, verifyObjectDataToFile, verifyPropertiesSubsetToFile, verifyPropertiesSubsetToFile, verifyPropertiesSubsetToFile, verifyPropertiesSubsetToFile, verifyPropertiesToFile, verifyPropertiesToFile, verifyPropertiesToFile, verifyPropertiesToFile, verifyProperty, verifyProperty, verifyProperty, verifyProperty, verifyPropertyContains, verifyPropertyContains, verifyPropertyContains, verifyPropertyContains, verifyPropertyToFile, verifyPropertyToFile, verifyPropertyToFile, verifyPropertyToFile, verifyTabOrder, verifyTabOrder, verifyTextFileToFile, verifyTextFileToFile, verifyTextFileToFile, verifyTextFileToFile, verifyValueContains, verifyValueContains, verifyValueContains, verifyValueContains, verifyValueContainsIgnoreCase, verifyValueContainsIgnoreCase, verifyValueContainsIgnoreCase, verifyValueContainsIgnoreCase, verifyValueDoesNotContain, verifyValueDoesNotContain, verifyValueDoesNotContain, verifyValueDoesNotContain, verifyValues, verifyValues, verifyValues, verifyValues, verifyValuesIgnoreCase, verifyValuesIgnoreCase, verifyValuesIgnoreCase, verifyValuesIgnoreCase, verifyValuesNotEqual, verifyValuesNotEqual, verifyValuesNotEqual, verifyValuesNotEqualgetWindow, setWindowgetName, getParent, getParentName, quotepublic ComboBox(Window window, java.lang.String compname)
window - Optional:NO
Specifies which Window this component is 'in'.compname - Optional:NO
Specifies the AppMap name of the component in the Window.public ComboBox(java.lang.String winname,
java.lang.String compname)
winname - Optional:NO
Specifies the AppMap name of the window.compname - Optional:NO
Specifies the AppMap name of the component in the Window.protected ComboBox(java.lang.String compname)
public ComponentFunction captureItemsToFile(java.lang.String fileName, java.lang.String fileEncoding)
Capture Items To a File specified (if not abs, then to test dir)
Capture Items To a File specified (if not abs, then to test dir)
Supporting Engines:
fileName - Optional:NO
File name (if not absolute, then to test dir)fileEncoding - Optional:YES DefaultVal:
Specify a character encoding to be used when saving data to a file.
If it is not specified, the system default file encoding will be used.
The encoding should be a valid string supported by Java; if it is
not valid, the system default file encoding will be used instead.public void captureItemsToFile(StepTestTable table, java.lang.String fileName, java.lang.String fileEncoding)
Capture Items To a File specified (if not abs, then to test dir)
Capture Items To a File specified (if not abs, then to test dir)
Supporting Engines:
table - Optional:NO
The table to add the record to.fileName - Optional:NO
File name (if not absolute, then to test dir)fileEncoding - Optional:YES DefaultVal:
Specify a character encoding to be used when saving data to a file.
If it is not specified, the system default file encoding will be used.
The encoding should be a valid string supported by Java; if it is
not valid, the system default file encoding will be used instead.public ComponentFunction captureItemsToFile(java.lang.String[] parameters)
Capture Items To a File specified (if not abs, then to test dir)
Capture Items To a File specified (if not abs, then to test dir)
Supporting Engines:
parameters - Optional:NO
An array containing the following parameters:
public void captureItemsToFile(StepTestTable table, java.lang.String[] parameters)
Capture Items To a File specified (if not abs, then to test dir)
Capture Items To a File specified (if not abs, then to test dir)
Supporting Engines:
table - Optional:NO
The table to add the record to.parameters - Optional:NO
An array containing the following parameters:
public ComponentFunction click()
Attempts to perform a standard Click on the ComboBox
Attempts to perform a standard Click on the ComboBox. If
the combobox list is not exposed then this will expose the list of items.
If the list is already exposed, then this will close the list.
It must be noted that when you expose the list in a ComboBox, it is
no longer a ComboBox. It typically converts to a ComboListBox. This may
not be an issue on controls that Robot can recognize with a NAME=method.
However, if the control is recognized by ObjectIndex or some other means
then the original ComboBox may no longer be found on the screen.
With this scenario, you need to reference the ComboBox and the
ComboListBox in the application map (and associated data files) as two separate
items.
To avoid these potential problems, use the COMBOBOX 'SELECT' command
to actually open the list and select the item all with a single command.
Supporting Engines:
public void click(StepTestTable table)
Attempts to perform a standard Click on the ComboBox
Attempts to perform a standard Click on the ComboBox. If
the combobox list is not exposed then this will expose the list of items.
If the list is already exposed, then this will close the list.
It must be noted that when you expose the list in a ComboBox, it is
no longer a ComboBox. It typically converts to a ComboListBox. This may
not be an issue on controls that Robot can recognize with a NAME=method.
However, if the control is recognized by ObjectIndex or some other means
then the original ComboBox may no longer be found on the screen.
With this scenario, you need to reference the ComboBox and the
ComboListBox in the application map (and associated data files) as two separate
items.
To avoid these potential problems, use the COMBOBOX 'SELECT' command
to actually open the list and select the item all with a single command.
Supporting Engines:
table - Optional:NO
The table to add the record to.public ComponentFunction hideList()
Hide the combo box list (equivalent to an ESC or two ESCs).
hide the list. This would only be necessary in cases
where the state of the combo box is not known ahead of time.
Supporting Engines:
public void hideList(StepTestTable table)
Hide the combo box list (equivalent to an ESC or two ESCs).
hide the list. This would only be necessary in cases
where the state of the combo box is not known ahead of time.
Supporting Engines:
table - Optional:NO
The table to add the record to.public ComponentFunction select(java.lang.String textValue, java.lang.String forceRefresh)
Select an item by its text value from a combobox.
Select an item by its text value from a combobox.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the list.
The routine will first attempt to see if the item exists in the list
and should provide a warning if it cannot find the item or cannot
read the list of items. The routine will then attempt the selection.
After the selection is attempted, the routine tries to verify that the
list has the specified item as the selected item. A warning will be
issued if the routine cannot read the list. A failure will be issued
if the routine CAN read the list and determines that the specified
item is NOT the currently selected item.
Note: RobotJ also uses identical keyword SelectTextItem
Supporting Engines:
textValue - Optional:NO
The case-sensitive item in the drop down list to select.forceRefresh - Optional:Yes
Force refreshing to update stale element after selection.public void select(StepTestTable table, java.lang.String textValue, java.lang.String forceRefresh)
Select an item by its text value from a combobox.
Select an item by its text value from a combobox.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the list.
The routine will first attempt to see if the item exists in the list
and should provide a warning if it cannot find the item or cannot
read the list of items. The routine will then attempt the selection.
After the selection is attempted, the routine tries to verify that the
list has the specified item as the selected item. A warning will be
issued if the routine cannot read the list. A failure will be issued
if the routine CAN read the list and determines that the specified
item is NOT the currently selected item.
Note: RobotJ also uses identical keyword SelectTextItem
Supporting Engines:
table - Optional:NO
The table to add the record to.textValue - Optional:NO
The case-sensitive item in the drop down list to select.forceRefresh - Optional:Yes
Force refreshing to update stale element after selection.public ComponentFunction select(java.lang.String[] parameters)
Select an item by its text value from a combobox.
Select an item by its text value from a combobox.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the list.
The routine will first attempt to see if the item exists in the list
and should provide a warning if it cannot find the item or cannot
read the list of items. The routine will then attempt the selection.
After the selection is attempted, the routine tries to verify that the
list has the specified item as the selected item. A warning will be
issued if the routine cannot read the list. A failure will be issued
if the routine CAN read the list and determines that the specified
item is NOT the currently selected item.
Note: RobotJ also uses identical keyword SelectTextItem
Supporting Engines:
parameters - Optional:NO
An array containing the following parameters:
public void select(StepTestTable table, java.lang.String[] parameters)
Select an item by its text value from a combobox.
Select an item by its text value from a combobox.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the list.
The routine will first attempt to see if the item exists in the list
and should provide a warning if it cannot find the item or cannot
read the list of items. The routine will then attempt the selection.
After the selection is attempted, the routine tries to verify that the
list has the specified item as the selected item. A warning will be
issued if the routine cannot read the list. A failure will be issued
if the routine CAN read the list and determines that the specified
item is NOT the currently selected item.
Note: RobotJ also uses identical keyword SelectTextItem
Supporting Engines:
table - Optional:NO
The table to add the record to.parameters - Optional:NO
An array containing the following parameters:
public ComponentFunction selectIndex(java.lang.String indexValue, java.lang.String forceRefresh)
Select an item by its index from a combobox.
Select an item by its index from a combobox.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of the item from the list.
The routine will first attempt to see if the index exists in the list
and should provide a warning if it cannot find the item or cannot
read the list of items. The routine will then attempt the selection.
Supporting Engines:
indexValue - Optional:NO
The item index in the drop down list to select.forceRefresh - Optional:Yes
Force refreshing to update stale element after selection.public void selectIndex(StepTestTable table, java.lang.String indexValue, java.lang.String forceRefresh)
Select an item by its index from a combobox.
Select an item by its index from a combobox.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of the item from the list.
The routine will first attempt to see if the index exists in the list
and should provide a warning if it cannot find the item or cannot
read the list of items. The routine will then attempt the selection.
Supporting Engines:
table - Optional:NO
The table to add the record to.indexValue - Optional:NO
The item index in the drop down list to select.forceRefresh - Optional:Yes
Force refreshing to update stale element after selection.public ComponentFunction selectIndex(java.lang.String[] parameters)
Select an item by its index from a combobox.
Select an item by its index from a combobox.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of the item from the list.
The routine will first attempt to see if the index exists in the list
and should provide a warning if it cannot find the item or cannot
read the list of items. The routine will then attempt the selection.
Supporting Engines:
parameters - Optional:NO
An array containing the following parameters:
public void selectIndex(StepTestTable table, java.lang.String[] parameters)
Select an item by its index from a combobox.
Select an item by its index from a combobox.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of the item from the list.
The routine will first attempt to see if the index exists in the list
and should provide a warning if it cannot find the item or cannot
read the list of items. The routine will then attempt the selection.
Supporting Engines:
table - Optional:NO
The table to add the record to.parameters - Optional:NO
An array containing the following parameters:
public ComponentFunction selectPartialMatch(java.lang.String textValue, java.lang.String forceRefresh)
Select an item via a partial text match in a combobox.
Select an item via a partial text match in a combobox.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the
list.
The routine will first attempt to see if the item exists in the list
and should provide a warning if it cannot find the item or cannot
read the list of items. The routine will then attempt the selection.
After the selection is attempted, the routine tries to verify that the
list has the specified item as the selected item. A warning will be
issued if the routine cannot read the list. A failure will be issued
if the routine CAN read the list and determines that the specified
item is NOT the currently selected item.
Supporting Engines:
textValue - Optional:NO
The case-sensitive substring of an item in the drop down list to select.forceRefresh - Optional:Yes
Force refreshing to update stale element after selection.public void selectPartialMatch(StepTestTable table, java.lang.String textValue, java.lang.String forceRefresh)
Select an item via a partial text match in a combobox.
Select an item via a partial text match in a combobox.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the
list.
The routine will first attempt to see if the item exists in the list
and should provide a warning if it cannot find the item or cannot
read the list of items. The routine will then attempt the selection.
After the selection is attempted, the routine tries to verify that the
list has the specified item as the selected item. A warning will be
issued if the routine cannot read the list. A failure will be issued
if the routine CAN read the list and determines that the specified
item is NOT the currently selected item.
Supporting Engines:
table - Optional:NO
The table to add the record to.textValue - Optional:NO
The case-sensitive substring of an item in the drop down list to select.forceRefresh - Optional:Yes
Force refreshing to update stale element after selection.public ComponentFunction selectPartialMatch(java.lang.String[] parameters)
Select an item via a partial text match in a combobox.
Select an item via a partial text match in a combobox.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the
list.
The routine will first attempt to see if the item exists in the list
and should provide a warning if it cannot find the item or cannot
read the list of items. The routine will then attempt the selection.
After the selection is attempted, the routine tries to verify that the
list has the specified item as the selected item. A warning will be
issued if the routine cannot read the list. A failure will be issued
if the routine CAN read the list and determines that the specified
item is NOT the currently selected item.
Supporting Engines:
parameters - Optional:NO
An array containing the following parameters:
public void selectPartialMatch(StepTestTable table, java.lang.String[] parameters)
Select an item via a partial text match in a combobox.
Select an item via a partial text match in a combobox.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the
list.
The routine will first attempt to see if the item exists in the list
and should provide a warning if it cannot find the item or cannot
read the list of items. The routine will then attempt the selection.
After the selection is attempted, the routine tries to verify that the
list has the specified item as the selected item. A warning will be
issued if the routine cannot read the list. A failure will be issued
if the routine CAN read the list and determines that the specified
item is NOT the currently selected item.
Supporting Engines:
table - Optional:NO
The table to add the record to.parameters - Optional:NO
An array containing the following parameters:
public ComponentFunction selectUnverified(java.lang.String textValue, java.lang.String forceRefresh)
Select an item by its text value from a combobox without verifying the
selection.
Select an item by its text value from a combobox without
verifying the selection.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the list.
The routine will simply take the specified text and attempt the
selection.
it will not verify the existence of the item before the attempt, nor
will it verify the item is actually selected after the
attempt.
Note: RobotJ also uses identical keyword SelectUnverifiedTextItem
Supporting Engines:
textValue - Optional:NO
The case-sensitive item in the drop down list to select.forceRefresh - Optional:Yes
Force refreshing to update stale element after selection.public void selectUnverified(StepTestTable table, java.lang.String textValue, java.lang.String forceRefresh)
Select an item by its text value from a combobox without verifying the
selection.
Select an item by its text value from a combobox without
verifying the selection.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the list.
The routine will simply take the specified text and attempt the
selection.
it will not verify the existence of the item before the attempt, nor
will it verify the item is actually selected after the
attempt.
Note: RobotJ also uses identical keyword SelectUnverifiedTextItem
Supporting Engines:
table - Optional:NO
The table to add the record to.textValue - Optional:NO
The case-sensitive item in the drop down list to select.forceRefresh - Optional:Yes
Force refreshing to update stale element after selection.public ComponentFunction selectUnverified(java.lang.String[] parameters)
Select an item by its text value from a combobox without verifying the
selection.
Select an item by its text value from a combobox without
verifying the selection.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the list.
The routine will simply take the specified text and attempt the
selection.
it will not verify the existence of the item before the attempt, nor
will it verify the item is actually selected after the
attempt.
Note: RobotJ also uses identical keyword SelectUnverifiedTextItem
Supporting Engines:
parameters - Optional:NO
An array containing the following parameters:
public void selectUnverified(StepTestTable table, java.lang.String[] parameters)
Select an item by its text value from a combobox without verifying the
selection.
Select an item by its text value from a combobox without
verifying the selection.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the list.
The routine will simply take the specified text and attempt the
selection.
it will not verify the existence of the item before the attempt, nor
will it verify the item is actually selected after the
attempt.
Note: RobotJ also uses identical keyword SelectUnverifiedTextItem
Supporting Engines:
table - Optional:NO
The table to add the record to.parameters - Optional:NO
An array containing the following parameters:
public ComponentFunction selectUnverifiedPartialMatch(java.lang.String textValue, java.lang.String forceRefresh)
Select an item via a partial text match in a combobox without verification.
Select an item via a partial text match in a combobox without verification.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the list.
The routine will first attempt to see if the item exists in the list
and should provide a warning if it cannot find the item or
cannot read the list of items. The routine will then attempt the selection.
The routine will not verify the selected-item matches the parameter partial-text.
Supporting Engines:
textValue - Optional:NO
The case-sensitive substring of an item in the drop down list to select.forceRefresh - Optional:Yes
Force refreshing to update stale element after selection.public void selectUnverifiedPartialMatch(StepTestTable table, java.lang.String textValue, java.lang.String forceRefresh)
Select an item via a partial text match in a combobox without verification.
Select an item via a partial text match in a combobox without verification.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the list.
The routine will first attempt to see if the item exists in the list
and should provide a warning if it cannot find the item or
cannot read the list of items. The routine will then attempt the selection.
The routine will not verify the selected-item matches the parameter partial-text.
Supporting Engines:
table - Optional:NO
The table to add the record to.textValue - Optional:NO
The case-sensitive substring of an item in the drop down list to select.forceRefresh - Optional:Yes
Force refreshing to update stale element after selection.public ComponentFunction selectUnverifiedPartialMatch(java.lang.String[] parameters)
Select an item via a partial text match in a combobox without verification.
Select an item via a partial text match in a combobox without verification.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the list.
The routine will first attempt to see if the item exists in the list
and should provide a warning if it cannot find the item or
cannot read the list of items. The routine will then attempt the selection.
The routine will not verify the selected-item matches the parameter partial-text.
Supporting Engines:
parameters - Optional:NO
An array containing the following parameters:
public void selectUnverifiedPartialMatch(StepTestTable table, java.lang.String[] parameters)
Select an item via a partial text match in a combobox without verification.
Select an item via a partial text match in a combobox without verification.
This method combines the initial Click required to expose the list
of items and then the subsequent selection of a text item from the list.
The routine will first attempt to see if the item exists in the list
and should provide a warning if it cannot find the item or
cannot read the list of items. The routine will then attempt the selection.
The routine will not verify the selected-item matches the parameter partial-text.
Supporting Engines:
table - Optional:NO
The table to add the record to.parameters - Optional:NO
An array containing the following parameters:
public ComponentFunction setTextValue(java.lang.String textValue)
Set the text of the combobox
This action sets the text of the combobox. This version allows
the use of special character combinations and substrings to identify
specific keyboard keys. These are the same special characters and interpretation
used for Robot's InputKeys command and the Windows Scripting Host.
~^+%{( are primarily the characters that induce special processing.
The routine verifies we can read the text property, sets the text value
and will verify that the property has been set to that value *IF* none
of the special characters exist in the provided text value. If those
special characters exist, then no post-set verification will occur.
Supporting Engines:
textValue - Optional:YES DefaultVal:
The text that will be typed into the ComboBox.public void setTextValue(StepTestTable table, java.lang.String textValue)
Set the text of the combobox
This action sets the text of the combobox. This version allows
the use of special character combinations and substrings to identify
specific keyboard keys. These are the same special characters and interpretation
used for Robot's InputKeys command and the Windows Scripting Host.
~^+%{( are primarily the characters that induce special processing.
The routine verifies we can read the text property, sets the text value
and will verify that the property has been set to that value *IF* none
of the special characters exist in the provided text value. If those
special characters exist, then no post-set verification will occur.
Supporting Engines:
table - Optional:NO
The table to add the record to.textValue - Optional:YES DefaultVal:
The text that will be typed into the ComboBox.public ComponentFunction setUnverifiedTextValue(java.lang.String textValue)
Set the text of the combobox without verification
This action sets the text of the combobox. This version allows
the use of special character combinations and substrings to identify
specific keyboard keys. These are the same special characters and interpretation
used for Robot's InputKeys command and the Windows Scripting Host.
~^+%{( are primarily the characters that induce special processing.
The routine verifies we can read the text property, sets the text value
but does not verify that the property has been set to that value
whether or not any of the special characters exist in the provided text value.
Supporting Engines:
textValue - Optional:YES DefaultVal:
The text that will be typed into the ComboBox.public void setUnverifiedTextValue(StepTestTable table, java.lang.String textValue)
Set the text of the combobox without verification
This action sets the text of the combobox. This version allows
the use of special character combinations and substrings to identify
specific keyboard keys. These are the same special characters and interpretation
used for Robot's InputKeys command and the Windows Scripting Host.
~^+%{( are primarily the characters that induce special processing.
The routine verifies we can read the text property, sets the text value
but does not verify that the property has been set to that value
whether or not any of the special characters exist in the provided text value.
Supporting Engines:
table - Optional:NO
The table to add the record to.textValue - Optional:YES DefaultVal:
The text that will be typed into the ComboBox.public ComponentFunction showList()
Show the combo box list (expose it).
show the list so that the next step can be a click
on an item. This would only be necessary in cases
where the state of the combo box is not known ahead
of time.
Supporting Engines:
public void showList(StepTestTable table)
Show the combo box list (expose it).
show the list so that the next step can be a click
on an item. This would only be necessary in cases
where the state of the combo box is not known ahead
of time.
Supporting Engines:
table - Optional:NO
The table to add the record to.public ComponentFunction verifySelected(java.lang.String textValue)
Verify Selected item is equal to specified parameter
Verify Selected item is equal to specified parameter
Supporting Engines:
textValue - Optional:NO
The case-sensitive substring to compare.public void verifySelected(StepTestTable table, java.lang.String textValue)
Verify Selected item is equal to specified parameter
Verify Selected item is equal to specified parameter
Supporting Engines:
table - Optional:NO
The table to add the record to.textValue - Optional:NO
The case-sensitive substring to compare.Copyright © SAS Institute. All Rights Reserved.