[Windows] Right-click Element Offset

Description

Performs a right-click action at the provided offset on the WebElement that is found by using locator value of the given windowsObject.

Keyword name: rightClickElementOffset

Note:

• In Native Windows Recorder, enable coordinate-based recording in the window. click and rightClick actions are recorded as clickElementOffset and rightClickElementOffset actions respectively.

• In Windows Recorder, Click Element Offset and Right-click Element Offset buttons are supported in Possible Actions.

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 relative to the top-left corner of the element.
offsetY	Integer	Yes	The vertical offset relative to the top-left corner of the element.
flowControl	FailureHandling	Optional	Specify failure handling schema to determine whether the execution should be allowed to continue or stop.

Returns

Parameter Type	Description
StepFailedExecution	Throws an error if the Windows element doesn't exist, or Katalon Studio could not perform a click action on the element.

Example

Windows.startApplicationWithTitle('katalon.exe', 'Katalon Studio')
'Wait for Katalon help tab to be present'
Windows.waitForElementPresent(findWindowsObject('TabItem'), 10)
'Right click on the tab'
Windows.rightClickElementOffset(findWindowsObject('TabItem'), 107, 13)
'Switch to the context menu'
Windows.switchToApplication();
'Click on the context menu item'
Windows.click(findWindowsObject('ContextMenuItem'))
'Verify clicking on Close in context menu closes the tab'
Windows.verifyElementNotPresent(findWindowsObject('Object Repository/TabItem'), 5)
Windows.closeApplication()
'Click on OK to really close Katalon Studio'
Windows.click(findWindowsObject('Close Katalon Button'))