Skip to main content

Get Window

Description​

Gets the running window instance and returns its automation instance.

note

This activity requires an active display and an unlocked user session to simulate interactions with UI components successfully. For more detailed information, please refer to the relevant section in the Desktop Automation Notes.

Properties​

Input​

  • Get Window To Front – If True, bring the identified Window to the foreground. By default, it is considered False.

  • Search Window Continuously – If True, it searches for the window until it finds. It will be a continuous search.

    or​

  • Search Window Time Limit – If specified, indicates the time limit to search the Window. If not found, the activity aborts with Window not found error. By default, the time limit is set to 5 seconds.

  • Specific Window – If True, searches for the Window specified in the Search Parameters or Window Title. Otherwise, it returns the currently active window instance. By default, it is considered True.

  • Window Title – Holds the title of the window identified through Window Selector. You can also type in the title to identify the window for automation.

  • Search Parameters – Holds the information of the UI element identified through Element Selector.

Output​

  • ** Window** – If Window found, it would return its automation instance. Otherwise, it would return null.

Misc​

  • DisplayName – The display name of the activity.

  • Private – If selected, the variables and argument values will no longer be logged at the Verbose level.

Optional​

  • Continue On Error – It Specifies whether the automation should continue even when the activity throws an error. If True, the activity continues without throwing any exceptions. If False, the activity throws an exception. The default value is False.

Note: If this activity is present inside the Try-Catch block, and the value of this property is True, no error would be caught.

Example​

Download Example (C#)