Screenshot

Takes a screenshot of a specified UI element and saves it to a file.

Common Properties

• Name - The custom name of the node.
• Color - The custom color of the node.
• Delay Before (sec) - Waits in seconds before executing the node.
• Delay After (sec) - Waits in seconds after executing node.
• Continue On Error - Automation will continue regardless of any error. The default value is false.

info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs

• Handle - The handle of the window containing the element.
• Window Selector - The selector for identifying the target window.
• Element Selector - The selector for identifying the target element.
• File Path - The full path where the screenshot image will be saved.

How It Works

The Screenshot node captures an image of a specified UI element and saves it to a file. When executed, the node:

1. Uses the Window Selector and Element Selector to locate the target element
2. Determines the bounding rectangle (position and size) of the element
3. Captures a screenshot of the element's area
4. Saves the screenshot to the specified file path

Requirements

• Both Window Selector and Element Selector are required to identify the target element
• A valid file path must be provided
• The target element must be visible on screen

Error Handling

The node will return specific errors in the following cases:

• Empty or invalid Window Selector or Element Selector
• Element not found
• Invalid file path
• Unable to capture screenshot (element not visible, etc.)

Usage Notes

• The file path should include the full directory path and filename with extension
• Supported image formats depend on the system implementation
• The screenshot captures the visual appearance of the element at the time of execution
• If the element is partially obscured, the screenshot will show the obscured portions as well
• This node is useful for documentation, debugging, or visual verification of UI states