Skip to main content

Move Window

Moves a window to a specified position on the screen.

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 to move.
  • Window Selector - The selector for identifying the target window.
  • X - The X coordinate (horizontal position) to move the window to.
  • Y - The Y coordinate (vertical position) to move the window to.

How It Works​

The Move Window node moves a window to a specified position on the screen. When executed, the node:

  1. Uses the Window Selector to locate the target window
  2. Retrieves the current size of the window
  3. Moves the window to the specified X, Y coordinates while maintaining its current size
  4. Ensures the window is visible by showing it

Requirements​

  • The window must be identifiable by the provided Window Selector
  • Valid X and Y coordinates must be provided

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Window Selector
  • Window not found
  • Invalid X or Y coordinates

Usage Notes​

  • The X and Y coordinates specify the top-left corner of the window
  • Coordinates are relative to the screen, not to other windows
  • The window's size remains unchanged - only its position is modified
  • If the specified coordinates would place the window partially off-screen, the system may adjust the position
  • This node is useful for organizing windows or ensuring they are visible in screenshots