Highlight
AutomatR.Windows.Activities.Highlight
The "Highlight" activity in AutomatR for Windows UI Automation visually highlights a specified UI element on the application. This activity is useful for debugging and visually identifying elements during the automation workflow.
Properties
| Name | Description |
|---|---|
| Input | |
| Windows Selector | A string defining the UI element to highlight. You can use the "Windows Selector" property or the "Windows Element" property to specify the UI element. |
| Windows Element | Select the browse button to indicate the element on the app with the help of the Window selector window. You can use this property instead of the "Windows Selector." |
| Misc | |
| Display Name | Provides a customizable name for the activity displayed in the workflow. String variables containing the desired display name. |
| Optional | |
| Timeout | Enter the time (in seconds) for the activity to be executed before throwing an exception. If not provided, the default timeout is used (e.g., 5 seconds). |
| Delay | Enter the wait time (in seconds) before starting the activity. This can be useful for handling synchronization issues. Default is 0 seconds. |
How to use:
- Drag and drop the "Highlight" activity onto the workflow.
- Configure the properties by either providing the Windows Selector or selecting the Windows Element with the help of the Window selector window.
- Optionally, set the timeout to control the maximum time for the activity to be executed before throwing an exception.
- Optionally, set the delay to wait before starting the highlight activity.
- Execute the workflow to visually highlight the specified UI element on the application.
Example: Consider an example where the "Highlight" activity is used to visually highlight a button on a Windows application:
Highlight:
Display Name: "Highlight Submit Button"
Windows Selector: "Button[name='SubmitButton']"
Timeout: 10
In this example, the activity visually highlights the UI element identified by the Windows Selector "Button[name='SubmitButton']" with a timeout of 10 seconds.