Skip to main content

Get details of window

Sophie avatar
Written by Sophie
Updated over 2 weeks ago

Definition and Usage

This command retrieves a specific attribute of a window such as its title or process name. It allows you to extract window information that can be used in subsequent actions or for conditional logic in your automation workflow.


Parameter Values

Input parameters

Parameter

Description

Possible Values

Required

Options / Notes

Get window by

Specify the window to get

Window object, Title or class, Window UI element

Yes

Determines how to identify the target window

Window

Select a window object that was obtained earlier

-

Yes (if "Window object" is selected)

Only shown when "Window object" is selected

Title

Enter title of the window

-

Yes (if "Title or class" is selected)

Only shown when "Title or class" is selected

Specify window class

Specify window class

-

No

Optional checkbox to enable class-based window identification

Class

Enter class name of the window

-

Yes (if "Specify window class" is checked)

Only shown when "Specify window class" is checked

Use RegEx

Use regular expressions like ^abc (starts with abc), \d+ (any numbers), or .*.csv$ (ends with .csv) to match specific text formats

-

No

Optional checkbox to enable regex matching for window title/class

Element

Select or capture an element to operate on

-

Yes (if "Window UI element" is selected)

Only shown when "Window UI element" is selected

Get

Select the attribute to get

Window title, Window text, Process name

Yes

Determines which window attribute to retrieve

Error handling

Parameter Name

Description

Throw error & stop

When an error occurs, the action will trigger an error and stop the execution of the entire app.

Retry command

If an error occurs, the action will retry the command in an attempt to resolve the issue and continue the process.

Ignore error & continue

When an error occurs, the action will be ignored, and the workflow will continue without interruption.

Variables produced

This action produces a variable that stores the window attribute (title, text, or process name) as specified in the "Save attribute as" parameter.


Using Variables in Conditions

You can use the output variable in subsequent actions by referencing it with curly braces {variableName}. The retrieved window attribute can be used for conditional logic, such as checking if a specific window is open or comparing window titles.


Notes

  • The window must be accessible when executing this command.

  • When using "Title or class" with regular expressions, ensure your pattern correctly matches the target window to avoid retrieving information from the wrong window.

  • If multiple windows match your criteria, the command will typically retrieve information from the first matching window.

  • The "Window text" option retrieves the visible text content of the window, which may differ from the window title.

Did this answer your question?