WindowsBuiltinKeywords (Katalon Studio API Specification)

com.kms.katalon.core.windows.keyword.WindowsBuiltinKeywords

public class WindowsBuiltinKeywords
extends BuiltinKeywords

Methods Summary

Methods
Type Params	Return Type	Name and description
	`public static void`	`clearText(WindowsTestObject windowsObject)` Clears text content of the WebElement that is found by using locator value of the given windowsObject.
	`public static void`	`clearText(WindowsTestObject windowsObject, FailureHandling flowControl)` Clears text content of the WebElement that is found by using locator value of the given windowsObject.
	`public static void`	`click(WindowsTestObject windowsObject)` Performs a click action on the WebElement that is found by using locator value of the given windowsObject.
	`public static void`	`click(WindowsTestObject windowsObject, FailureHandling flowControl)` Performs a click action on the WebElement that is found by using locator value of the given windowsObject.
	`public static void`	`clickElementOffset(WindowsTestObject windowsObject, int offsetX, int offsetY)` 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.
	`public static void`	`clickElementOffset(WindowsTestObject windowsObject, int offsetX, int offsetY, FailureHandling flowControl)` Performs a click action at the given offset on the windows element (relative to its top-left corner) that is found by using locator value of the given windowsObject.
	`public static void`	`closeApplication()` Fires the Close event of the running application to the Windows System.
	`public static void`	`doubleClick(WindowsTestObject windowsObject)` Performs a double-click action on the WebElement that is found by using locator value of the given windowsObject.
	`public static void`	`doubleClick(WindowsTestObject windowsObject, FailureHandling flowControl)` Performs a double-click action on the WebElement that is found by using locator value of the given windowsObject.
	`public static WebElement`	`findElement(WindowsTestObject windowsObject, FailureHandling flowControl)` Finds element by using locator value of the given windowsObject.
	`public static WebElement`	`findElement(WindowsTestObject windowsObject)` Finds element by using locator value of the given windowsObject.
	`public static List<WebElement>`	`findElements(WindowsTestObject windowsObject, FailureHandling flowControl)` Finds elements by using locator value of the given windowsObject.
	`public static List<WebElement>`	`findElements(WindowsTestObject windowsObject)` Finds elements by using locator value of the given windowsObject.
	`public static String`	`getAttribute(WindowsTestObject windowsObject, String attribute, FailureHandling flowControl)` Gets attribute value of a Windows element.
	`public static String`	`getAttribute(WindowsTestObject windowsObject, String attribute)` Gets attribute value of a Windows element.
	`public static WindowsDriver<WebElement>`	`getDriver()` Gets the current Windows Driver.
	`public static Point`	`getElementPosition(WindowsTestObject windowsObject, FailureHandling flowControl)` Get the position of the WebElement that is found by using locator value of the given windowsObject.
	`public static Point`	`getElementPosition(WindowsTestObject windowsObject)` Get the position of the WebElement that is found by using locator value of the given windowsObject.
	`public static Rectangle`	`getElementRect(WindowsTestObject windowsObject, FailureHandling flowControl)` Get the bounding rectangle of the WebElement that is found by using locator value of the given windowsObject.
	`public static Rectangle`	`getElementRect(WindowsTestObject windowsObject)` Get the bounding rectangle of the WebElement that is found by using locator value of the given windowsObject.
	`public static String`	`getText(WindowsTestObject windowsObject)` Gets text content of the WebElement that is found by using locator value of the given windowsObject.
	`public static String`	`getText(WindowsTestObject windowsObject, FailureHandling flowControl)` Gets text content of the WebElement that is found by using locator value of the given windowsObject.
	`public static void`	`rightClick(WindowsTestObject windowsObject)` Performs a right-click action on the WebElement that is found by using locator value of the given windowsObject.
	`public static void`	`rightClick(WindowsTestObject windowsObject, FailureHandling flowControl)` Performs a right-click action on the WebElement that is found by using locator value of the given windowsObject.
	`public static void`	`rightClickElementOffset(WindowsTestObject windowsObject, int offsetX, int offsetY)` Performs a right-click action at the provided offset on the windows element that is found by using locator value of the given windowsObject.
	`public static void`	`rightClickElementOffset(WindowsTestObject windowsObject, int offsetX, int offsetY, FailureHandling flowControl)` Performs a right-click action at the provided offset on the windows element that is found by using locator value of the given windowsObject.
	`public static void`	`sendKeys(WindowsTestObject windowsObject, String strKeys, FailureHandling flowControl)` Simulates keystroke events on the specified element, as though you typed the value key-by-key
	`public static void`	`sendKeys(WindowsTestObject windowsObject, String strKeys)` Simulates keystroke events on the specified element, as though you typed the value key-by-key
	`public static void`	`setEncryptedText(WindowsTestObject windowsObject, String encryptedText)` Performs a set text action on the WebElement that is found by using locator value of the given windowsObject.
	`public static void`	`setEncryptedText(WindowsTestObject windowsObject, String encryptedText, FailureHandling flowControl)` Performs a set text action on the WebElement that is found by using locator value of the given windowsObject.
	`public static void`	`setText(WindowsTestObject windowsObject, String text)` Performs a set text action on the WebElement that is found by using locator value of the given windowsObject.
	`public static void`	`setText(WindowsTestObject windowsObject, String text, FailureHandling flowControl)` Performs a set text action on the WebElement that is found by using locator value of the given windowsObject.
	`public static void`	`startApplication(String appFile)` Starts Windows driver and starts the Windows application at the given absolute path.
	`public static void`	`startApplication(String appFile, FailureHandling flowControl)` Starts Windows driver and starts the Windows application at the given absolute path.
	`public static void`	`startApplicationWithTitle(String appFile, String windowTitle, FailureHandling flowControl)` Starts Windows driver and starts the Windows application at the given absolute path.
	`public static void`	`startApplicationWithTitle(String appFile, String windowTitle, StringMatchingStrategy matchingStrategy, FailureHandling flowControl)` Starts Windows driver and starts the Windows application at the given absolute path.
	`public static void`	`startApplicationWithTitle(String appFile, String windowTitle)` Starts Windows driver and starts the Windows application at the given absolute path.
	`public static void`	`startApplicationWithTitle(String appFile, String windowTitle, StringMatchingStrategy matchingStrategy)` Starts Windows driver and starts the Windows application at the given absolute path.
	`public static void`	`switchToApplication()` Switches the current running driver to the application WindowsDriver.
	`public static void`	`switchToApplication(FailureHandling flowControl)` Switches the current running driver to the application WindowsDriver.
	`public static void`	`switchToDesktop()` Switches the current running driver to desktop session of Windows Driver.
	`public static void`	`switchToDesktop(FailureHandling flowControl)` Switches the current running driver to desktop session of Windows Driver.
	`public static WindowsDriver<WebElement>`	`switchToWindow(WindowsTestObject windowsObject, FailureHandling flowControl)` Finds and attaches the opening application window that describes by the given windowsObject to the working WindowsDriver session on the current desktop.
	`public static WindowsDriver<WebElement>`	`switchToWindow(WindowsTestObject windowsObject)` Finds and attaches the opening application window that describes by the given windowsObject to the working WindowsDriver session on the current desktop.
	`public static WindowsDriver<WebElement>`	`switchToWindowTitle(String windowTitle, FailureHandling flowControl)` Finds and switches the opening application window to the working WindowsDriver session on the current desktop by the given title in the preset timeout (120 seconds by default).
	`public static WindowsDriver<WebElement>`	`switchToWindowTitle(String windowTitle, StringMatchingStrategy matchingStrategy, FailureHandling flowControl)` Finds and switches the opening application window to the working WindowsDriver session on the current desktop by the given title in the preset timeout (120 seconds by default).
	`public static WindowsDriver<WebElement>`	`switchToWindowTitle(String windowTitle)` Finds and switches the opening application window to the working WindowsDriver session on the current desktop by the given title in the preset timeout (120 seconds by default).
	`public static WindowsDriver<WebElement>`	`switchToWindowTitle(String windowTitle, StringMatchingStrategy matchingStrategy)` Finds and switches the opening application window to the working WindowsDriver session on the current desktop by the given title in the preset timeout (120 seconds by default).
	`public static boolean`	`verifyElementAttributeValue(WindowsTestObject windowsObject, String attributeName, String attributeValue, int timeout, FailureHandling flowControl)` Waits until the given element has an attribute with the specific name and value within the given time in second unit.
	`public static boolean`	`verifyElementAttributeValue(WindowsTestObject windowsObject, String attributeName, String attributeValue, int timeout)` Waits until the given element has an attribute with the specific name and value within the given time in second unit.
	`public static boolean`	`verifyElementNotPresent(WindowsTestObject windowsObject, int timeout, FailureHandling flowControl)` Waits until the given element not to present (disappear) within the given time in second unit.
	`public static boolean`	`verifyElementNotPresent(WindowsTestObject windowsObject, int timeout)` Waits until the given element not to present (disappear) within the given time in second unit.
	`public static boolean`	`verifyElementPresent(WindowsTestObject windowsObject, int timeout, FailureHandling flowControl)` Waits until the given element to present (appear) within the given time in second unit.
	`public static boolean`	`verifyElementPresent(WindowsTestObject windowsObject, int timeout)` Waits until the given element to present (appear) within the given time in second unit.
	`public static boolean`	`waitForElementAttributeValue(WindowsTestObject windowsObject, String attributeName, String attributeValue, int timeout, FailureHandling flowControl)` Waits until the given element has an attribute with the specific name and value within the given time in second unit.
	`public static boolean`	`waitForElementAttributeValue(WindowsTestObject windowsObject, String attributeName, String attributeValue, int timeout)` Waits until the given element has an attribute with the specific name and value within the given time in second unit.
	`public static boolean`	`waitForElementNotPresent(WindowsTestObject windowsObject, int timeout, FailureHandling flowControl)` Waits for the given element not to present (disappear) within the given time in second unit.
	`public static boolean`	`waitForElementNotPresent(WindowsTestObject windowsObject, int timeout)` Waits for the given element not to present (disappear) within the given time in second unit.
	`public static boolean`	`waitForElementPresent(WindowsTestObject windowsObject, int timeout, FailureHandling flowControl)` Waits for the given element to present (appear) within the given time in second unit.
	`public static boolean`	`waitForElementPresent(WindowsTestObject windowsObject, int timeout)` Waits for the given element to present (appear) within the given time in second unit.

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class BuiltinKeywords`	`callTestCase, callTestCase, comment, concatenate, concatenate, delay, delay, verifyCheckpoint, verifyCheckpoint, verifyEqual, verifyEqual, verifyGreaterThan, verifyGreaterThan, verifyGreaterThanOrEqual, verifyGreaterThanOrEqual, verifyLessThan, verifyLessThan, verifyLessThanOrEqual, verifyLessThanOrEqual, verifyMatch, verifyMatch, verifyNotEqual, verifyNotEqual, verifyNotMatch, verifyNotMatch`

- Method Detail
  - @Keyword(keywordObject = "Element") public static void clearText(WindowsTestObject windowsObject)
    
    Clears text content of the WebElement that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not clear text of the element.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static void clearText(WindowsTestObject windowsObject, FailureHandling flowControl)
    
    Clears text content of the WebElement that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not get text of the element.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static void click(WindowsTestObject windowsObject)
    
    Performs a click action on the WebElement that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform click action on the element.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static void click(WindowsTestObject windowsObject, FailureHandling flowControl)
    
    Performs a click action on the WebElement that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform click action on the element.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static void clickElementOffset(WindowsTestObject windowsObject, int offsetX, int offsetY)
    
    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.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform click action on the element.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    offsetX - The horizontal offset relative to the top-left corner of the element.
    offsetY - The vertical offset relative to the top-left corner of the element.
    Since:
    7.7.5
  - @Keyword(keywordObject = "Element") public static void clickElementOffset(WindowsTestObject windowsObject, int offsetX, int offsetY, FailureHandling flowControl)
    
    Performs a click action at the given offset on the windows element (relative to its top-left corner) that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform click action on the element.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    offsetX - The horizontal offset relative to the top-left corner of the element.
    offsetY - The vertical offset relative to the top-left corner of the element.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.7.5
  - @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void closeApplication()
    
    Fires the Close event of the running application to the Windows System.
    This action is similar to pressing 'ALT + F4' and also does not force close the application.
    If the application shows a confirmation to close, users need to do some extra steps to actually close the application.
    throws:
    StepFailedException If KS could not close the Windows Driver.
    
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static void doubleClick(WindowsTestObject windowsObject)
    
    Performs a double-click action on the WebElement that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform double-click action on the element.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static void doubleClick(WindowsTestObject windowsObject, FailureHandling flowControl)
    
    Performs a double-click action on the WebElement that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform double-click action on the element.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static WebElement findElement(WindowsTestObject windowsObject, FailureHandling flowControl)
    
    Finds element by using locator value of the given windowsObject.
    throws:
    StepFailedException If KS could not find any element.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    The found element.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static WebElement findElement(WindowsTestObject windowsObject)
    
    Finds element by using locator value of the given windowsObject.
    throws:
    StepFailedException If KS could not find any element.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    Returns:
    The found element.
    Since:
    7.0.0
  - @SuppressWarnings("unchecked") @Keyword(keywordObject = "Element") public static List<WebElement> findElements(WindowsTestObject windowsObject, FailureHandling flowControl)
    
    Finds elements by using locator value of the given windowsObject.
    throws:
    StepFailedException If KS could not find any element.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Elements.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    The found elements.
    Since:
    7.0.0
  - @SuppressWarnings("unchecked") @Keyword(keywordObject = "Element") public static List<WebElement> findElements(WindowsTestObject windowsObject)
    
    Finds elements by using locator value of the given windowsObject.
    throws:
    StepFailedException If KS could not find any element.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Elements.
    Returns:
    The found elements.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static String getAttribute(WindowsTestObject windowsObject, String attribute, FailureHandling flowControl)
    
    Gets attribute value of a Windows element.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not get value of the element's attribute.
    throws:
    IllegalArgumentException If windowsObject or attribute is null.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows element.
    attribute - Name of the attribute, not null.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    Value of the attribute
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static String getAttribute(WindowsTestObject windowsObject, String attribute)
    
    Gets attribute value of a Windows element.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not get value of the element's attribute.
    throws:
    IllegalArgumentException If windowsObject or attribute is null.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows element.
    attribute - Name of the attribute, not null.
    Returns:
    Value of the attribute
    Since:
    7.6.0
  - @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> getDriver()
    
    Gets the current Windows Driver.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static Point getElementPosition(WindowsTestObject windowsObject, FailureHandling flowControl)
    
    Get the position of the WebElement that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If KS could not find the specified element.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    The element's position.
    Since:
    7.2.0
  - @Keyword(keywordObject = "Element") public static Point getElementPosition(WindowsTestObject windowsObject)
    
    Get the position of the WebElement that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If KS could not find the specified element.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    Returns:
    The element's position.
    Since:
    7.2.0
  - @Keyword(keywordObject = "Element") public static Rectangle getElementRect(WindowsTestObject windowsObject, FailureHandling flowControl)
    
    Get the bounding rectangle of the WebElement that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If KS could not find the specified element.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    The element's bounding rectangle.
    Since:
    7.2.0
  - @Keyword(keywordObject = "Element") public static Rectangle getElementRect(WindowsTestObject windowsObject)
    
    Get the bounding rectangle of the WebElement that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If KS could not find the specified element.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    Returns:
    The element's bounding rectangle.
    Since:
    7.2.0
  - @Keyword(keywordObject = "Element") public static String getText(WindowsTestObject windowsObject)
    
    Gets text content of the WebElement that is found by using locator value of the given windowsObject.
    This action will append the given text on the element and doesn't clear the current text of the element.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not get text of the element.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static String getText(WindowsTestObject windowsObject, FailureHandling flowControl)
    
    Gets text content of the WebElement that is found by using locator value of the given windowsObject.
    This action will append the given text on the element and doesn't clear the current text of the element.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not get text of the element.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static void rightClick(WindowsTestObject windowsObject)
    
    Performs a right-click action on the WebElement that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform right-click action on the element.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static void rightClick(WindowsTestObject windowsObject, FailureHandling flowControl)
    
    Performs a right-click action on the WebElement that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform right-click action on the element.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static void rightClickElementOffset(WindowsTestObject windowsObject, int offsetX, int offsetY)
    
    Performs a right-click action at the provided offset on the windows element that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform click action on the element.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    offsetX - The horizontal offset relative to the top-left corner of the element.
    offsetY - The vertical offset relative to the top-left corner of the element.
    Since:
    7.7.5
  - @Keyword(keywordObject = "Element") public static void rightClickElementOffset(WindowsTestObject windowsObject, int offsetX, int offsetY, FailureHandling flowControl)
    
    Performs a right-click action at the provided offset on the windows element that is found by using locator value of the given windowsObject.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform click action on the element.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    offsetX - The horizontal offset relative to the top-left corner of the element.
    offsetY - The vertical offset relative to the top-left corner of the element.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.7.5
  - @Keyword(keywordObject = "Element") public static void sendKeys(WindowsTestObject windowsObject, String strKeys, FailureHandling flowControl)
    
    Simulates keystroke events on the specified element, as though you typed the value key-by-key
    throws:
    StepFailedException
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    strKeys - The combination of keys to type
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static void sendKeys(WindowsTestObject windowsObject, String strKeys)
    
    Simulates keystroke events on the specified element, as though you typed the value key-by-key
    throws:
    StepFailedException
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    strKeys - The combination of keys to type
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static void setEncryptedText(WindowsTestObject windowsObject, String encryptedText)
    
    Performs a set text action on the WebElement that is found by using locator value of the given windowsObject.
    This action will clear the current text and append the new encrypted text on the element.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform set text action on the element.
    throws:
    IllegalArgumentException If windowsObject or encryptedText is null.
    throws:
    ArrayIndexOutOfBoundsException If something went wrong while decoding encryptedText. Encrypted test was an invalid format. Please check your encrypted text with Help > Encrypt Text on the Main Menu.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows element.
    encryptedText - The encrypted text content to set on the element, not null.
    
    Throws ArrayIndexOutOfBoundsException if something went wrong while decoding encryptedText.
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static void setEncryptedText(WindowsTestObject windowsObject, String encryptedText, FailureHandling flowControl)
    
    Performs a set text action on the WebElement that is found by using locator value of the given windowsObject.
    This action will clear the current text and append the new encrypted text on the element.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform set text action on the element.
    throws:
    IllegalArgumentException If windowsObject or encryptedText is null.
    throws:
    ArrayIndexOutOfBoundsException If something went wrong while decoding encryptedText. Encrypted test was an invalid format. Please check your encrypted text with Help > Encrypt Text on the Main Menu.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows element.
    encryptedText - The encrypted text content to set on the element, not null.
    
    Throws ArrayIndexOutOfBoundsException if something went wrong while decoding encryptedText.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static void setText(WindowsTestObject windowsObject, String text)
    
    Performs a set text action on the WebElement that is found by using locator value of the given windowsObject.
    This action will clear the current text and append the given text on the element.
    throws:
    StepFailedException If the windowsObject doesn't exist, or KS could not perform set text action on the element.
    throws:
    IllegalArgumentException If the windowsObject is null.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    text - The text content to set on the element.
    Since:
    7.0.0
  - @Keyword(keywordObject = "Element") public static void setText(WindowsTestObject windowsObject, String text, FailureHandling flowControl)
    
    Performs a set text action on the WebElement that is found by using locator value of the given windowsObject.
    This action will clear the current text and append the given text on the element.
    throws:
    StepFailedException If the Windows element doesn't exist, or KS could not perform set text action on the element.
    throws:
    IllegalArgumentException If the windowsObject is null.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find Windows Element.
    text - The text content to set on the element.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.0.0
  - @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void startApplication(String appFile)
    
    Starts Windows driver and starts the Windows application at the given absolute path.
    throws:
    StepFailedException If KS could not start Windows Driver, could not start the application or the application file doesn't exist.
    
    Parameters:
    appFile - Absolute path to the Windows application.
    Since:
    7.0.0
  - @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void startApplication(String appFile, FailureHandling flowControl)
    
    Starts Windows driver and starts the Windows application at the given absolute path.
    throws:
    StepFailedException If KS could not start Windows Driver, could not start the application or the application file doesn't exist.
    Parameters:
    appFile - Absolute path to the Windows application.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.0.0
  - @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void startApplicationWithTitle(String appFile, String windowTitle, FailureHandling flowControl)
    
    Starts Windows driver and starts the Windows application at the given absolute path. After the application starts, if WinAppDriver cannot not detect the main application window correctly, Katalon Studio will use the given windowTitle in the preset timeout (120 seconds by default) to find the opened application to continue working.
    Since 7.5.5, you can change the application title waiting timeout by changing: WindowsActionSettings.DF_WAIT_ACTION_TIMEOUT_IN_MILLIS
    throws:
    StepFailedException If KS could not start Windows Driver, could not start the application, the application file doesn't exist or there is no application maches with the given windowTitle
    
    Parameters:
    appFile - Absolute path to the Windows application.
    windowTitle - Title or name of the opening application windows. Full text, partial text, or regular expression input is acceptable.
    Since:
    7.1.0
  - @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void startApplicationWithTitle(String appFile, String windowTitle, StringMatchingStrategy matchingStrategy, FailureHandling flowControl)
    
    Starts Windows driver and starts the Windows application at the given absolute path. After the application starts, if WinAppDriver cannot not detect the main application window correctly, Katalon Studio will use the given windowTitle in the preset timeout (120 seconds by default) to find the opened application to continue working.
    Since 7.5.5, you can change the application title waiting timeout by changing: WindowsActionSettings.DF_WAIT_ACTION_TIMEOUT_IN_MILLIS
    throws:
    StepFailedException If KS could not start Windows Driver, could not start the application, the application file doesn't exist or there is no application maches with the given windowTitle
    Parameters:
    appFile - Absolute path to the Windows application.
    windowTitle - Title or name of the opening application windows. Full text, partial text, or regular expression input is acceptable.
    matchingStrategy - Specifies the strategy to match the windowTitle parameter against the actual window title. Allowed values are:
    
    StringMatchingStrategy#CONTAINS#CONTAINS: (default value) The windowTitle parameter should be a substring of the actual window title.
    
    StringMatchingStrategy#REGEXP#REGEXP: The windowTitle parameter should be a valid regular expression pattern that matches the actual window title.
    
    StringMatchingStrategy#EXACT#EXACT: The windowTitle parameter should exactly match the actual window title.
    Since:
    7.1.0
  - @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void startApplicationWithTitle(String appFile, String windowTitle)
    
    Starts Windows driver and starts the Windows application at the given absolute path. After the application starts, if WinAppDriver cannot not detect the main application window correctly, Katalon Studio will use the given windowTitle in the preset timeout (120 seconds by default) to find the opened application to continue working.
    Since 7.5.5, you can change the application title waiting timeout by changing: WindowsActionSettings.DF_WAIT_ACTION_TIMEOUT_IN_MILLIS
    throws:
    StepFailedException If KS could not start Windows Driver, could not start the application, the application file doesn't exist or there is no application maches with the given windowTitle
    
    Parameters:
    appFile - Absolute path to the Windows application.
    windowTitle - Title or name of the opening application windows. Full text, partial text, or regular expression input is acceptable.
    Since:
    7.1.0
  - @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void startApplicationWithTitle(String appFile, String windowTitle, StringMatchingStrategy matchingStrategy)
    
    Starts Windows driver and starts the Windows application at the given absolute path. After the application starts, if WinAppDriver cannot not detect the main application window correctly, Katalon Studio will use the given windowTitle in the preset timeout (120 seconds by default) to find the opened application to continue working.
    Since 7.5.5, you can change the application title waiting timeout by changing: WindowsActionSettings.DF_WAIT_ACTION_TIMEOUT_IN_MILLIS
    throws:
    StepFailedException If KS could not start Windows Driver, could not start the application, the application file doesn't exist or there is no application maches with the given windowTitle
    Parameters:
    appFile - Absolute path to the Windows application.
    windowTitle - Title or name of the opening application windows. Full text, partial text, or regular expression input is acceptable.
    matchingStrategy - Specifies the strategy to match the windowTitle parameter against the actual window title. Allowed values are:
    
    StringMatchingStrategy#CONTAINS#CONTAINS: (default value) The windowTitle parameter should be a substring of the actual window title.
    
    StringMatchingStrategy#REGEXP#REGEXP: The windowTitle parameter should be a valid regular expression pattern that matches the actual window title.
    
    StringMatchingStrategy#EXACT#EXACT: The windowTitle parameter should exactly match the actual window title.
    Since:
    7.1.0
  - @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void switchToApplication()
    
    Switches the current running driver to the application WindowsDriver.
    Since:
    7.0.0
  - @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void switchToApplication(FailureHandling flowControl)
    
    Switches the current running driver to the application WindowsDriver.
    Parameters:
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.0.0
  - @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void switchToDesktop()
    
    Switches the current running driver to desktop session of Windows Driver. KS will initialize another WindowsDriver with 'app: Root' desired capability and the same WinAppDriver URL and Proxy settings of the application driver.
    All of WindowsBuiltinKeywords now are manipulated by the desktop WindowsDriver.
    Depends on how many Windows elements on Desktop of the test machine, Katalon Studio may take a couples of minutes to complete this action.
    throws:
    StepFailedException If KS could not initialize the desktop Windows Driver.
    
    Since:
    7.0.0
  - @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void switchToDesktop(FailureHandling flowControl)
    
    Switches the current running driver to desktop session of Windows Driver. KS will initialize another WindowsDriver with 'app: Root' desired capability and the same WinAppDriver URL and Proxy settings of the application driver.
    All of WindowsBuiltinKeywords now are manipulated by the desktop WindowsDriver.
    Depends on how many Windows elements on Desktop of the test machine, Katalon Studio may take a couples of minutes to complete this action.
    throws:
    StepFailedException If KS could not initialize the desktop Windows Driver.
    Parameters:
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Since:
    7.0.0
  - @SuppressWarnings("unchecked") @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> switchToWindow(WindowsTestObject windowsObject, FailureHandling flowControl)
    
    Finds and attaches the opening application window that describes by the given windowsObject to the working WindowsDriver session on the current desktop. This keyword should use when:
    - The main application window has been closed and replaced by another window.
    - The application has multiple working windows. We can switch among these windows.
    - We already have an opened application and need to switch to without reopening requires
    throws:
    StepFailedException If Katalon Studio could not find any window that matches with the given windowsObject.
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find the opening application.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    The WindowsDriver after Katalon Studio attaches successfully.
    Since:
    7.1.0
  - @SuppressWarnings("unchecked") @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> switchToWindow(WindowsTestObject windowsObject)
    
    Finds and attaches the opening application window that describes by the given windowsObject to the working WindowsDriver session on the current desktop. This keyword should use when:
    - The main application window has been closed and replaced by another window.
    - The application has multiple working windows. We can switch among these windows.
    - We already have an opened application and need to switch to without reopening requires
    throws:
    StepFailedException If Katalon Studio could not find any window that matches with the given windowsObject.
    
    Parameters:
    windowsObject - An object that describes locator and locator strategy to find the opening application.
    Returns:
    The WindowsDriver after Katalon Studio switches successfully.
    Since:
    7.1.0
  - @SuppressWarnings("unchecked") @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> switchToWindowTitle(String windowTitle, FailureHandling flowControl)
    
    Finds and switches the opening application window to the working WindowsDriver session on the current desktop by the given title in the preset timeout (120 seconds by default). This keyword should use when:
    - The main application window has been closed and replaced by another window.
    - The application has multiple working windows. We can switch among these windows.
    - We already have an opened application and need to switch to without reopening requires
    Since 7.5.5, you can change the application title waiting timeout by changing: WindowsActionSettings.DF_WAIT_ACTION_TIMEOUT_IN_MILLIS
    throws:
    StepFailedException If Katalon Studio could not find any window that matches with the given name.
    Parameters:
    windowTitle - Title or name of the opening application windows. Full text, partial text, or regular expression input is acceptable.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    The WindowsDriver after Katalon Studio switches successfully.
    Since:
    7.1.0
  - @SuppressWarnings("unchecked") @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> switchToWindowTitle(String windowTitle, StringMatchingStrategy matchingStrategy, FailureHandling flowControl)
    
    Finds and switches the opening application window to the working WindowsDriver session on the current desktop by the given title in the preset timeout (120 seconds by default). This keyword should use when:
    - The main application window has been closed and replaced by another window.
    - The application has multiple working windows. We can switch among these windows.
    - We already have an opened application and need to switch to without reopening requires
    Since 7.5.5, you can change the application title waiting timeout by changing: WindowsActionSettings.DF_WAIT_ACTION_TIMEOUT_IN_MILLIS
    throws:
    StepFailedException If Katalon Studio could not find any window that matches with the given name.
    Parameters:
    windowTitle - Title or name of the opening application windows. Full text, partial text, or regular expression input is acceptable.
    matchingStrategy - Specifies the strategy to match the windowTitle parameter against the actual window title. Allowed values are:
    
    StringMatchingStrategy#CONTAINS#CONTAINS: (default value) The windowTitle parameter should be a substring of the actual window title.
    
    StringMatchingStrategy#REGEXP#REGEXP: The windowTitle parameter should be a valid regular expression pattern that matches the actual window title.
    
    StringMatchingStrategy#EXACT#EXACT: The windowTitle parameter should exactly match the actual window title.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    The WindowsDriver after Katalon Studio switches successfully.
    Since:
    7.1.0
  - @SuppressWarnings("unchecked") @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> switchToWindowTitle(String windowTitle)
    
    Finds and switches the opening application window to the working WindowsDriver session on the current desktop by the given title in the preset timeout (120 seconds by default). This keyword should use when:
    - The main application window has been closed and replaced by another window.
    - The application has multiple working windows. We can switch among these windows.
    - We already have an opened application and need to switch to without reopening requires
    Since 7.5.5, you can change the application title waiting timeout by changing: WindowsActionSettings.DF_WAIT_ACTION_TIMEOUT_IN_MILLIS
    throws:
    StepFailedException If Katalon Studio could not find any window that matches with the given title.
    
    Parameters:
    windowTitle - Title or name of the opening application windows. Full text, partial text, or regular expression input is acceptable.
    Returns:
    The WindowsDriver after Katalon Studio switches successfully.
    Since:
    7.1.0
  - @SuppressWarnings("unchecked") @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> switchToWindowTitle(String windowTitle, StringMatchingStrategy matchingStrategy)
    
    Finds and switches the opening application window to the working WindowsDriver session on the current desktop by the given title in the preset timeout (120 seconds by default). This keyword should use when:
    - The main application window has been closed and replaced by another window.
    - The application has multiple working windows. We can switch among these windows.
    - We already have an opened application and need to switch to without reopening requires
    Since 7.5.5, you can change the application title waiting timeout by changing: WindowsActionSettings.DF_WAIT_ACTION_TIMEOUT_IN_MILLIS
    throws:
    StepFailedException If Katalon Studio could not find any window that matches with the given title.
    Parameters:
    windowTitle - Title or name of the opening application windows. Full text, partial text, or regular expression input is acceptable.
    matchingStrategy - Specifies the strategy to match the windowTitle parameter against the actual window title. Allowed values are:
    
    StringMatchingStrategy#CONTAINS#CONTAINS: (default value) The windowTitle parameter should be a substring of the actual window title.
    
    StringMatchingStrategy#REGEXP#REGEXP: The windowTitle parameter should be a valid regular expression pattern that matches the actual window title.
    
    StringMatchingStrategy#EXACT#EXACT: The windowTitle parameter should exactly match the actual window title.
    Returns:
    The WindowsDriver after Katalon Studio switches successfully.
    Since:
    7.1.0
  - @Keyword(keywordObject = "Element") public static boolean verifyElementAttributeValue(WindowsTestObject windowsObject, String attributeName, String attributeValue, int timeout, FailureHandling flowControl)
    
    Waits until the given element has an attribute with the specific name and value within the given time in second unit.
    throws:
    StepFailedException If The Windows element doesn't exist.
    throws:
    IllegalArgumentException If:
    
    windowsObject, attributeName or attributeValue is null.
    
    timeout < 0.
    Parameters:
    windowsObject - An object that describes locator and locator strategy of the target element that needs to wait for.
    attributeName - The name of the attribute name to verify, not null.
    attributeValue - The value of the expected attribute value to verify, not null.
    timeout - System will wait at most timeout (seconds) to return result.
    
    If timeout = 0, Katalon Studio will use default page load timeout.
    If timeout < 0, throws IllegalArgumentException.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    true if element has the attribute with the specific name and value; Otherwise, false.
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static boolean verifyElementAttributeValue(WindowsTestObject windowsObject, String attributeName, String attributeValue, int timeout)
    
    Waits until the given element has an attribute with the specific name and value within the given time in second unit.
    throws:
    StepFailedException If The Windows element doesn't exist.
    throws:
    IllegalArgumentException If:
    
    windowsObject, attributeName or attributeValue is null.
    
    timeout < 0.
    Parameters:
    windowsObject - An object that describes locator and locator strategy of the target element that needs to wait for.
    attributeName - The name of the attribute name to verify, not null.
    attributeValue - The value of the expected attribute value to verify, not null.
    timeout - System will wait at most timeout (seconds) to return result.
    
    If timeout = 0, Katalon Studio will use default page load timeout.
    If timeout < 0, throws IllegalArgumentException.
    Returns:
    true if element has the attribute with the specific name and value; Otherwise, false.
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static boolean verifyElementNotPresent(WindowsTestObject windowsObject, int timeout, FailureHandling flowControl)
    
    Waits until the given element not to present (disappear) within the given time in second unit.
    throws:
    StepFailedException If the Windows element exists.
    throws:
    IllegalArgumentException If:
    
    windowsObject is null.
    
    timeout < 0.
    Parameters:
    windowsObject - An object that describes locator and locator strategy of the target element that needs to wait for.
    timeout - System will wait at most timeout (seconds) to return result.
    
    If timeout = 0, Katalon Studio will use default page load timeout.
    If timeout < 0, throws IllegalArgumentException.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    true if element does not present; Otherwise, false.
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static boolean verifyElementNotPresent(WindowsTestObject windowsObject, int timeout)
    
    Waits until the given element not to present (disappear) within the given time in second unit.
    throws:
    StepFailedException If the Windows element exists.
    throws:
    IllegalArgumentException If:
    
    windowsObject is null.
    
    timeout < 0.
    Parameters:
    windowsObject - An object that describes locator and locator strategy of the target element that needs to wait for.
    timeout - System will wait at most timeout (seconds) to return result.
    
    If timeout = 0, Katalon Studio will use default page load timeout.
    If timeout < 0, throws IllegalArgumentException.
    Returns:
    true if element does not present; Otherwise, false.
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static boolean verifyElementPresent(WindowsTestObject windowsObject, int timeout, FailureHandling flowControl)
    
    Waits until the given element to present (appear) within the given time in second unit.
    throws:
    StepFailedException If the Windows element doesn't exist.
    throws:
    IllegalArgumentException If:
    
    windowsObject is null.
    
    timeout < 0.
    Parameters:
    windowsObject - An object that describes locator and locator strategy of the target element that needs to wait for.
    timeout - System will wait at most timeout (seconds) to return result.
    
    If timeout = 0, Katalon Studio will use default page load timeout.
    If timeout < 0, throws IllegalArgumentException.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    true if element presents; Otherwise, false.
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static boolean verifyElementPresent(WindowsTestObject windowsObject, int timeout)
    
    Waits until the given element to present (appear) within the given time in second unit.
    throws:
    StepFailedException If the Windows element doesn't exist.
    throws:
    IllegalArgumentException If:
    
    windowsObject is null.
    
    timeout < 0.
    Parameters:
    windowsObject - An object that describes locator and locator strategy of the target element that needs to wait for.
    timeout - System will wait at most timeout (seconds) to return result.
    
    If timeout = 0, Katalon Studio will use default page load timeout.
    If timeout < 0, throws IllegalArgumentException.
    Returns:
    true if element presents; Otherwise, false.
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static boolean waitForElementAttributeValue(WindowsTestObject windowsObject, String attributeName, String attributeValue, int timeout, FailureHandling flowControl)
    
    Waits until the given element has an attribute with the specific name and value within the given time in second unit.
    throws:
    StepFailedException If The Windows element doesn't exist.
    throws:
    IllegalArgumentException If:
    
    windowsObject, attributeName or attributeValue is null.
    
    timeout < 0.
    Parameters:
    windowsObject - An object that describes locator and locator strategy of the target element that needs to wait for.
    attributeName - The name of the attribute to verify, not null.
    attributeValue - The value of the expected attribute value to verify, not null.
    timeout - System will wait at most timeout (seconds) to check the given element.
    
    If timeout = 0, Katalon Studio will use default page load timeout.
    If timeout < 0, throws IllegalArgumentException.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    true if element has the attribute with the specific name and value; Otherwise, false.
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static boolean waitForElementAttributeValue(WindowsTestObject windowsObject, String attributeName, String attributeValue, int timeout)
    
    Waits until the given element has an attribute with the specific name and value within the given time in second unit.
    throws:
    StepFailedException If The Windows element doesn't exist.
    throws:
    IllegalArgumentException If:
    
    windowsObject, attributeName or attributeValue is null.
    
    timeout < 0.
    Parameters:
    windowsObject - An object that describes locator and locator strategy of the target element that needs to wait for.
    attributeName - The name of the attribute to verify, not null.
    attributeValue - The value of the expected attribute value to verify, not null.
    timeout - System will wait at most timeout (seconds) to check the given element.
    
    If timeout = 0, Katalon Studio will use default page load timeout.
    If timeout < 0, throws IllegalArgumentException.
    Returns:
    true if element has the attribute with the specific name and value; Otherwise, false.
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static boolean waitForElementNotPresent(WindowsTestObject windowsObject, int timeout, FailureHandling flowControl)
    
    Waits for the given element not to present (disappear) within the given time in second unit.
    throws:
    StepFailedException If the Windows element exists.
    throws:
    IllegalArgumentException If:
    
    windowsObject is null.
    
    timeout < 0.
    Parameters:
    windowsObject - An object that describes locator and locator strategy of the target element that needs to wait for.
    timeout - System will wait at most timeout (seconds) to check the given element.
    
    If timeout = 0, Katalon Studio will use default page load timeout.
    If timeout < 0, throws IllegalArgumentException.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    true if element does not present; Otherwise, false.
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static boolean waitForElementNotPresent(WindowsTestObject windowsObject, int timeout)
    
    Waits for the given element not to present (disappear) within the given time in second unit.
    throws:
    StepFailedException If the Windows element exists.
    throws:
    IllegalArgumentException If:
    
    windowsObject is null.
    
    timeout < 0.
    Parameters:
    windowsObject - An object that describes locator and locator strategy of the target element that needs to wait for.
    timeout - System will wait at most timeout (seconds) to check the given element.
    
    If timeout = 0, Katalon Studio will use default page load timeout.
    If timeout < 0, throws IllegalArgumentException.
    Returns:
    true if element does not present; Otherwise, false.
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static boolean waitForElementPresent(WindowsTestObject windowsObject, int timeout, FailureHandling flowControl)
    
    Waits for the given element to present (appear) within the given time in second unit.
    throws:
    StepFailedException If The Windows element doesn't exist.
    throws:
    IllegalArgumentException If:
    
    windowsObject is null.
    
    timeout < 0.
    Parameters:
    windowsObject - An object that describes locator and locator strategy of the target element that needs to wait for.
    timeout - System will wait at most timeout (seconds) to check the given element.
    
    If timeout = 0, Katalon Studio will use default page load timeout.
    If timeout < 0, throws IllegalArgumentException.
    flowControl - Optional parameter: Controls the execution flow if the step failed.
    
    STOP_ON_FAILURE: throws StepFailedException if the step failed (default).
    
    CONTINUE_ON_FAILURE: continues the test if the test failed but the test result is still failed.
    
    OPTIONAL: continues the test and ignore the test result.
    Returns:
    true if element presents; Otherwise, false
    Since:
    7.6.0
  - @Keyword(keywordObject = "Element") public static boolean waitForElementPresent(WindowsTestObject windowsObject, int timeout)
    
    Waits for the given element to present (appear) within the given time in second unit.
    throws:
    StepFailedException If The Windows element doesn't exist.
    throws:
    IllegalArgumentException If:
    
    windowsObject is null.
    
    timeout < 0.
    Parameters:
    windowsObject - An object that describes locator and locator strategy of the target element that needs to wait for.
    timeout - System will wait at most timeout (seconds) to check the given element.
    
    If timeout = 0, Katalon Studio will use default page load timeout.
    If timeout < 0, throws IllegalArgumentException.
    Returns:
    true if element presents; Otherwise, false.
    Since:
    7.6.0

Summary:
Method

| Detail:
Method

[Java] Class WindowsBuiltinKeywords

Methods Summary

Inherited Methods Summary

Method Detail

@Keyword(keywordObject = "Element") public static void clearText(WindowsTestObject windowsObject)

@Keyword(keywordObject = "Element") public static void clearText(WindowsTestObject windowsObject, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static void click(WindowsTestObject windowsObject)

@Keyword(keywordObject = "Element") public static void click(WindowsTestObject windowsObject, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static void clickElementOffset(WindowsTestObject windowsObject, int offsetX, int offsetY)

@Keyword(keywordObject = "Element") public static void clickElementOffset(WindowsTestObject windowsObject, int offsetX, int offsetY, FailureHandling flowControl)

@Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void closeApplication()

@Keyword(keywordObject = "Element") public static void doubleClick(WindowsTestObject windowsObject)

@Keyword(keywordObject = "Element") public static void doubleClick(WindowsTestObject windowsObject, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static WebElement findElement(WindowsTestObject windowsObject, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static WebElement findElement(WindowsTestObject windowsObject)

@SuppressWarnings("unchecked") @Keyword(keywordObject = "Element") public static List<WebElement> findElements(WindowsTestObject windowsObject, FailureHandling flowControl)

@SuppressWarnings("unchecked") @Keyword(keywordObject = "Element") public static List<WebElement> findElements(WindowsTestObject windowsObject)

@Keyword(keywordObject = "Element") public static String getAttribute(WindowsTestObject windowsObject, String attribute, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static String getAttribute(WindowsTestObject windowsObject, String attribute)

@Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> getDriver()

@Keyword(keywordObject = "Element") public static Point getElementPosition(WindowsTestObject windowsObject, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static Point getElementPosition(WindowsTestObject windowsObject)

@Keyword(keywordObject = "Element") public static Rectangle getElementRect(WindowsTestObject windowsObject, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static Rectangle getElementRect(WindowsTestObject windowsObject)

@Keyword(keywordObject = "Element") public static String getText(WindowsTestObject windowsObject)

@Keyword(keywordObject = "Element") public static String getText(WindowsTestObject windowsObject, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static void rightClick(WindowsTestObject windowsObject)

@Keyword(keywordObject = "Element") public static void rightClick(WindowsTestObject windowsObject, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static void rightClickElementOffset(WindowsTestObject windowsObject, int offsetX, int offsetY)

@Keyword(keywordObject = "Element") public static void rightClickElementOffset(WindowsTestObject windowsObject, int offsetX, int offsetY, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static void sendKeys(WindowsTestObject windowsObject, String strKeys, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static void sendKeys(WindowsTestObject windowsObject, String strKeys)

@Keyword(keywordObject = "Element") public static void setEncryptedText(WindowsTestObject windowsObject, String encryptedText)

@Keyword(keywordObject = "Element") public static void setEncryptedText(WindowsTestObject windowsObject, String encryptedText, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static void setText(WindowsTestObject windowsObject, String text)

@Keyword(keywordObject = "Element") public static void setText(WindowsTestObject windowsObject, String text, FailureHandling flowControl)

@Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void startApplication(String appFile)

@Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void startApplication(String appFile, FailureHandling flowControl)

@Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void startApplicationWithTitle(String appFile, String windowTitle, FailureHandling flowControl)

@Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void startApplicationWithTitle(String appFile, String windowTitle, StringMatchingStrategy matchingStrategy, FailureHandling flowControl)

@Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void startApplicationWithTitle(String appFile, String windowTitle)

@Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void startApplicationWithTitle(String appFile, String windowTitle, StringMatchingStrategy matchingStrategy)

@Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void switchToApplication()

@Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void switchToApplication(FailureHandling flowControl)

@Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void switchToDesktop()

@Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static void switchToDesktop(FailureHandling flowControl)

@SuppressWarnings("unchecked") @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> switchToWindow(WindowsTestObject windowsObject, FailureHandling flowControl)

@SuppressWarnings("unchecked") @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> switchToWindow(WindowsTestObject windowsObject)

@SuppressWarnings("unchecked") @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> switchToWindowTitle(String windowTitle, FailureHandling flowControl)

@SuppressWarnings("unchecked") @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> switchToWindowTitle(String windowTitle, StringMatchingStrategy matchingStrategy, FailureHandling flowControl)

@SuppressWarnings("unchecked") @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> switchToWindowTitle(String windowTitle)

@SuppressWarnings("unchecked") @Keyword(keywordObject = StringConstants.KW_CATEGORIZE_APPLICATION) public static WindowsDriver<WebElement> switchToWindowTitle(String windowTitle, StringMatchingStrategy matchingStrategy)

@Keyword(keywordObject = "Element") public static boolean verifyElementAttributeValue(WindowsTestObject windowsObject, String attributeName, String attributeValue, int timeout, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static boolean verifyElementAttributeValue(WindowsTestObject windowsObject, String attributeName, String attributeValue, int timeout)

@Keyword(keywordObject = "Element") public static boolean verifyElementNotPresent(WindowsTestObject windowsObject, int timeout, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static boolean verifyElementNotPresent(WindowsTestObject windowsObject, int timeout)

@Keyword(keywordObject = "Element") public static boolean verifyElementPresent(WindowsTestObject windowsObject, int timeout, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static boolean verifyElementPresent(WindowsTestObject windowsObject, int timeout)

@Keyword(keywordObject = "Element") public static boolean waitForElementAttributeValue(WindowsTestObject windowsObject, String attributeName, String attributeValue, int timeout, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static boolean waitForElementAttributeValue(WindowsTestObject windowsObject, String attributeName, String attributeValue, int timeout)

@Keyword(keywordObject = "Element") public static boolean waitForElementNotPresent(WindowsTestObject windowsObject, int timeout, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static boolean waitForElementNotPresent(WindowsTestObject windowsObject, int timeout)

@Keyword(keywordObject = "Element") public static boolean waitForElementPresent(WindowsTestObject windowsObject, int timeout, FailureHandling flowControl)

@Keyword(keywordObject = "Element") public static boolean waitForElementPresent(WindowsTestObject windowsObject, int timeout)