Select List Item Action—Setting Properties

The Select List Item action is used to select one or more items in a list box or list view. You can select all items in the list, limit the selection to items containing a particular text string, or select according to the position of the item on the list.

Important: Only standard Windows controls will work with the Select List Item action. Many applications use images or other controls that may act like Windows controls but do not support the interfaces required to detect them. The Select List Item action will not work with these controls. In these cases other interactivity actions must be used, such as the Move Mouse and Click Mouse actions.  

To enter Select List Item properties

  1. From the Task Builder Available Actions pane, open the Interactivity folder and double-click the Select List Item action or drag it into the Steps pane.

  2. In the Action box, select one of the following:

  3. If you did not choose Select all items as the action, in the Text (or index) of item to select box, enter the text to look for or the index number. Use wildcard characters asterisk (*) or question mark (?) when entering partial item text. For example *.doc would designate any or all items ending with .doc.

  4. If possible, open the window containing the list you want to use. Then drag the AutoMate icon to the list. This will automatically populate the object description. If you cannot use the actual window containing the list, use a similar one and then edit the object description per the next step. You can also drag the AutoMate icon to the window that contains the list, and then click the Browse button and use the tree structure to find and select the object.

  5. If you need to make changes to the auto-populated properties, click Edit and change the properties according to the following guidelines:

The properties are as follows:

  1. If you are adding the selection to one or more selections made in previous steps, click the Advanced tab and select Add item to current selection.

    This operates like holding down the CTRL key and clicking multiple items in a list.

  2. To set the Description tab properties, refer to Description Tab Options.

  3. To set the Error Causes and On Error tab properties, refer to Step Error Handling.

  4. When finished, click OK to save settings and close the properties dialog window.

See Also

About Actions

Adding Task Steps

Select List Item Action