Get Text Action—Setting Properties

The Get Text action is used to populate a variable with the text contents of a control in a window. The variable must be created in an earlier step using the Create Variable action. Where it can be used, this action is superior to the Copy action because it communicates natively with the target control, and the application is not required to be in the foreground.

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

To set Get Text properties

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

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

  3. If possible, open the window containing the object you want to use. Then drag the AutoMate icon to the object. This will automatically populate the object description. If you cannot use the actual object, use a similar object 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 and use the tree structure 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:

The properties are as follows:

  1. In the Get text from box, select value property, name property, or auto-detect. (The Object Description section shows the name and value for the selected object.)

  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

Get Text Action