org.safs.selenium.webdriver

Class CFComboBox

java.lang.Object

org.safs.Processor

org.safs.ComponentFunction

org.safs.selenium.webdriver.CFComponent

org.safs.selenium.webdriver.CFComboBox

All Implemented Interfaces:

ITestRecordStackable, RuntimeDataInterface

public class CFComboBox
extends CFComponent

Nested Class Summary

Nested classes/interfaces inherited from class org.safs.ComponentFunction

ComponentFunction.Window

Field Summary

Fields

Modifier and Type	Field and Description
protected ComboBox	combobox
static java.lang.String	LIBRARY_NAME "ComboBox"

Fields inherited from class org.safs.selenium.webdriver.CFComponent

compObject, DEFAULT_MAX_RETRY_ENTER, INDENT_MARK, libComponent, libComponentCache, ready, SAFS_JAVASCRIPT_RESULT, waiter, wdHelper, wdUtils, winObject

Fields inherited from class org.safs.ComponentFunction

action, ALTCLICK, ALTLEFTDRAG, altText, ASSIGNPROPERTYVARIABLE, CAPTUREOBJECTDATATOFILE, CAPTUREPROPERTIESTOFILE, CAPTUREPROPERTYTOFILE, CLEARAPPMAPCACHE, CLICK, CLOSEWINDOW, compName, COMPONENTCLICK, CTRLALTLEFTDRAG, CTRLCLICK, CTRLLEFTDRAG, CTRLRIGHTCLICK, CTRLSHIFTLEFTDRAG, DOUBLECLICK, GETGUIIMAGE, GETTEXTFROMGUI, GUIDOESEXIST, GUIDOESNOTEXIST, HOVERMOUSE, HSCROLLTO, INPUTCHARACTERS, INPUTKEYS, ISPROPERTYEXIST, iterator, LEFTDRAG, LOCATESCREENIMAGE, mapname, MAXIMIZE, MINIMIZE, MOUSECLICK, OBJECT_DATA, PARAM_FILTER, PARAM_UUID, PROPERTY_DOT_itemText, PROPERTY_innerHTML, PROPERTY_innerText, PROPERTY_Items, PROPERTY_text, PROPERTY_textContent, RELATIVE_TO_PARENT, RELATIVE_TO_SCREEN, RESTORE, RIGHTCLICK, RIGHTDRAG, SAVETEXTFROMGUI, SELECTMENUITEM, SELECTMENUITEMCONTAINS, SENDEVENT, SETPOSITION, SETPROPERTYVALUE, SHIFTCLICK, SHIFTLEFTDRAG, TEST_DATA_SUFFIX, utils, VERIFYARRAYPROPERTYTOFILE, VERIFYBINARYFILETOFILE, VERIFYCLIPBOARDTOFILE, VERIFYFILETOFILE, VERIFYGUIIMAGETOFILE, VERIFYMENUITEM, VERIFYMENUITEMCONTAINS, VERIFYOBJECTDATATOFILE, VERIFYPROPERTY, VERIFYPROPERTYCONTAINS, VERIFYPROPERTYTOFILE, VERIFYTEXTFILETOFILE, VERIFYVALUECONTAINS, VERIFYVALUEEQUALS, VERIFYVALUES, VERIFYVALUESIGNORECASE, VSCROLLTO, WAITFORGUI, windowName

Fields inherited from class org.safs.Processor

breakpointsOn, CASE_INSENSITIVE_FLAG, CASEINSENSITIVE_FLAG, clearProxiesAlways, commandLineBreakpoint, customStr, customText, DEBUG_MESSAGE, debugStr, debugText, DEFAULT_CUSTOM_PROCESSOR_PACKAGE, DEFAULT_CUSTOM_PROCESSOR_SUBPACKAGE, DEFAULT_PROCESSOR_PACKAGE, FAILED_MESSAGE, FAILED_OK_MESSAGE, failedStr, failedText, FAILURE_DETAIL, GENERIC_MESSAGE, genericStr, genericText, LINE_FAILURE_4, log, myBreakpointsOn, otherStr, otherText, PARAM_SIZE_1, PARAM_SIZE_2, PARAM_SIZE_3, PARAM_SIZE_4, params, PASSED_MESSAGE, passedStr, passedText, PRE_TXT_SUCCESS_4, PRE_TXT_SUCCESS_5, processorConfigSet, processorMap, recordProcessed, RECTYPE_DRIVER_COMMAND, RECTYPE_DRIVER_COMMAND_F, RECTYPE_DRIVER_COMMAND_W, RECTYPE_TEST_STEP, RECTYPE_TEST_STEP_F, RECTYPE_TEST_STEP_W, RFSMCache, RFSMOnly, RFT_FIND_SEARCH_MODE_ALGORITHM, RFT_FIND_SEARCH_MODE_CACHE, SAFS_CLEARPROXIESALWAYS_ITEM, SAFS_COMMANDLINEBREAKPOINT_ITEM, SAFS_COMMANDLINEBREAKPOINT_VARIABLE, SAFS_PARAMS_FILE, SAFS_RESBUN_NAME, SAFS_SECSWAITFORCOMPONENT_ITEM, SAFS_SECSWAITFORCOMPONENT_VARIABLE, SAFS_SECSWAITFORWINDOW_ITEM, SAFS_SECSWAITFORWINDOW_VARIABLE, SAFS_TESTDOMAINS_ITEM, SAFS_TESTDOMAINS_VARIABLE, secsWaitForComponent, secsWaitForWindow, SENT_MSG_3, testDomains, testRecordData, testrecordStackable, TXT_FAILURE_1, TXT_FAILURE_2, TXT_FAILURE_3, TXT_FAILURE_4, TXT_FAILURE_5, TXT_SUCCESS_1, TXT_SUCCESS_2, TXT_SUCCESS_2a, TXT_SUCCESS_3, TXT_SUCCESS_3a, TXT_SUCCESS_4, TXT_SUCCESS_5, unexpectedAlertBehaviour, WARNING_MESSAGE, WARNING_OK_MESSAGE, warningStr, warningText

Constructor Summary

Constructors

Constructor and Description
CFComboBox()

Method Summary

Modifier and Type	Method and Description
protected void	captureItemsToFile(java.lang.String filename, java.lang.String encoding) Purpose: captureItemsToFile
protected java.util.Collection<java.lang.String>	captureObjectData() Sub class may override this method to get its own data.
protected void	localProcess() Handle the cache for component-library. In this class CFComponent, component-library is not required for some keywords like Maximize, Minimize etc. So in the method CFComponent.process() of this class, when calling CFComponent.localProcess(), if any Exception is caught, just ignore it. But for subclass, component-library is required, so if this method is overrided, user needs to call super.localProcess() in a try-catch clause like following:
protected ComboBox	newLibComponent(org.openqa.selenium.WebElement webelement) sub class MUST to override this method and provide its own library Component.
protected org.openqa.selenium.WebElement	waitReady(org.openqa.selenium.WebElement element) Wait for the component to be "ready": "ready" has different meanings for different components and different types.

Methods inherited from class org.safs.selenium.webdriver.CFComponent

_close, _maximize, _minimize, _setFocus, _setPosition, _setSize, action_ComputedStyle, captureHierarchicalData, clearCache, clearInternalCache, componentClick, convertElementArrayToList, doSetText, dragTo, executeScript, exist, getComponentRectangle, getComponentRectangleOnScreen, getProperties, getPropertyObject, getRectangleImage, getWindowRectangleOnScreen, inputKeystrokes, performDrag, performHoverMouse, process, refresh, refresh, refresh, refresh, setMaxRetry, setText, showComponentAsMuchPossible

Methods inherited from class org.safs.ComponentFunction

_restore, action_getGuiImage, action_GetSaveTextFromGUI, action_showOnPage, action_verifyGuiImageToFile, assignPropertyVariable, captureObjectDataToFile, capturePropertiesToFile, capturePropertyToFile, checkForCoord, checkForCoord, clearAppMapCache, close, closeWindow, componentExecutedFailureMessage, componentFailureMessage, componentProcess, componentSuccessMessage, convertCoords, convertLine, convertNum, convertWindowPosition, ConvertWindowPosition, deduceImageRect, getAlternateParams, getHelpers, getHelpersWorker, getPossibleMapItem, getProperty, getPropertyCollection, getPropertyCollection, getStringValue, getUUIDBoolean, guiDoesExist, hoverMouse, hoverScreenLocation, isClickAction, isPropertyExist, issueFileErrorFailure, issueParameterCountFailure, issueParameterCountFailure, issueParameterValueFailure, issuePassedSuccess, issuePassedSuccessUsing, issueUnknownErrorFailure, isSupportedRecordType, locateScreenImage, lookupAppMapCoordReference, lookupAppMapLineReference, lookupAppMapNumReference, lookupAppMapReference, maximize, minimize, normalizeFileEncoding, normalizePropertyCollection, performScorll, restore, selectMenuItem, sendEvent, setIterator, setPosition, setPropertyValue, setRectVars, updateFromTestRecordData, verifyClipboardToFile, verifyFileToFile, verifyMenuItem, verifyObjectDataToFile, verifyPropertiesToFile, verifyProperty, verifyPropertyContains, verifyPropertyToFile, verifyValueContains, verifyValues, waitForGUI, waitForObject

Methods inherited from class org.safs.Processor

activateBreakpoint, checkBreakpoints, checkMyBreakpoints, deduceBenchFile, deduceDiffFile, deduceProjectFile, deduceTestFile, delay, distributeConfigInformation, getAbsolutFileName, getAppMapItem, getChainedProcessor, getClassInstance, getClearProxiesAlways, getCustomProcClassNames, getCustomProcInstancePath, getLogUtilities, getParams, getProcClassNames, getProcInstance, getProcInstancePath, getRequiredField, getSecsWaitForComponent, getSecsWaitForWindow, getStandardErrorMessage, getTestRecordData, getUnexpectedAlertBehaviour, getVariable, hasChainedProcessor, initProcessorAndProcess, instanceProcessorAndProcess, isBreakpointsOn, isComponentFunctionRecord, isDriverCommandRecord, isEngineCommandRecord, isMyBreakpointsOn, isRecordProcessed, isRFSMCache, isRFSMOnly, issueActionFailure, issueActionOnXFailure, issueErrorPerformingAction, issueErrorPerformingActionOnX, issueErrorPerformingActionUsing, issueInputRecordFailure, issueInputRecordFailure, issuePassedSuccess, logFailureMessage, normalizeTestFileName, paramsFailedMsg, paramsFailedMsg, popTestRecord, processCustomProcessor, processSubclassProcessor, pushTestRecord, setAtEndOfProcess, setBreakpointsOn, setChainedProcessor, setClearProxiesAlways, setCommandLineBreakpoint, setCustomProcInstancePath, setLogUtilities, setMyBreakpointsOn, setParams, setProcInstance, setProcInstancePath, setRecordProcessed, setRFSMCache, setRFSMOnly, setSecsWaitForComponent, setSecsWaitForWindow, setTestDomains, setTestRecordData, setUnexpectedAlertBehaviour, setVariable, standardFailureMessage, substituteVariable, validateParamSize, validProcessorClassName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LIBRARY_NAME

public static final java.lang.String LIBRARY_NAME

"ComboBox"

combobox

protected ComboBox combobox

Constructor Detail

CFComboBox

public CFComboBox()

Method Detail

newLibComponent

protected ComboBox newLibComponent(org.openqa.selenium.WebElement webelement)
                            throws SeleniumPlusException

Description copied from class: CFComponent

sub class MUST to override this method and provide its own library Component.

Overrides:

newLibComponent in class CFComponent

Throws:

SeleniumPlusException

localProcess

protected void localProcess()

Description copied from class: CFComponent

Handle the cache for component-library.
In this class CFComponent, component-library is not required for some keywords like Maximize, Minimize etc.
So in the method CFComponent.process() of this class, when calling CFComponent.localProcess(),
if any Exception is caught, just ignore it.
But for subclass, component-library is required, so if this method is overrided, user needs to
call super.localProcess() in a try-catch clause like following:

 
 try{
   super.localProcess();
   subLibrary = (SubComponentLibrary) libComponent;

 }catch(SeleniumPlusException se){
   testRecordData.setStatusCode(StatusCodes.GENERAL_SCRIPT_FAILURE);
 }
 
 

Overrides:

localProcess in class CFComponent

captureItemsToFile

protected void captureItemsToFile(java.lang.String filename,
                                  java.lang.String encoding)
                           throws SeleniumPlusException

Purpose: captureItemsToFile

example step commands:

T, JavaWin, JList, CaptureItemsToFile, AFileName.txt
Capture all items of Combo Box to file AFileName.txt

Throws:

SeleniumPlusException

captureObjectData

protected java.util.Collection<java.lang.String> captureObjectData()
                                                            throws SAFSException

Description copied from class: CFComponent

Sub class may override this method to get its own data.

Overrides:

captureObjectData in class CFComponent

Returns:

Collection<String>, component's content. It may be null or empty.

Throws:

SAFSException - "Not supported yet."

waitReady

protected org.openqa.selenium.WebElement waitReady(org.openqa.selenium.WebElement element)

Description copied from class: CFComponent

Wait for the component to be "ready": "ready" has different meanings for different components and different types.

Overrides:

waitReady in class CFComponent

Parameters:

element - WebElement the web-element to be checked

Returns:

WebElement, the "ready" WebElement