Skip to main content

Is Enabled

Checks if a Java UI element is enabled using the Java Access Bridge.

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​

  • Window Title - The title of the target window containing the Java application.
  • Window Handle - The handle (HWND) of the target window.
  • Full Path - The full path to the target element in the Java application's accessibility tree.

Options​

  • Wait Timeout (sec) - The maximum time (in seconds) to wait for the element to become available. Default is 5 seconds.

Output​

  • Enabled - A boolean value indicating whether the element is enabled (true) or disabled (false).

How It Works​

The Is Enabled node interacts with Java applications through the Java Access Bridge to check if a UI element is enabled. When executed, the node:

  1. Waits for the specified Java context to become available based on the Window Title, Window Handle, and Full Path
  2. If the element is found, it retrieves the element's state information using GetInfo().states
  3. Checks if the "enabled" state is present in the comma-separated list of states
  4. Returns true if the element is enabled, false otherwise
  5. If the element is not found, appropriate errors are thrown

Requirements​

  • Java Access Bridge must be enabled in the target Java application
  • The target Java application must be running and accessible
  • Valid Window Title, Window Handle, and Full Path to the target element

Error Handling​

The node will return specific errors in the following cases:

  • Element not found within the specified timeout period
  • General exceptions during execution

Usage Notes​

  • Ensure the Java Access Bridge is properly configured in your Java application
  • The Full Path should be obtained using Java accessibility tools or by inspecting the application's accessibility tree
  • The default timeout of 5 seconds can be adjusted based on application responsiveness
  • This node is useful for conditional logic in automation flows, allowing you to check if an element is interactable before attempting to interact with it
  • The enabled state corresponds to whether the element can accept user interaction such as clicks or text input