Skip to main content

Get Checkbox

Retrieves the checked state of a checkbox element.

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 checkbox.
  • Window Selector - The selector for identifying the target window.
  • Element Selector - The selector for identifying the checkbox element.

Output

  • Checked - Boolean value indicating whether the checkbox is checked (true) or unchecked (false).

How It Works

The Get Checkbox node retrieves the checked state of a checkbox element. When executed, the node:

  1. Uses the Window Selector and Element Selector to locate the target checkbox element
  2. Retrieves the TogglePattern of the element to determine its state
  3. Sets the output variable "Checked" to true if the checkbox is checked, false otherwise

Requirements

  • The target element must be a checkbox that supports the TogglePattern
  • Both Window Selector and Element Selector are required to identify the target element

Error Handling

The node will return specific errors in the following cases:

  • Empty or invalid Window Selector or Element Selector
  • Element not found
  • TogglePattern not supported by the element

Usage Notes

  • The output value can be used in conditional logic or stored for later use
  • This node only works with elements that implement the TogglePattern interface
  • The checked state is returned as a boolean value (true/false)