ÿþ<HTML xmlns="http://www.w3.org/TR/REC-html40"> <HEAD> <TITLE>ComboEditBoxFunctions</TITLE> <LINK rel="stylesheet" href="rrafs.css" type="text/css"/> </HEAD> <BODY> <DIV NAME="top" ID="top"> <H3>ComboEditBoxFunctions</H3> <SMALL>Last Updated:<script language="JavaScript">document.write(document.lastModified)</script></SMALL> <BR/> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Actions for working with ComboEditBox objects </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </DIV> <BR/> <DIV NAME="list" ID="list"> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <TABLE cellspacing="3" border="1" cellpadding="2"> <TR> <TD nowrap="true" width="27%"><A ID="linkdeprecated" NAME='list_Click' HREF='#detail_Click' >Click</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </TD> <TD>Deprecated For:Generic CLICK</TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_Select' HREF='#detail_Select' >Select</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </TD> <TD> Select an item by its text value from a ComboEditBox. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SelectIndex' HREF='#detail_SelectIndex' >SelectIndex</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </TD> <TD> Select an item by its index from a ComboEditBox (ComboBox). </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SelectPartialMatch' HREF='#detail_SelectPartialMatch' >SelectPartialMatch</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </TD> <TD> Select an item via a partial text match. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SetTextValue' HREF='#detail_SetTextValue' >SetTextValue</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </TD> <TD> Set the text of the ComboEditBox </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SetUnverifiedTextValue' HREF='#detail_SetUnverifiedTextValue' >SetUnverifiedTextValue</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </TD> <TD> Set the text of the ComboEditBox without verification </TD> </TR> </TABLE> <HR/> </DIV> <DIV NAME="detail" ID="detail"> <H3><A NAME='detail_Click' />ComboEditBoxFunctions::<SPAN ID="deprecated">Click</SPAN> (deprecated for: <B>Generic CLICK</B>) <TABLE><TR> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Defaults to Generic CLICK where applicable. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>Attempts to perform a standard Click on the ComboEditBox. If the ComboEditBox list is not exposed then this may expose the list of items. If the list is already exposed, then this may close the list. It may also just provide focus to the ComboEditBox.</p><p> It must be noted that when you expose the list in a ComboEditBox, it is no longer a ComboEditBox. It typically converts to a ComboListBox. This may not be an issue on controls that Robot can recognize with a NAME= method. </p><p> However, if the control is recognized by ObjectIndex or some other means then the original ComboEditBox may no longer be found on the screen. With this scenario, you need to reference the ComboEditBox and the ComboListBox in the application map (and associated data files) as two separate items.</p><p> To avoid these potential problems, use the ComboEditBox 'SELECT' command to actually open the list and select the item all with a single command.</p></detailed_desc><BR/> </DIV> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">T, WINDOW, ComboEditBox, CLICK</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Used to show or hide the drop down list or get focus for the ComboEditBox object. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Used to show or hide the drop down list or get focus for the ComboEditBox object. Use the Select command INSTEAD of Click if you actually want to Select an item in the list. </detailed_desc><BR/> </DIV> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> <H3><A NAME='detail_Select' />ComboEditBoxFunctions::<BIG>Select</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Select an item by its text value from a ComboEditBox. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>Select an item by its text value from a ComboEditBox. 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.</p><p> 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.</p><p> 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.</p></detailed_desc><BR/> </DIV> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI> <B>TextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The case-sensitive item in the drop down list to select. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">T, WINDOW, ComboEditBox, SELECT, "MySelection"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> This action attempts to Click AND Select "MySelection" (case-sensitive) from the ComboEditBox. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> <H3><A NAME='detail_SelectIndex' />ComboEditBoxFunctions::<BIG>SelectIndex</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Select an item by its index from a ComboEditBox (ComboBox). </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>Select an item by its index from a ComboEditBox (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.</p><p> 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.</p></detailed_desc><BR/> </DIV> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI> <B>IndexValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The item index in the drop down list to select. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">T, WINDOW, ComboEditBox, SELECTINDEX, "1"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> This action attempts to Click AND Select item #1 from the ComboEditBox list. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> <H3><A NAME='detail_SelectPartialMatch' />ComboEditBoxFunctions::<BIG>SelectPartialMatch</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Select an item via a partial text match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>Select an item via a partial text match. 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.</p><p> 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.</p><p> 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.</p></detailed_desc><BR/> </DIV> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI> <B>TextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The case-sensitive substring of an item in the drop down list to select. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">T, WINDOW, ComboEditBox, SelectPartialMatch, "ATextSubstring"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> This action attempts to Click AND Select the first item containing the substring provided. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> <H3><A NAME='detail_SetTextValue' />ComboEditBoxFunctions::<BIG>SetTextValue</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Set the text of the ComboEditBox </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>This action sets the text of the ComboEditBox. 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.</p><p> ~^+%{( are primarily the characters that induce special processing.</p><p> 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.</p></detailed_desc><BR/> </DIV> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI>[ <B>TextValue</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The text that will be typed into the ComboEditBox. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> TextValue will be the text that will be typed into the ComboEditBox. Quoted text may be used to ensure proper expected value retrieval. There is also no check for a missing field because that would be the same as specifying no text ("")--which is valid. </detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">T, WINDOW, ComboEditBox, SETTEXTVALUE, "MyPassword"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> "MyPassword" is typed into the ComboEditBox </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> <H3><A NAME='detail_SetUnverifiedTextValue' />ComboEditBoxFunctions::<BIG>SetUnverifiedTextValue</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Set the text of the ComboEditBox without verification </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>This action sets the text of the ComboEditBox. 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.</p><p> ~^+%{( are primarily the characters that induce special processing.</p><p> 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 and does not verify whether or not any of the special characters exist in the provided text value. </p></detailed_desc><BR/> </DIV> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI>[ <B>TextValue</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The text that will be typed into the ComboEditBox. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> TextValue will be the text that will be typed into the ComboEditBox. Quoted text may be used to ensure proper expected value retrieval. There is also no check for a missing field because that would be the same as specifying no text ("")--which is valid. </detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">T, WINDOW, ComboEditBox, SETUNVERIFIEDTEXTVALUE, "MyPassword"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> "MyPassword" is typed into the ComboEditBox, but not verified </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> </DIV> </BODY> </HTML>