Loop List Control Action—Setting Properties

The Loop List Control action is used to loop through a list control, such as a Windows Explorer file list,  and populate a variable with the items on the list. This action is used to perform some action on a group of items listed in a window.

The list control must be a standard Windows list control. Some programs may have list structures that look and function in a similar way, but if it is not a standard Windows list control, it will not work with this action. The window containing the list control must be open when the step runs.

When the Loop List Control step is created, an End Loop step is created automatically. Place the steps to be performed on the list items between the Loop List Control step and the End Loop step. The steps within the block should be indented for visual clarity.

To set Loop List Control properties

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

  2. In the Populate variable with item text box, select the variable to populate.

  3. Open the window that contains the control, and display the list control you want to use.

  4. Drag the AutoMate icon from the Loop List Control dialog box into the list control.

    A black outline appears around the list control when it is selected. When you release the mouse button, the dialog box is automatically populated with the list control specifications.

  5. To change any of the list control specifications, click the Edit button and edit the specifications as needed.

  6. To sort or limit the output from the list, click the Advanced tab and enter the properties as follows:

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

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

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

To auto-indent after all steps are added

  1. In the Task Builder Steps pane, hold down SHIFT and click the first and last steps in the block so that the complete block of steps is selected.

  2. Click the Format button .

See Also

About Actions

Adding Task Steps

Loop List Control Action