click list item

Click an item in a list control.
NameDescriptionTypeModifier
window

TA name of the window.

Interface EntityNone
list

TA name of the list control.

Interface ElementNone
item

The item to click, as specified by its text content or index value.

Important: 
For the list view control only, in order to click an item, enter the aggregated values of every cell value with vertical bars ( | ) as delimiters.

StringNone
x

(Optional) Horizontal position of effective click, specified as distance in pixels from left edge of item .

Default Value: horizontal center of the item.
StringNone
y

(Optional) Vertical position of effective click, specified as distance in pixels from top edge of item.

Default Value: vertical center of the item.
StringNone
None
This action may be used within the following project items: test modules and user-defined actions.
Desktop Web, Mobile App (Android Native), WPF, Java, .Net, Win32
This action is applicable to the following controls: list box, list view.
Example - Case 1: Use text value to click a list box item

Action lines
        
          	interface		
use interface	Car Rental		
	&nbsp		
	window	list	item
click list item	date and location	pickup state	California
&nbsp			
	window	control	item1

check selected items	date and location	pickup state	California
        
    
Result
Example - Case 2: Use numerical index value to click a list box item
Action lines
        
          	window	list	item
click list item	date and location	pickup state	6
&nbsp			
	window	control	item1
check selected items	date and location	pickup state	6
        
  
Result
Example - Case 3: Use text value to click a list view item


Action lines
        
          	window	list	item
click list item	library	songslistview	I'm Yours|Jason Mraz|5513|5:49|mp3|192
&nbsp			
	window	control	item1
check selected items	library	songslistview	I'm Yours|Jason Mraz|5513|5:49|mp3|192
        
    
Result
  • Built-in UI actions applied to iOS devices specify screen coordinates in points rather than pixels. (For further details, refer to the built-in action get screen resolution.)
  • item argument:
    • The item argument may be specified by either of two means: the displayed text of the item, or its numerical index. (Indexes are one-based. That is, numbering begins at 1)
    • Enclose a numerical text string in quotation marks to differentiate it from a numerical index value. For example, if a text value of an item in a control has a value of 12, you should reference that item by passing 12 surrounded by quotation marks (that is, “12”) instead of the numerical 12. Passing the numerical 12 is treated as a reference to an item with an index of 12, rather than an item holding a text string value of 12.
    • For list view controls only, to specify an item argument by its text content, enter the combined values of every cell, from left to right, with vertical bars ( | ) as delimiters.
  • x and y are unsupported arguments and hence invisible. To use them, you must specify both their values and the headers x and y, respectively, in the cells to the right of the last visible argument.
  • This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Copyright © 2023 LogiGear Corporation. All rights reserved. LogiGear is a registered trademark, and Action Based Testing and TestArchitect are trademarks of LogiGear Corporation. All other trademarks contained herein are the property of their respective owners.

LogiGear Corporation

1730 S. Amphlett Blvd. Suite 200, San Mateo, CA 94402

Tel: +1(800) 322-0333