ÿþ<HTML xmlns="http://www.w3.org/TR/REC-html40"> <HEAD> <TITLE>ListViewFunctions</TITLE> <LINK rel="stylesheet" href="rrafs.css" type="text/css"/> </HEAD> <BODY> <DIV NAME="top" ID="top"> <H3>ListViewFunctions</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 ListView 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 NAME='list_ActivatePartialMatch' HREF='#detail_ActivatePartialMatch' >ActivatePartialMatch</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </TD> <TD> Routine to double click an item according to a partial text match. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_ActivateTextItem' HREF='#detail_ActivateTextItem' >ActivateTextItem</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> Routine to double click an item according to its text value. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_ActivateTextItemCoords' HREF='#detail_ActivateTextItemCoords' >ActivateTextItemCoords</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </TD> <TD> Double click a text item at specific Coords. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_ActivateUnverifiedTextItem' HREF='#detail_ActivateUnverifiedTextItem' >ActivateUnverifiedTextItem</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> Routine to double click an unverifiable item according to its text value. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_ActivateUnverifiedTextItemCoords' HREF='#detail_ActivateUnverifiedTextItemCoords' >ActivateUnverifiedTextItemCoords</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </TD> <TD> Double click an unverifiable text item at specific Coords. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_AssignCellValue' HREF='#detail_AssignCellValue' >AssignCellValue</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </TD> <TD> Assigns the value of a cell in a listview to a variable. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_RightClickTextItem' HREF='#detail_RightClickTextItem' >RightClickTextItem</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> Routine to RightClick (single click) an item according to its text value. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_RightClickTextItemCoords' HREF='#detail_RightClickTextItemCoords' >RightClickTextItemCoords</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </TD> <TD> Right click a text item at specific Coords. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_RightClickUnverifiedTextItem' HREF='#detail_RightClickUnverifiedTextItem' >RightClickUnverifiedTextItem</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </TD> <TD> Routine to RightClick (single click) an unverifiable item according to its text value. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_RightClickUnverifiedTextItemCoords' HREF='#detail_RightClickUnverifiedTextItemCoords' >RightClickUnverifiedTextItemCoords</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </TD> <TD> Right Click an unverifiable text item at specific Coords. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SelectAnotherPartialMatch' HREF='#detail_SelectAnotherPartialMatch' >SelectAnotherPartialMatch</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </TD> <TD> Routine for multiple selection to Control+Click on an item according to a partial text match. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SelectAnotherTextItem' HREF='#detail_SelectAnotherTextItem' >SelectAnotherTextItem</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </TD> <TD> Routine for multiple selection to Control+Click on an item by its text value. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SelectIndexItem' HREF='#detail_SelectIndexItem' >SelectIndexItem</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> Routine to single click an item according to its Index value. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SelectIndexItemCoords' HREF='#detail_SelectIndexItemCoords' >SelectIndexItemCoords</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </TD> <TD> Routine to single click an item by Index at specific coordinates. </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='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </TD> <TD> Routine to select (single click) an item according to a partial text match. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SelectRandomItems' HREF='#detail_SelectRandomItems' >SelectRandomItems</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> </TR></TABLE> </TD> <TD> Routine to randomly select multiple items in the ListView object. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SelectTextItem' HREF='#detail_SelectTextItem' >SelectTextItem</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> Routine to select (single click) an item according to its text value. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SelectTextItemCoords' HREF='#detail_SelectTextItemCoords' >SelectTextItemCoords</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </TD> <TD> Single click a text item at specific Coords. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SelectUnverifiedTextItem' HREF='#detail_SelectUnverifiedTextItem' >SelectUnverifiedTextItem</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> Routine to select (single click) an unverifiable item according to its text value. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SelectUnverifiedTextItemCoords' HREF='#detail_SelectUnverifiedTextItemCoords' >SelectUnverifiedTextItemCoords</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </TD> <TD> Single click an unverifiable text item at specific Coords. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SetListContains' HREF='#detail_SetListContains' >SetListContains</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 a variable with the result of checking that a listview contains the provided item. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_VerifyItemUnselected' HREF='#detail_VerifyItemUnselected' >VerifyItemUnselected</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> Verifies a particular case-sensitive text item is NOT selected. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_VerifyListContains' HREF='#detail_VerifyListContains' >VerifyListContains</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </TD> <TD> Verify that a list view contains the provided item. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_VerifySelectedItem' HREF='#detail_VerifySelectedItem' >VerifySelectedItem</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> Verifies a particular case-sensitive text item is selected </TD> </TR> </TABLE> <HR/> </DIV> <DIV NAME="detail" ID="detail"> <H3><A NAME='detail_ActivatePartialMatch' />ListViewFunctions::<BIG>ActivatePartialMatch</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Routine to double click an item according to a partial text match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI> <B>PartialTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive substring of text item to select </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> PartialTextValue should be a case-sensitive substring of text item to select. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, ActivatePartialMatch, "ATextSubstring" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double clicks the first item containing "ATextSubstring" in the ListView. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T, WINDOW, ListView, ActivatePartialMatch , "ATextSubstring", "Index=2" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double clicks the 2nd item containing "ATextSubstring" in the ListView. </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_ActivateTextItem' />ListViewFunctions::<BIG>ActivateTextItem</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=""> Routine to double click an item according to its text value. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI> <B>SelectTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive text of node to select </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> SelectTextValue should contain the case-sensitive text item to select. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, ActivateTextItem , "AParticularUserID" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double clicks "AParticularUserID" from the ListView object </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T, WINDOW, ListView, ActivateTextItem , "AParticularUserID", "Index=2" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double clicks the 2nd item matching "AParticularUserID" from the ListView object </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_ActivateTextItemCoords' />ListViewFunctions::<BIG>ActivateTextItemCoords</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double click a text item at specific Coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI> <B>SelectTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive text of node to select </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> SelectTextValue should contain the case-sensitive text item to select. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B>Coords</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The explicit coordinates ("x,y") or an App Map reference to pre-defined coordinates. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> We first check to see if the field contains a reference to an App Map item. If that cannot be found, we will assume the field contains explicit coordinates. <p>We expect the coordinates in the format "x,y":</p><p> [MyListView]<br> Center=5,120 OR<br> Center=Coords=5,120 </p><p> The results from the lookup are appended to the "Coords=" string used by the Click command in Robot (if necessary).</p><p> Both Fields #3(component name) and #6(coords reference name) are used to locate the item in the App Map. This routine does not specify an App Map so only the current Map is used and it is expected to be valid.</p></detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T WINDOW MyList ActivateTextItemCoords "AParticularUserID" "5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double Click "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList ActivateTextItemCoords "AParticularUserID" "5,20" "Index=3" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double Click the 3rd item matching "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList ActivateTextItemCoords "AParticularUserID" "Coords=5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double Click "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList ActivateTextItemCoords "AParticularUserID" CENTER </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double Click "AParticularUserID" at coords defined in the App Map in a [MyList] section. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>Both Fields #3(component name) and #6(coords reference name) are used to locate the item in the App Map. This routine does not specify an App Map so only the current Map is used and it is expected to be valid.</p></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_ActivateUnverifiedTextItem' />ListViewFunctions::<BIG>ActivateUnverifiedTextItem</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=""> Routine to double click an unverifiable item according to its text value. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> An unverifiable item is one whose READ value is not the same as its SET value. </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>SelectTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive text of node to select </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> SelectTextValue should contain the case-sensitive text item to select. The selection will not be verified. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, ActivateUnverifiedTextItem , "AParticularUserID" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double click "AParticularUserID" from the ListView object. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> The selection will not (cannot) be verified. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B><usage xmlns=""> T, WINDOW, ListView, ActivateUnverifiedTextItem , "AParticularUserID", "Index=3" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double click the 3rd item matching "AParticularUserID" from the ListView object. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> The selection will not (cannot) be verified. </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_ActivateUnverifiedTextItemCoords' />ListViewFunctions::<BIG>ActivateUnverifiedTextItemCoords</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double click an unverifiable text item at specific Coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> An unverifiable item is one whose READ value is not the same as its SET value. </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>SelectTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive text of node to select </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> SelectTextValue should contain the case-sensitive text item to select. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B>Coords</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The explicit coordinates ("x,y") or an App Map reference to pre-defined coordinates. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> We first check to see if the field contains a reference to an App Map item. If that cannot be found, we will assume the field contains explicit coordinates. <p>We expect the coordinates in the format "x,y":</p><p> [MyListView]<br> Center=5,120 OR<br> Center=Coords=5,120 </p><p> The results from the lookup are appended to the "Coords=" string used by the Click command in Robot (if necessary).</p><p> Both Fields #3(component name) and #6(coords reference name) are used to locate the item in the App Map. This routine does not specify an App Map so only the current Map is used and it is expected to be valid.</p></detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T WINDOW MyList ActivateUnverifiedTextItemCoords "AParticularUserID" "5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double Click "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList ActivateUnverifiedTextItemCoords "AParticularUserID" "5,20" "Index=2" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double Click the 2nd item matching "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList ActivateUnverifiedTextItemCoords "AParticularUserID" "Coords=5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double Click "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList ActivateUnverifiedTextItemCoords "AParticularUserID" CENTER </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Double Click "AParticularUserID" at coords defined in the App Map in a [MyList] section. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>Both Fields #3(component name) and #6(coords reference name) are used to locate the item in the App Map. This routine does not specify an App Map so only the current Map is used and it is expected to be valid.</p></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_AssignCellValue' />ListViewFunctions::<BIG>AssignCellValue</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Assigns the value of a cell in a listview to a variable. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI> <B>Varibale</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Name of variable to assign value </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> The variable name that should be used to hold the value retrieved by this command. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B>RowCoord</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The coordinate of the row in the listview that you want to capture the value. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> We will capture the row, column value in the listview and assign it to the variable value. First you identify the row and then the column. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B>ColCoord</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The coordinate of the column in the listview that you want to capture the value. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> We will capture the row, column value in the listview and assign it to the variable value. First you identify the row and then the column. </detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T WINDOW MyList AssignCellValue "^variablename" 2 3 </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Assigns the value in the 2nd row, 3rd column of the "MyList" listview to a variable named "variablename." </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_RightClickTextItem' />ListViewFunctions::<BIG>RightClickTextItem</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=""> Routine to RightClick (single click) an item according to its text value. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI> <B>SelectTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive text of node to RightClick </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> SelectTextValue should contain the case-sensitive text item to RightClick. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, RightClickTextItem , "AParticularUserID" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> RightClick "AParticularUserID" from the ListView object </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T, WINDOW, ListView, RightClickTextItem , "AParticularUserID", "Index=2" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> RightClick the 2nd text item matching "AParticularUserID" from the ListView object </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_RightClickTextItemCoords' />ListViewFunctions::<BIG>RightClickTextItemCoords</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Right click a text item at specific Coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI> <B>SelectTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive text of node to RightClick </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> SelectTextValue should contain the case-sensitive text item to RightClick. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B>Coords</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The explicit coordinates ("x,y") or an App Map reference to pre-defined coordinates. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> We first check to see if the field contains a reference to an App Map item. If that cannot be found, we will assume the field contains explicit coordinates. <p>We expect the coordinates in the format "x,y":</p><p> [MyListView]<br> Center=5,120 OR<br> Center=Coords=5,120 </p><p> The results from the lookup are appended to the "Coords=" string used by the Click command in Robot (if necessary).</p><p> Both Fields #3(component name) and #6(coords reference name) are used to locate the item in the App Map. This routine does not specify an App Map so only the current Map is used and it is expected to be valid.</p></detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T WINDOW MyList RightClickTextItemCoords "AParticularUserID" "5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Right Click "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList RightClickTextItemCoords "AParticularUserID" "5,20" "Index=2" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Right Click the 2nd text item matching "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList RightClickTextItemCoords "AParticularUserID" "Coords=5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Right Click "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList RightClickTextItemCoords "AParticularUserID" CENTER </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Right Click "AParticularUserID" at coords defined in the App Map in a [MyList] section. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>Both Fields #3(component name) and #6(coords reference name) are used to locate the item in the App Map. This routine does not specify an App Map so only the current Map is used and it is expected to be valid.</p></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_RightClickUnverifiedTextItem' />ListViewFunctions::<BIG>RightClickUnverifiedTextItem</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Routine to RightClick (single click) an unverifiable item according to its text value. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> An unverifiable item is one whose READ value is not the same as its SET value. </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>SelectTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive text of node to RightClick </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> SelectTextValue should contain the case-sensitive text item to RightClick. The selection will not be verified. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, RightClickUnverifiedTextItem , "AParticularUserID" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> RightClick "AParticularUserID" from the ListView object. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> The selection will not (cannot) be verified. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B><usage xmlns=""> T, WINDOW, ListView, RightClickUnverifiedTextItem , "AParticularUserID", "Index=3" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> RightClick the 3rd text item matching "AParticularUserID" from the ListView object. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> The selection will not (cannot) be verified. </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_RightClickUnverifiedTextItemCoords' />ListViewFunctions::<BIG>RightClickUnverifiedTextItemCoords</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Right Click an unverifiable text item at specific Coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> An unverifiable item is one whose READ value is not the same as its SET value. </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>SelectTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive text of node to select </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> SelectTextValue should contain the case-sensitive text item to RightClick. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B>Coords</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The explicit coordinates ("x,y") or an App Map reference to pre-defined coordinates. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> We first check to see if the field contains a reference to an App Map item. If that cannot be found, we will assume the field contains explicit coordinates. <p>We expect the coordinates in the format "x,y":</p><p> [MyListView]<br> Center=5,120 OR<br> Center=Coords=5,120 </p></detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T WINDOW MyList RightClickUnverifiedTextItemCoords "AParticularUserID" "5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Right Click "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList RightClickUnverifiedTextItemCoords "AParticularUserID" "5,20" "Index=3" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> RightClick the 3rd text item matching "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList RightClickUnverifiedTextItemCoords "AParticularUserID" "Coords=5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Right Click "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList RightClickUnverifiedTextItemCoords "AParticularUserID" CENTER </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Right Click "AParticularUserID" at coords defined in the App Map in a [MyList] section. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>Both Fields #3(component name) and #6(coords reference name) are used to locate the item in the App Map. This routine does not specify an App Map so only the current Map is used and it is expected to be valid.</p></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_SelectAnotherPartialMatch' />ListViewFunctions::<BIG>SelectAnotherPartialMatch</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Routine for multiple selection to Control+Click on an item according to a partial text match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> This adds selected items to items already selected.<br></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>PartialTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive substring of text item to select. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI>[ <B>MatchIndex</B> = 1 ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, SelectAnotherPartialMatch, "ASubstring" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Ctrl+Clicks the first item containing "ASubstring" in the ListView. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Ctrl+Clicks the first item containing "ASubstring" in the ListView. This adds to any existing items already selected.<br></detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B><usage xmlns=""> T, WINDOW, ListView, SelectAnotherPartialMatch, "ASubstring", "Index=2" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Ctrl+Clicks the 2th item containing "ASubstring" in the ListView. </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_SelectAnotherTextItem' />ListViewFunctions::<BIG>SelectAnotherTextItem</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Routine for multiple selection to Control+Click on an item by its text value. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> This adds selected items to items already selected.<br></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=""> Case-sensitive text of node to select. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI>[ <B>MatchIndex</B> = 1 ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, SelectAnotherTextItem , "AParticularUserID" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Ctrl+Clicks "AParticularUserID" from the ListView object. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Ctrl+Clicks "AParticularUserID" from the ListView object. This adds to any existing items already selected.<br></detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B><usage xmlns=""> T, WINDOW, ListView, SelectAnotherTextItem , "AParticularUserID", "Index=2" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Ctrl+Clicks the 2th item matching "AParticularUserID" from the ListView object. </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_SelectIndexItem' />ListViewFunctions::<BIG>SelectIndexItem</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=""> Routine to single click an item according to its Index value. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> It is important to note that some ListViews index their values differently. For example, you may need to select an item by text by using a property whose starting index is 1. Yet, if you request to seek an item strictly by index, the starting index is 0. So, the test developer may need to evaluate their ListView object for these differences. </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>ItemIndex</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Index of node 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, ListView, SelectIndexItem , 4 </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Selects the item at Index 4. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> It is important to note that some ListViews index their values differently. For example, you may need to select an item by text by using a property whose starting index is 1. Yet, if you request to seek an item strictly by index, the starting index is 0. So, the test developer may need to evaluate their ListView object for these differences. </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_SelectIndexItemCoords' />ListViewFunctions::<BIG>SelectIndexItemCoords</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Routine to single click an item by Index at specific coordinates. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> It is important to note that some ListViews index their values differently. For example, you may need to select an item by text by using a property whose starting index is 1. Yet, if you request to seek an item strictly by index, the starting index is 0. So, the test developer may need to evaluate their ListView object for these differences. </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>ItemIndex</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Index of node to select. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B>Coords</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The explicit coordinates ("x,y") or an App Map reference to pre-defined coordinates. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> We first check to see if the field contains a reference to an App Map item. If that cannot be found, we will assume the field contains explicit coordinates. <p>We expect the coordinates in the format "x,y":</p><p> [MyListView]<br> Center=5,120 OR<br> Center=Coords=5,120 </p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T WINDOW MyList SelectIndexItemCoords "2" "5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single Click item index "2" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> It is important to note that some ListViews index their values differently. For example, you may need to select an item by text by using a property whose starting index is 1. Yet, if you request to seek an item strictly by index, the starting index is 0. So, the test developer may need to evaluate their ListView object for these differences. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList SelectIndexItemCoords "2" "Coords=5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single Click item index "2" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> It is important to note that some ListViews index their values differently. For example, you may need to select an item by text by using a property whose starting index is 1. Yet, if you request to seek an item strictly by index, the starting index is 0. So, the test developer may need to evaluate their ListView object for these differences. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList SelectIndexItemCoords "2" "Center" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single Click item index "2" at coords defined in App Map. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>Both Fields #3(component name) and #6(coords reference name) are used to locate the item in the App Map. This routine does not specify an App Map so only the current Map is used and it is expected to be valid.</p><p>It is important to note that some ListViews index their values differently. For example, you may need to select an item by text by using a property whose starting index is 1. Yet, if you request to seek an item strictly by index, the starting index is 0. So, the test developer may need to evaluate their ListView object for these differences.</p></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_SelectPartialMatch' />ListViewFunctions::<BIG>SelectPartialMatch</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='TC.GIF' ALT='AutomatedQA Test Complete'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Routine to select (single click) an item according to a partial text match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI> <B>PartialTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive substring of node to select </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> PartialTextValue should be a case-sensitive substring of text item to select. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, SelectPartialMatch , "APartialString" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Selects the first item containing "APartialString" in the ListView. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T, WINDOW, ListView, SelectPartialMatch , "APartialString", "Index=2" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Selects the 2nd text item containing "APartialString" in the ListView. </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_SelectRandomItems' />ListViewFunctions::<BIG>SelectRandomItems</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> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Routine to randomly select multiple items in the ListView object. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Routine to randomly select multiple items in the ListView object. Each selection is done with a CTRL + Single Left Click. Items are selected by index, not by their text values. Items already selected are NOT unselected. We add to existing selections. </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>ItemCount</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The quantity of items to randomly select in the object. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, SelectRandomItems , "3" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Randomly selects 3 items from the ListView object. </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_SelectTextItem' />ListViewFunctions::<BIG>SelectTextItem</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=""> Routine to select (single click) an item according to its text value. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI> <B>SelectTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive text of node to select </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> SelectTextValue should contain the case-sensitive text item to select. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, SelectTextItem , "AParticularUserID" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Selects "AParticularUserID" from the ListView object </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T, WINDOW, ListView, SelectTextItem , "AParticularUserID", "Index=2" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Selects the 2nd text item matching "AParticularUserID" from the ListView object </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_SelectTextItemCoords' />ListViewFunctions::<BIG>SelectTextItemCoords</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single click a text item at specific Coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="5" ><LI> <B>SelectTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive text of node to select </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> SelectTextValue should contain the case-sensitive text item to select. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B>Coords</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The explicit coordinates ("x,y") or an App Map reference to pre-defined coordinates. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> We first check to see if the field contains a reference to an App Map item. If that cannot be found, we will assume the field contains explicit coordinates. <p>We expect the coordinates in the format "x,y":</p><p> [MyListView]<br> Center=5,120 OR<br> Center=Coords=5,120 </p><p> The results from the lookup are appended to the "Coords=" string used by the Click command in Robot (if necessary).</p><p> Both Fields #3(component name) and #6(coords reference name) are used to locate the item in the App Map. This routine does not specify an App Map so only the current Map is used and it is expected to be valid.</p></detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T WINDOW MyList SelectTextItemCoords "AParticularUserID" "5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single Click "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList SelectTextItemCoords "AParticularUserID" "5,20" "Index=2" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single Click the 2nd text item matching "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList SelectTextItemCoords "AParticularUserID" "Coords=5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single Click "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList SelectTextItemCoords "AParticularUserID" CENTER </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single Click "AParticularUserID" at coords defined in the App Map in a [MyList] section. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>Both Fields #3(component name) and #6(coords reference name) are used to locate the item in the App Map. This routine does not specify an App Map so only the current Map is used and it is expected to be valid.</p></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_SelectUnverifiedTextItem' />ListViewFunctions::<BIG>SelectUnverifiedTextItem</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=""> Routine to select (single click) an unverifiable item according to its text value. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> An unverifiable item is one whose READ value is not the same as its SET value. </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>SelectTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive text of node to select </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> SelectTextValue should contain the case-sensitive text item to select. The selection will not be verified. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, SelectUnverifiedTextItem , "AParticularUserID" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Selects "AParticularUserID" from the ListView object. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> The selection will not (cannot) be verified. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B><usage xmlns=""> T, WINDOW, ListView, SelectUnverifiedTextItem , "AParticularUserID", "Index=3" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Selects the 3rd text item matching "AParticularUserID" from the ListView object. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> The selection will not (cannot) be verified. </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_SelectUnverifiedTextItemCoords' />ListViewFunctions::<BIG>SelectUnverifiedTextItemCoords</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single click an unverifiable text item at specific Coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> An unverifiable item is one whose READ value is not the same as its SET value. </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>SelectTextValue</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Case-sensitive text of node to select </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> SelectTextValue should contain the case-sensitive text item to select. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B>Coords</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The explicit coordinates ("x,y") or an App Map reference to pre-defined coordinates. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> We first check to see if the field contains a reference to an App Map item. If that cannot be found, we will assume the field contains explicit coordinates. <p>We expect the coordinates in the format "x,y":</p><p> [MyListView]<br> Center=5,120 OR<br> Center=Coords=5,120 </p></detailed_desc><BR/> </DIV> </LI> <BR/> <LI>[ <B>MatchIndex</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Optional index of the Nth duplicate item to match. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Allows us to match duplicate item N in a list containing duplicate entries. For example, match the 2nd (or specified Nth) item whose text matches the provided text value. <p> The value of the parameter can have 2 forms:<br><ul><li>A numeric value. Ex: "3"</li><li>Index prefixed value. Ex: "Index=3"</li></ul></p></detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T WINDOW MyList SelectUnverifiedTextItemCoords "AParticularUserID" "5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single Click "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList SelectUnverifiedTextItemCoords "AParticularUserID" "5,20" "Index=3" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single Click the 3rd text item matching "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList SelectUnverifiedTextItemCoords "AParticularUserID" "Coords=5,20" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single Click "AParticularUserID" at specific coords. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns=""> T WINDOW MyList SelectUnverifiedTextItemCoords "AParticularUserID" CENTER </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Single Click "AParticularUserID" at coords defined in the App Map in a [MyList] section. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p>Both Fields #3(component name) and #6(coords reference name) are used to locate the item in the App Map. This routine does not specify an App Map so only the current Map is used and it is expected to be valid.</p></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_SetListContains' />ListViewFunctions::<BIG>SetListContains</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 a variable with the result of checking that a listview contains the provided item. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> The search of the item is expected to be a case-sensitive exact match of the item. The provided variable is set with 'TRUE' if the item is found or 'FALSE' if the item is not found. </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>ItemText</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The case-sensitive name of the sought item. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> ItemText should contain the case-sensitive text item to find in the list view. A message is sent to the log confirming whether or not the item is found in the list view. </detailed_desc><BR/> </DIV> </LI> <BR/> <LI> <B>ResultVar</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The name of the variable receiving the result. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> This variable is set with 'TRUE' if the item is found or 'FALSE' if the item is not found. </detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, SetListContains , "AParticularServerName", isFound </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""><p>Variable isFound is set to 'TRUE' if the item "AParticularServerName" is found in the ListView object. If the item is not found, the variable isFound is set to 'FALSE'.</p></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_VerifyItemUnselected' />ListViewFunctions::<BIG>VerifyItemUnselected</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=""> Verifies a particular case-sensitive text item is NOT selected. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <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=""> Case-sensitive text of node that will be verified unselected </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> TextValue should contain the case-sensitive text of the item that is expected NOT to be selected. </detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">T, WINDOW, ListView, VerifyItemUnselected, "AParticularUserID"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Verifies that "AParticularUserID" is NOT selected in the ListView. </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_VerifyListContains' />ListViewFunctions::<BIG>VerifyListContains</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Verify that a list view contains the provided item. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> The search of the item is expected to be a case-sensitive exact match of the item. </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>ItemText</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The case-sensitive name of the item to verify. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> ItemText should contain the case-sensitive text item to find in the list view. A message is sent to the log confirming whether or not the item is found in the list view. </detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns=""> T, WINDOW, ListView, VerifyListContains , "AParticularServerName" </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Verify the item "AParticularServerName" is found in the ListView object. </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_VerifySelectedItem' />ListViewFunctions::<BIG>VerifySelectedItem</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=""> Verifies a particular case-sensitive text item is selected </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <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=""> Case-sensitive text of node that will be verified selected </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> TextValue should contain the case-sensitive text of the item expected to already be selected </detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">T, WINDOW, ListView, VerifySelectedItem , "AParticularUserID"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Verifies that "AParticularUserID" is selected in the ListView. </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>