[Windows] Click Element Offset

Description

Performs a click action at the given offset of the Windows Element (relative to its top-left corner) that is found by using locator value of the given windowsObject.

Keyword name: clickElementOffset

Notes on Behavior and Recording Support

• Starting from Katalon Studio 10.3.0, the offset is calculated from the center of the element (x = width / 2, y = height / 2) instead of the top-left corner (x = 0, y = 0) as in earlier versions (e.g., KS 9.x). This update follows the W3C WebDriver specification and ensures consistency with WebUI offset-based keywords.
• Katalon Studio 10.3.0 also upgrades from Selenium 3 to Selenium 4. If you use custom keywords that directly access the driver object io.appium.java_client.windows.WindowsDriver, you may need to update your code to comply with the Selenium 4 API.
• In Windows Recorder, you can enable coordinate-based recording to interact with elements using offset-based clicks.
  • When enabled, click and rightClick actions are recorded as clickElementOffset and rightClickElementOffset, respectively.
  • The clickElementOffset action is available under the Possible Actions panel in the Recorder interface.

Parameters

Parameter	Parameter Type	Required	Description
windowsObject	WindowsTestObject	Yes	An object describing the locator and locator strategy to find a Windows element.
offsetX	Integer	Yes	The horizontal offset from the element’s center (KS 10.3.0+) or top-left (KS 9.x).
offsetY	Integer	Yes	The vertical offset from the element’s center (KS 10.3.0+) or top-left (KS 9.x).
flowControl	FailureHandling	Optional	Specify failure handling schema to determine whether the execution should be allowed to continue or stop.

Example

Windows.startApplicationWithTitle('katalon.exe', 'Katalon Studio')
'Wait for Katalon help tab to be present'
Windows.waitForElementPresent(findWindowsObject('TabItem'), 10)
'Click on X button using Click Element Offset, the coordinate is retrieved by cropping the tab and use https://www.mobilefish.com/services/record_mouse_coordinates/record_mouse_coordinates.php to extract the coordinates.'
Windows.clickElementOffset(findWindowsObject('TabItem'), 107, 13)
'Katalon Help tab is closed successfully as a result of clicking on X button'
Windows.verifyElementNotPresent(findWindowsObject('Object Repository/TabItem'), 5)
Windows.closeApplication()
'Click on OK to really close Katalon Studio'
Windows.click(findWindowsObject('Close Katalon Button'))