org.safs

Class SAFSPlus.ListView

java.lang.Object

org.safs.SAFSPlus.Component

org.safs.SAFSPlus.ListView

Direct Known Subclasses:

SeleniumPlus.ListView

Enclosing class:

SAFSPlus

public static class SAFSPlus.ListView
extends SAFSPlus.Component

Wrapper class providing APIs to handle ListView keywords, like ClickIndex, VerifyListContains etc.

Constructor Summary

Constructors

Constructor and Description
ListView()

Method Summary

Modifier and Type	Method and Description
static boolean	ActivateIndex(Component listview, int index) Double click an item value in ListView according to an index.
static boolean	ActivateIndexItem(Component listview, int index) Double click an item value in ListView according to an index.
static boolean	ActivatePartialMatch(Component listview, java.lang.String partialText) Double click an item value in ListView according to a partial text.
static boolean	ActivatePartialMatch(Component listview, java.lang.String partialText, int matchIndex) Double click an item value in ListView according to a partial text.
static boolean	ActivateTextItem(Component listview, java.lang.String text) Double click an item value in ListView according to a full text.
static boolean	ActivateTextItem(Component listview, java.lang.String text, int matchIndex) Double click an item value in ListView according to a full text.
static boolean	ActivateTextItemCoords(Component listview, java.lang.String text, java.lang.String coords) Double click a text item at specific Coords.If there are more than one matched item, select the first one.
static boolean	ActivateTextItemCoords(Component listview, java.lang.String text, java.lang.String coords, int matchIndex) Double click a text item at specific Coords.
static boolean	ActivateUnverifiedTextItem(Component listview, java.lang.String text) Double click an item value in ListView according to a full text without verification.
static boolean	ActivateUnverifiedTextItem(Component listview, java.lang.String text, int matchIndex) Double click an item value in ListView according to a full text without verification.
static boolean	ActivateUnverifiedTextItemCoords(Component listview, java.lang.String text, java.lang.String coords) Double click an item at specific coordinate in ListView according to a full text without verification. If there are more than one matched item, select the first one.
static boolean	ActivateUnverifiedTextItemCoords(Component listview, java.lang.String text, java.lang.String coords, int matchIndex) Double click an item at specific coordinate in ListView according to a full text without verification.
static boolean	CaptureItemsToFile(Component listview, java.lang.String file) Get all text value of items in ListView, and save them to a file by system encoding.
static boolean	CaptureItemsToFile(Component listview, java.lang.String file, java.lang.String encoding) Get all text value of items in ListView, and save them to a file.
static boolean	ClickIndex(Component listview, int index) Double click an item value in ListView according to an index.
static boolean	ClickIndexItem(Component listview, int index) Double click an item value in ListView according to an index.
static boolean	ExtendSelectionToTextItem(Component listview, java.lang.String text) Shift+Click and Verify a selection according to its text value.
(package private) static java.lang.String	GetItemID(Component listview, int index)
static boolean	RightClickTextItem(Component listview, java.lang.String text) RightClick (single click) an item value in ListView according to a full text.
static boolean	RightClickTextItem(Component listview, java.lang.String text, int matchIndex) RightClick (single click) an item value in ListView according to a full text.
static boolean	RightClickTextItemCoords(Component listview, java.lang.String text, java.lang.String coords) RightClick (single click) an item value in ListView according to a full text at specific coordinate. If there are more than one matched item, select the first one.
static boolean	RightClickTextItemCoords(Component listview, java.lang.String text, java.lang.String coords, int matchIndex) RightClick (single click) an item value in ListView according to a full text at specific coordinate.
static boolean	SelectAnotherPartialMatch(Component listview, java.lang.String partialText) Control+Click on an item according to a partial text match.
static boolean	SelectAnotherTextItem(Component listview, java.lang.String text) Control+Click on an item by its text value.
static boolean	SelectIndex(Component listview, int index) Select (single click) an item value in ListView according to an index.
static boolean	SelectIndexItem(Component listview, int index) Select (single click) an item value in ListView according to an index.
static boolean	SelectIndexItemCoords(Component listview, int index, java.lang.String coords) Select (single click) an item value in ListView according to an index at specific coordinates.
static boolean	SelectPartialMatch(Component listview, java.lang.String partialText) Select (single click) an item value in ListView according to a partial text.
static boolean	SelectPartialMatch(Component listview, java.lang.String partialText, int matchIndex) Select (single click) an item value in ListView according to a partial text.
static boolean	SelectTextItem(Component listview, java.lang.String text) Select (single click) an item value in ListView according to a full text.
static boolean	SelectTextItem(Component listview, java.lang.String text, int matchIndex) Select (single click) an item value in ListView according to a full text.
static boolean	SelectTextItemCoords(Component listview, java.lang.String text, java.lang.String coords) Select (single click) an item value in ListView according to a full text at specific coordinate. If there are more than one matched item, select the first one.
static boolean	SelectTextItemCoords(Component listview, java.lang.String text, java.lang.String coords, int matchIndex) Select (single click) an item value in ListView according to a full text at specific coordinate.
static boolean	SelectUnverifiedTextItem(Component listview, java.lang.String text) Select (single click) an item value in ListView according to a full text without verification.
static boolean	SelectUnverifiedTextItem(Component listview, java.lang.String text, int matchIndex) Select (single click) an item value in ListView according to a full text without verification.
static boolean	SelectUnverifiedTextItemCoords(Component listview, java.lang.String text, java.lang.String coords) Select (single click) an item value in ListView according to a full text at specific coordinate without verification. If there are more than one matched item, select the first one.
static boolean	SelectUnverifiedTextItemCoords(Component listview, java.lang.String text, java.lang.String coords, int matchIndex) Select (single click) an item value in ListView according to a full text at specific coordinate without verification.
static boolean	SetListContains(Component listview, java.lang.String text, java.lang.String variable) Set a variable with the result of checking that a listview contains the provided item.
static boolean	VerifyItemUnselected(Component listview, java.lang.String text) Verify that an item is not selected in ListView.
static boolean	VerifyListContains(Component listview, java.lang.String text) Verify that an item is contained in ListView.
static boolean	VerifySelectedItem(Component listview, java.lang.String text) Verify that an item is selected in ListView.

Methods inherited from class org.safs.SAFSPlus.Component

AltClick, AltLeftDrag, AssignPropertyVariable, CaptureObjectDataToFile, CapturePropertiesToFile, CapturePropertyToFile, ClearCache, Click, CtrlAltLeftDrag, CtrlClick, CtrlLeftDrag, CtrlRightClick, CtrlShiftLeftDrag, DoubleClick, DragTo, ExecuteScript, GetComputedStyle, GetGUIImage, GetTextFromGUI, GUIDoesExist, GUIDoesNotExist, HoverMouse, HoverScreenLocation, InputCharacters, InputKeys, IsPropertyExist, IsPropertyExist, LeftDrag, LocateScreenImage, RightClick, RightDrag, SaveTextFromGUI, ShiftClick, ShiftLeftDrag, ShowOnPage, TypeChars, TypeEncryption, TypeKeys, VerifyBinaryFileToFile, VerifyComputedStyle, VerifyFileToFile, VerifyGUIImageToFile, VerifyObjectDataToFile, VerifyPropertiesSubsetToFile, VerifyPropertiesToFile, VerifyProperty, VerifyPropertyContains, VerifyPropertyContains, VerifyPropertyToFile, VerifyTextFileToFile, VerifyValueContains, VerifyValueContainsIgnoreCase, VerifyValueDoesNotContain, VerifyValues, VerifyValuesIgnoreCase, VerifyValuesNotEqual

Methods inherited from class java.lang.Object

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

Constructor Detail

ListView

public ListView()

Method Detail

GetItemID

static java.lang.String GetItemID(Component listview,
                                  int index)

ActivateIndex

public static boolean ActivateIndex(Component listview,
                                    int index)

Double click an item value in ListView according to an index.

See Detailed Reference

Parameters:

listview - Component (from App Map) to select an item from.

index - int, the index to select, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 boolean success = ListView.ActivateIndex(Map.SAPDemo.ListView,2);
 
 

ActivateIndexItem

public static boolean ActivateIndexItem(Component listview,
                                        int index)

Double click an item value in ListView according to an index.

See Detailed Reference

Parameters:

listview - Component (from App Map) to select an item from.

index - int, the index to select, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 boolean success = ListView.ActivateIndexItem(Map.SAPDemo.ListView,2);
 
 

ClickIndex

public static boolean ClickIndex(Component listview,
                                 int index)

Double click an item value in ListView according to an index.

See Detailed Reference

Parameters:

listview - Component (from App Map) to select an item from.

index - int, the index to select, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 boolean success = ListView.ClickIndex(Map.SAPDemo.ListView,2);
 
 

ClickIndexItem

public static boolean ClickIndexItem(Component listview,
                                     int index)

Double click an item value in ListView according to an index.

See Detailed Reference

Parameters:

listview - Component (from App Map) to select an item from.

index - int, the index to select, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 boolean success = ListView.ClickIndexItem(Map.SAPDemo.ListView,2);
 
 

SelectIndex

public static boolean SelectIndex(Component listview,
                                  int index)

Select (single click) an item value in ListView according to an index.

See Detailed Reference

Parameters:

listview - Component (from App Map) to select an item from.

index - int, the index to select, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 boolean success = ListView.SelectIndex(Map.SAPDemo.ListView,2);
 
 

SelectIndexItem

public static boolean SelectIndexItem(Component listview,
                                      int index)

Select (single click) an item value in ListView according to an index.

See Detailed Reference

Parameters:

listview - Component (from App Map) to select an item from.

index - int, the index to select, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 boolean success = ListView.SelectIndexItem(Map.SAPDemo.ListView,2);
 
 

SelectIndexItemCoords

public static boolean SelectIndexItemCoords(Component listview,
                                            int index,
                                            java.lang.String coords)

Select (single click) an item value in ListView according to an index at specific coordinates.

See Detailed Reference

Parameters:

listview - Component (from App Map) to select an item from.

index - int, the index to select, 1-based.

coords - String, the coordinate relative to the top-left corner of the item.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 boolean success = ListView.SelectIndexItemCoords(Map.SAPDemo.ListView,2);
 
 

ActivatePartialMatch

public static boolean ActivatePartialMatch(Component listview,
                                           java.lang.String partialText,
                                           int matchIndex)

Double click an item value in ListView according to a partial text.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

partialText - String, the case-sensitive substring of text item to select

matchIndex - int, allows to match item N in a list containing duplicate entries, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the 2th item containing string 'zona'
 boolean success = ListView.ActivatePartialMatch(Map.SAPDemo.ListView,"zona", 2);
 
 

ActivatePartialMatch

public static boolean ActivatePartialMatch(Component listview,
                                           java.lang.String partialText)

Double click an item value in ListView according to a partial text. If there are more than one matched item, select the first one.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

partialText - String, the case-sensitive substring of text item to select

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the first item containing string 'zona'
 boolean success = ListView.ActivatePartialMatch(Map.SAPDemo.ListView,"zona");
 
 

SelectPartialMatch

public static boolean SelectPartialMatch(Component listview,
                                         java.lang.String partialText,
                                         int matchIndex)

Select (single click) an item value in ListView according to a partial text.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

partialText - String, the case-sensitive substring of text item to select

matchIndex - int, allows to match item N in a list containing duplicate entries, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the 2th item containing string 'zona'
 boolean success = ListView.SelectPartialMatch(Map.SAPDemo.ListView,"zona", 2);
 
 

SelectPartialMatch

public static boolean SelectPartialMatch(Component listview,
                                         java.lang.String partialText)

Select (single click) an item value in ListView according to a partial text. If there are more than one matched item, select the first one.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

partialText - String, the case-sensitive substring of text item to select

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the first item containing string 'zona'
 boolean success = ListView.SelectPartialMatch(Map.SAPDemo.ListView,"zona");
 
 

ActivateTextItem

public static boolean ActivateTextItem(Component listview,
                                       java.lang.String text,
                                       int matchIndex)

Double click an item value in ListView according to a full text.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to select

matchIndex - int, allows to match item N in a list containing duplicate entries, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the 2th item whose text string is 'Arizona'
 boolean success = ListView.ActivateTextItem(Map.SAPDemo.ListView,"Arizona", 2);
 
 

ActivateTextItem

public static boolean ActivateTextItem(Component listview,
                                       java.lang.String text)

Double click an item value in ListView according to a full text. If there are more than one matched item, select the first one.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to select

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the first item whose text string is 'Arizona'
 boolean success = ListView.ActivateTextItem(Map.SAPDemo.ListView,"Arizona");
 
 

ActivateTextItemCoords

public static boolean ActivateTextItemCoords(Component listview,
                                             java.lang.String text,
                                             java.lang.String coords,
                                             int matchIndex)

Double click a text item at specific Coords.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to click

coords - String, the coordinate relative to the top-left corner of the item

matchIndex - int, allows to match item N in a list containing duplicate entries, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //double-click the 2th item whose text string is 'Arizona' at the coordinate (10,10)
 boolean success = ListView.ActivateTextItemCoords(Map.SAPDemo.ListView,"Arizona", "10;10", 2);
 
 

ActivateTextItemCoords

public static boolean ActivateTextItemCoords(Component listview,
                                             java.lang.String text,
                                             java.lang.String coords)

Double click a text item at specific Coords.If there are more than one matched item, select the first one.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to click

coords - String, the coordinate relative to the top-left corner of the item

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //double-click the first item whose text string is 'Arizona' at the coordinate (10,10)
 boolean success = ListView.ActivateTextItemCoords(Map.SAPDemo.ListView,"Arizona", "10;10");
 
 

SelectTextItem

public static boolean SelectTextItem(Component listview,
                                     java.lang.String text,
                                     int matchIndex)

Select (single click) an item value in ListView according to a full text.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to select

matchIndex - int, allows to match item N in a list containing duplicate entries, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the 2th item whose text string is 'Arizona'
 boolean success = ListView.SelectTextItem(Map.SAPDemo.ListView,"Arizona", 2);
 
 

SelectTextItem

public static boolean SelectTextItem(Component listview,
                                     java.lang.String text)

Select (single click) an item value in ListView according to a full text. If there are more than one matched item, select the first one.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to select

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the first item whose text string is 'Arizona'
 boolean success = ListView.SelectTextItem(Map.SAPDemo.ListView,"Arizona");
 
 

SelectTextItemCoords

public static boolean SelectTextItemCoords(Component listview,
                                           java.lang.String text,
                                           java.lang.String coords,
                                           int matchIndex)

Select (single click) an item value in ListView according to a full text at specific coordinate.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to select

coords - String, the coordinate relative to the top-left corner of the item

matchIndex - int, allows to match item N in a list containing duplicate entries, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the 2th item whose text string is 'Arizona' by clicking at (5,5) of the item.
 boolean success = ListView.SelectTextItemCoords(Map.SAPDemo.ListView,"Arizona", "5;5", 2);
 
 

SelectTextItemCoords

public static boolean SelectTextItemCoords(Component listview,
                                           java.lang.String text,
                                           java.lang.String coords)

Select (single click) an item value in ListView according to a full text at specific coordinate.
If there are more than one matched item, select the first one.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to select

coords - String, the coordinate relative to the top-left corner of the item

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the first item whose text string is 'Arizona' by clicking at (5,5) of the item.
 boolean success = ListView.SelectTextItemCoords(Map.SAPDemo.ListView,"Arizona", "5;5");
 
 

ActivateUnverifiedTextItem

public static boolean ActivateUnverifiedTextItem(Component listview,
                                                 java.lang.String text,
                                                 int matchIndex)

Double click an item value in ListView according to a full text without verification.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to select

matchIndex - int, allows to match item N in a list containing duplicate entries, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the 2th item whose text string is 'Arizona', will not verify "Arizona" is selected
 boolean success = ListView.ActivateUnverifiedTextItem(Map.SAPDemo.ListView,"Arizona", 2);
 
 

ActivateUnverifiedTextItem

public static boolean ActivateUnverifiedTextItem(Component listview,
                                                 java.lang.String text)

Double click an item value in ListView according to a full text without verification. If there are more than one matched item, select the first one.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to select

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the first item whose text string is 'Arizona', will not verify "Arizona" is selected
 boolean success = ListView.ActivateUnverifiedTextItem(Map.SAPDemo.ListView,"Arizona");
 
 

ActivateUnverifiedTextItemCoords

public static boolean ActivateUnverifiedTextItemCoords(Component listview,
                                                       java.lang.String text,
                                                       java.lang.String coords,
                                                       int matchIndex)

Double click an item at specific coordinate in ListView according to a full text without verification.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to click

coords - String, the coordinate relative to the top-left corner of the item

matchIndex - int, allows to match item N in a list containing duplicate entries, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //double-click the 2th item whose text string is 'Arizona' at the coordinate (10,10)
 boolean success = ListView.ActivateUnverifiedTextItemCoords(Map.SAPDemo.ListView,"Arizona", "10;10", 2);
 
 

ActivateUnverifiedTextItemCoords

public static boolean ActivateUnverifiedTextItemCoords(Component listview,
                                                       java.lang.String text,
                                                       java.lang.String coords)

Double click an item at specific coordinate in ListView according to a full text without verification.
If there are more than one matched item, select the first one.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to click

coords - String, the coordinate relative to the top-left corner of the item

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //double-click the first item whose text string is 'Arizona' at the coordinate (10,10)
 boolean success = ListView.ActivateUnverifiedTextItemCoords(Map.SAPDemo.ListView,"Arizona", "10;10");
 
 

SelectUnverifiedTextItem

public static boolean SelectUnverifiedTextItem(Component listview,
                                               java.lang.String text,
                                               int matchIndex)

Select (single click) an item value in ListView according to a full text without verification.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to select

matchIndex - int, allows to match item N in a list containing duplicate entries, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the 2th item whose text string is 'Arizona', will not verify "Arizona" is selected
 boolean success = ListView.SelectUnverifiedTextItem(Map.SAPDemo.ListView,"Arizona", 2);
 
 

SelectUnverifiedTextItem

public static boolean SelectUnverifiedTextItem(Component listview,
                                               java.lang.String text)

Select (single click) an item value in ListView according to a full text without verification. If there are more than one matched item, select the first one.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to select

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the first item whose text string is 'Arizona', will not verify "Arizona" is selected
 boolean success = ListView.SelectUnverifiedTextItem(Map.SAPDemo.ListView,"Arizona");
 
 

SelectUnverifiedTextItemCoords

public static boolean SelectUnverifiedTextItemCoords(Component listview,
                                                     java.lang.String text,
                                                     java.lang.String coords,
                                                     int matchIndex)

Select (single click) an item value in ListView according to a full text at specific coordinate without verification.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to select

coords - String, the coordinate relative to the top-left corner of the item

matchIndex - int, allows to match item N in a list containing duplicate entries, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the 2th item whose text string is 'Arizona' by clicking at (5,5) of the item.
 boolean success = ListView.SelectUnverifiedTextItemCoords(Map.SAPDemo.ListView,"Arizona", "5;5", 2);
 
 

SelectUnverifiedTextItemCoords

public static boolean SelectUnverifiedTextItemCoords(Component listview,
                                                     java.lang.String text,
                                                     java.lang.String coords)

Select (single click) an item value in ListView according to a full text at specific coordinate without verification.
If there are more than one matched item, select the first one.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to select

coords - String, the coordinate relative to the top-left corner of the item

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select the first item whose text string is 'Arizona' by clicking at (5,5) of the item.
 boolean success = ListView.SelectUnverifiedTextItemCoords(Map.SAPDemo.ListView,"Arizona", "5;5");
 
 

CaptureItemsToFile

public static boolean CaptureItemsToFile(Component listview,
                                         java.lang.String file,
                                         java.lang.String encoding)

Get all text value of items in ListView, and save them to a file.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

file - String, the name of file to save list items. It can be absolute or relative to Test directory.

encoding - String, the encoding used for output file

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //save text value of all listview items to a file "C:\\Temp\\listContents.txt", the file will be encoded as "UTF-8".
 boolean success = ListView.CaptureItemsToFile(Map.SAPDemo.ListView,"C:\\Temp\\listContents.txt", "UTF-8");
 //will be save to <TestProjectDir>/Actuals/listContents.txt
 boolean success = ListView.CaptureItemsToFile(Map.SAPDemo.ListView,"listContents.txt", "UTF-8");
 
 

CaptureItemsToFile

public static boolean CaptureItemsToFile(Component listview,
                                         java.lang.String file)

Get all text value of items in ListView, and save them to a file by system encoding.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

file - String, the name of file to save list items. It can be absolute or relative to Test directory.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //save text value of all listview items to a file "C:\\Temp\\listContents.txt", the file will be encoded as system-encoding.
 boolean success = ListView.CaptureItemsToFile(Map.SAPDemo.ListView,"C:\\Temp\\listContents.txt");
 //will be save to <TestProjectDir>/Actuals/listContents.txt
 boolean success = ListView.CaptureItemsToFile(Map.SAPDemo.ListView,"listContents.txt");
 
 

VerifyItemUnselected

public static boolean VerifyItemUnselected(Component listview,
                                           java.lang.String text)

Verify that an item is not selected in ListView.

See Detailed Reference

Parameters:

listview - Component, (from App Map) where to verify an item is not selected.

text - String, the case-sensitive text item to verify

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //verify "Arizona" is not selected
 boolean success = ListView.VerifyItemUnselected(Map.SAPDemo.ListView,"Arizona");
 
 

VerifyListContains

public static boolean VerifyListContains(Component listview,
                                         java.lang.String text)

Verify that an item is contained in ListView.

See Detailed Reference

Parameters:

listview - Component, (from App Map) where to verify an item is contained.

text - String, the case-sensitive text item to verify

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //verify "Arizona" is in listview
 boolean success = ListView.VerifyListContains(Map.SAPDemo.ListView,"Arizona");
 
 

VerifySelectedItem

public static boolean VerifySelectedItem(Component listview,
                                         java.lang.String text)

Verify that an item is selected in ListView.

See Detailed Reference

Parameters:

listview - Component, (from App Map) where to verify an item is selected.

text - String, the case-sensitive text item to verify

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //verify "Arizona" is selected
 boolean success = ListView.VerifySelectedItem(Map.SAPDemo.ListView,"Arizona");
 
 

ExtendSelectionToTextItem

public static boolean ExtendSelectionToTextItem(Component listview,
                                                java.lang.String text)

Shift+Click and Verify a selection according to its text value.

See Detailed Reference

Parameters:

listview - Component, (from App Map) where to select an item.

text - String, the case-sensitive text item to select

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select "Arizona"
 boolean success = ListView.SelectTextItem(Map.SAPDemo.ListView,"Arizona");
 //extend-select "Florida", which will select all items between "Arizona" and "Florida"
 boolean success = ListView.ExtendSelectionToTextItem(Map.SAPDemo.ListView,"Florida");
 
 

RightClickTextItem

public static boolean RightClickTextItem(Component listview,
                                         java.lang.String text,
                                         int matchIndex)

RightClick (single click) an item value in ListView according to a full text.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to click

matchIndex - int, allows to match item N in a list containing duplicate entries, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //RightClick the 2th item whose text string is 'Arizona'
 boolean success = ListView.RightClickTextItem(Map.SAPDemo.ListView,"Arizona", 2);
 
 

RightClickTextItem

public static boolean RightClickTextItem(Component listview,
                                         java.lang.String text)

RightClick (single click) an item value in ListView according to a full text. If there are more than one matched item, select the first one.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to click

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //RightClick the first item whose text string is 'Arizona'
 boolean success = ListView.RightClickTextItem(Map.SAPDemo.ListView,"Arizona");
 
 

RightClickTextItemCoords

public static boolean RightClickTextItemCoords(Component listview,
                                               java.lang.String text,
                                               java.lang.String coords,
                                               int matchIndex)

RightClick (single click) an item value in ListView according to a full text at specific coordinate.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to click

coords - String, the coordinate relative to the top-left corner of the item

matchIndex - int, allows to match item N in a list containing duplicate entries, 1-based.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //RightClick the 2th item whose text string is 'Arizona'
 boolean success = ListView.RightClickTextItemCoords(Map.SAPDemo.ListView,"Arizona", 2);
 
 

RightClickTextItemCoords

public static boolean RightClickTextItemCoords(Component listview,
                                               java.lang.String text,
                                               java.lang.String coords)

RightClick (single click) an item value in ListView according to a full text at specific coordinate.
If there are more than one matched item, select the first one.

See Detailed Reference

Parameters:

listview - Component, (from App Map) to select an item from.

text - String, the case-sensitive text item to click

coords - String, the coordinate relative to the top-left corner of the item

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //RightClick the first item whose text string is 'Arizona'
 boolean success = ListView.RightClickTextItemCoords(Map.SAPDemo.ListView,"Arizona");
 
 

SelectAnotherPartialMatch

public static boolean SelectAnotherPartialMatch(Component listview,
                                                java.lang.String partialText)

Control+Click on an item according to a partial text match.

See Detailed Reference

Parameters:

listview - Component, (from App Map) where to select an item.

partialText - String, the case-sensitive substring of text item to select

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select "Arizona"
 boolean success = ListView.SelectTextItem(Map.SAPDemo.ListView,"Arizona");
 //select item containing "Flori", which will select item "Florida" while keeping "Arizona" selected
 boolean success = ListView.SelectAnotherPartialMatch(Map.SAPDemo.ListView,"Flori");
 
 

SelectAnotherTextItem

public static boolean SelectAnotherTextItem(Component listview,
                                            java.lang.String text)

Control+Click on an item by its text value.

See Detailed Reference

Parameters:

listview - Component, (from App Map) where to select an item.

text - String, the case-sensitive text item to select

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //select "Arizona"
 boolean success = ListView.SelectTextItem(Map.SAPDemo.ListView,"Arizona");
 //select item containing "Florida", which will select item "Florida" while keeping "Arizona" selected
 boolean success = ListView.SelectAnotherTextItem(Map.SAPDemo.ListView,"Florida");
 
 

SetListContains

public static boolean SetListContains(Component listview,
                                      java.lang.String text,
                                      java.lang.String variable)

Set a variable with the result of checking that a listview contains the provided item.

See Detailed Reference

Parameters:

listview - Component, (from App Map) where to verify an item.

text - String, the case-sensitive text item to verify the existence

variable - String, the variable name to store the existence of an item. true or false.

Returns:

true if successful, false otherwise.

See Also:

SAFSPlus.prevResults, TestRecordData.getStatusCode(), TestRecordData.getStatusInfo()

Example:

 
 //verify if the item "Arizona" exists in the listview,
 //the variable "existence" will be set to 'true' if 'Arizona' exists; 'false' otherwise.
 boolean success = ListView.SetListContains(Map.SAPDemo.ListView, "Arizona", "existence");
 String result = GetVariableValue("existence");
 System.out.println("The existence of item 'Arizona' is "+result);