Get Selected Tree Item—Setting Properties

The Get Selected Tree Item action is used to populate a variable or dataset with the contents a selected item in a tree view. This action is ordinarily preceded by a Select Tree Item action. Any variable used must be created in an earlier step using the Create Variable action.

If you populate a dataset with the tree item, the fields will show the text, level, and index for both the item and its parent, plus whether or not the tree view is expanded.

Important: Only standard Windows controls will work with the Get Selected Tree 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 Get Selected Tree Item action will not work with these controls. In these cases other interactivity actions must be used such as the Copy action.

To set Get Selected Tree Item properties

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

  2. To populate a variable with the text of the item, select the variable in the Populate variable with text box.

  3. If possible, open the window containing the tree you want to use. Then drag the AutoMate icon to the tree view. This will automatically populate the object description. If you cannot use the actual window containing the tree view, 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 object, and then click the Browse button to find and select the object.

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

See Also

About Actions

Adding Task Steps

Get Selected Tree Item Action

About Datasets