org.safs.rational

Class CFComboBox

java.lang.Object

org.safs.Processor

org.safs.ComponentFunction

org.safs.rational.CFComponent

org.safs.rational.CFComboBox

All Implemented Interfaces:

ITestRecordStackable, RuntimeDataInterface

Direct Known Subclasses:

CFFlexComboBox, CFWPFComboBox

public class CFComboBox
extends CFComponent

Purpose: CFComboBox, process a ComboBox component
Lifetime: instantiated by TestStepProcessor

Since:

JUN 17, 2003
JUL 17, 2003 (DBauman) Original Release
MAR 18, 2004 (BNat) Select keyword updated with Null Pointer Exception.
JUN 21, 2005 (Jeremy_J_Smith) Post-Set verification now consistent with regular VERIFYSELECTED method.
JUN 22, 2005 (Jeremy_J_Smith) Post-Set verification enhancements and new SETUNVERIFIEDTEXTVALUE action.
JUL 10, 2008 (JunwuMa)Modified methods verifySelectedText() and verifyTextProperty() to ensure they can work with .NET objects for SELECT and SELECTTEXTITEM,VERIFYSELECTED and VERIFYSELECTEDITEM. JUL 11, 2008 (JunwuMa)Added getItems() supporting .NET for CAPTUREITEMSTOFILE,SELECTPARTIALMATCH. Switched on .NET domain support in SetTextValue() for SETTEXTVALUE and SETUNVERIFIEDTEXTVALUE All keywords in this class are already .NET supported.
SEP 12, 2008 (LeiWang) Modify hideCombo() and showCombo(). Right-click can not hide the combo list. A simple click can open and close the combo list. But before using showCombo(), we are must suer the combobox is hide; otherwise the combobox will be closed. The same to hideCombo().
OCT 04, 2008 (LeiWang) Modify method verifySelectedText(). Test the object type before casting. See defect S0534980.
NOV 25, 2008 (LeiWang) Modify method setTextValue(): If value contains special, do not verify. See defect S0546329.
DEC 03, 2008 (Carl Nagle) Modify SelectPartialMatch to selectAtIndex if selectAtText fails after 4 attempts.
DEC 04, 2008 (LeiWang) Modify method setTextValue(): Include win domain to be processed. Now Java, Net, Win domain are included. For win doamin, keywords with verification are not supported. See defect S0550143.
DEC 10, 2008 (LeiWang) Modify method getItems(): treat combobox in toolbar, the type of combobox is "System.Windows.Forms.ToolStripComboBox+ToolStripComboBoxControl"
DEC 24, 2008 (LeiWang) Modify method verifySelectedText(): add support for window ComboBox. See defect S0554263.

Author:

Doug Bauman

Nested Class Summary

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

ComponentFunction.Window

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CAPTUREITEMSTOFILE
static java.lang.String	HIDELIST
static java.lang.String	SELECT
static java.lang.String	SELECTINDEX
static java.lang.String	SELECTPARTIALMATCH
static java.lang.String	SELECTTEXTITEM
static java.lang.String	SELECTUNVERIFIED
static java.lang.String	SELECTUNVERIFIEDTEXTITEM
static java.lang.String	SETTEXTVALUE
static java.lang.String	SETUNVERIFIEDTEXTVALUE
static java.lang.String	SHOWLIST
static java.lang.String	VERIFYSELECTED
static java.lang.String	VERIFYSELECTEDITEM

Fields inherited from class org.safs.rational.CFComponent

keepEncodingConsistent, obj1, script, 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() Purpose: constructor, calls super

Method Summary

Modifier and Type	Method and Description
protected void	captureItemsToFile() Purpose: captureItemsToFile
protected java.util.List	captureObjectData(com.rational.test.ft.object.interfaces.TestObject table) Captures the object data into a List.
protected boolean	compareValues(java.lang.String value, java.lang.String param) Purpose: compareValues and report failure if not matching.
protected void	doSelect(java.lang.String action)
protected void	localProcess() Purpose: process: process the testRecordData This is our specific version.
protected void	setTextValue(boolean performVerification) Purpose: setTextValue
protected void	verifySelected() Purpose:

Methods inherited from class org.safs.rational.CFComponent

_maximize, _minimize, _restore, _setPosition, _setSize, captureObjectDataToFile, capturePropertiesToFile, capturePropertyToFile, clearAppMapCache, closeWindow, componentClick, convertObjectValueToString, exist, extractTreeItemsSub, findMenuBars, formatObjectData, getAppletsBrowser, getComponentRectangle, getComponentRectangleOnScreen, getHelpers, getKeepEncodingConsistent, getObjectProperty, getObjectPropertyFromProperties, getProperties, getPropertyObject, getUserObject, getWindowRectangleOnScreen, inputKeystrokes, isDotnetDomain, isFlexDomain, isHtmlDomain, isJavaDomain, isSwtDomain, isSWTWidget, isWinDomain, listAllProperties, listAllProperties, listMethods, listNonValueProperties, listProperties, matchedPathOfMenuItem, mouseClick, parseWhereInfo, performClick, performDrag, performHoverMouse, performScorll, process, selectMenuItem, sendEvent, sendFlexEvent, setKeepEncodingConsistent, setPropertyValue, tobj, verifyClipboardToFile, verifyFileToFile, verifyMenuItem, verifyObjectDataToFile, verifyPropertyContains, verifyPropertyToFile, verifyValueContains, verifyValues

Methods inherited from class org.safs.ComponentFunction

_close, action_ComputedStyle, action_getGuiImage, action_GetSaveTextFromGUI, action_showOnPage, action_verifyGuiImageToFile, assignPropertyVariable, captureObjectData, checkForCoord, checkForCoord, clearCache, close, componentExecutedFailureMessage, componentFailureMessage, componentProcess, componentSuccessMessage, convertCoords, convertLine, convertNum, convertWindowPosition, ConvertWindowPosition, deduceImageRect, dragTo, executeScript, getAlternateParams, getHelpersWorker, getPossibleMapItem, getProperty, getPropertyCollection, getPropertyCollection, getRectangleImage, getStringValue, getUUIDBoolean, guiDoesExist, hoverMouse, hoverScreenLocation, isPropertyExist, issueFileErrorFailure, issueParameterCountFailure, issueParameterCountFailure, issueParameterValueFailure, issuePassedSuccess, issuePassedSuccessUsing, issueUnknownErrorFailure, isSupportedRecordType, locateScreenImage, lookupAppMapCoordReference, lookupAppMapLineReference, lookupAppMapNumReference, lookupAppMapReference, maximize, minimize, normalizeFileEncoding, normalizePropertyCollection, restore, setIterator, setPosition, setRectVars, showComponentAsMuchPossible, updateFromTestRecordData, verifyPropertiesToFile, verifyProperty, 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

CAPTUREITEMSTOFILE

public static final java.lang.String CAPTUREITEMSTOFILE

See Also:

Constant Field Values

SHOWLIST

public static final java.lang.String SHOWLIST

See Also:

Constant Field Values

HIDELIST

public static final java.lang.String HIDELIST

See Also:

Constant Field Values

SELECT

public static final java.lang.String SELECT

See Also:

Constant Field Values

SELECTTEXTITEM

public static final java.lang.String SELECTTEXTITEM

See Also:

Constant Field Values

SELECTINDEX

public static final java.lang.String SELECTINDEX

See Also:

Constant Field Values

SELECTPARTIALMATCH

public static final java.lang.String SELECTPARTIALMATCH

See Also:

Constant Field Values

SELECTUNVERIFIED

public static final java.lang.String SELECTUNVERIFIED

See Also:

Constant Field Values

SELECTUNVERIFIEDTEXTITEM

public static final java.lang.String SELECTUNVERIFIEDTEXTITEM

See Also:

Constant Field Values

SETTEXTVALUE

public static final java.lang.String SETTEXTVALUE

See Also:

Constant Field Values

SETUNVERIFIEDTEXTVALUE

public static final java.lang.String SETUNVERIFIEDTEXTVALUE

See Also:

Constant Field Values

VERIFYSELECTED

public static final java.lang.String VERIFYSELECTED

See Also:

Constant Field Values

VERIFYSELECTEDITEM

public static final java.lang.String VERIFYSELECTEDITEM

See Also:

Constant Field Values

Constructor Detail

CFComboBox

public CFComboBox()

Purpose: constructor, calls super

Method Detail

localProcess

protected void localProcess()

Purpose: process: process the testRecordData
This is our specific version. We subclass the generic CFComponent. The actions handled here are:

• hidelist
• showlist
• select
• selectTextItem
• selectIndex
• selectPartialMatch
• selectUnverified
• selectUnverifiedTextItem
• setTextValue
• setUnverifiedTextValue
• verifySelected
• verifySelectedItem

Side Effects: Processor.testRecordData statusCode is set based on the result of the processing
State Read: Processor.testRecordData, Processor.params
Assumptions: none

Overrides:

localProcess in class CFComponent

verifySelected

protected void verifySelected()
                       throws SAFSException

Purpose:

Throws:

SAFSException

captureObjectData

protected java.util.List captureObjectData(com.rational.test.ft.object.interfaces.TestObject table)
                                    throws java.lang.IllegalArgumentException,
                                           SAFSException

Captures the object data into a List. This is generally for the CaptureObjectDataToFile and VerifyObjectDataToFile, CaptureItemsToFile and SelectPartialMatch commands.

Overrides:

captureObjectData in class CFComponent

Parameters:

table - TestObject to snapshot data from.

Returns:

List containing a single Object item. Null if an invalid table reference is provided or some other error occurs.

Throws:

SAFSException

java.lang.IllegalArgumentException - if table is not an acceptable TestObject.

captureItemsToFile

protected void captureItemsToFile()
                           throws SAFSException

Purpose: captureItemsToFile

example step commands:

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

Throws:

SAFSException

compareValues

protected boolean compareValues(java.lang.String value,
                                java.lang.String param)

Purpose: compareValues and report failure if not matching.

setTextValue

protected void setTextValue(boolean performVerification)
                     throws SAFSException

Purpose: setTextValue

example step commands:

T, JavaWin, JComboBox, SetTextValue, "04/20/1977"

Sets the "text" value of the combobox - value does not have to be in the "itemlist".
This method only works for JAVA components, not "HTML" ones...

Throws:

SAFSException

doSelect

protected void doSelect(java.lang.String action)
                 throws SAFSException

Throws:

SAFSException