Window

Supported in UFT Developer version 2023 and later

UIA Pro is supported as a technical preview.

UIAPro. Window

new Window(props_opt) → {Window}

The description of a UIAPro window test object.

Parameters:

Name	Type	Attributes	Description
`props`	Object	<optional>	Initializes a UIAPro Window test object using the supplied property bag.

Returns:

the description object that was initialized.

Type: Window

Methods

absX(absX_opt) → {number|Description}

The object's absolute x-coordinate (left) relative to the parent object (in pixels).

Parameters:

Name	Type	Attributes	Description
`absX`	number	<optional>	When provided, this method acts as a setter and sets the absX value.

Returns:

The current stored absX value; otherwise it returns 'this' for use with the builder pattern.

Type: number | Description

absY(absY_opt) → {number|Description}

The object's absolute y-coordinate (top) relative to the parent object (in pixels).

Parameters:

Name	Type	Attributes	Description
`absY`	number	<optional>	When provided, this method acts as a setter and sets the absY value.

Returns:

The current stored absY value; otherwise it returns 'this' for use with the builder pattern.

Type: number | Description

acceleratorKey(acceleratorKey_opt) → {string|Description}

The sequence of key combinations that invoke an action associated with the element.

Parameters:

Name	Type	Attributes	Description
`acceleratorKey`	string	<optional>	When provided, this method acts as a setter and sets the acceleratorKey value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored acceleratorKey value; otherwise it returns 'this' for use with the builder pattern.

Type: string | Description

accessKey(accessKey_opt) → {string|Description}

The character that is used to activate the object.

Parameters:

Name	Type	Attributes	Description
`accessKey`	string	<optional>	When provided, this method acts as a setter and sets the accessKey value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored accessKey value; otherwise it returns 'this' for use with the builder pattern.

Type: string | Description

automationId(automationId_opt) → {string|Description}

The ID for an object that is unique among siblings within its container.

Parameters:

Name	Type	Attributes	Description
`automationId`	string	<optional>	When provided, this method acts as a setter and sets the automationId value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored automationId value; otherwise it returns 'this' for use with the builder pattern.

Type: string | Description

controlType(controlType_opt) → {string|Description}

The UIAPro type for the object.

Parameters:

Name	Type	Attributes	Description
`controlType`	string	<optional>	When provided, this method acts as a setter and sets the controlType value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored controlType value; otherwise it returns 'this' for use with the builder pattern.

Type: string | Description

frameworkId(frameworkId_opt) → {string|Description}

The name of the UI framework, such as Win32, WinForm, or DirectUI.

Parameters:

Name	Type	Attributes	Description
`frameworkId`	string	<optional>	When provided, this method acts as a setter and sets the frameworkId value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored frameworkId value; otherwise it returns 'this' for use with the builder pattern.

Type: string | Description

handle(handle_opt) → {number|Description}

The run-time object's window handle.

Parameters:

Name	Type	Attributes	Description
`handle`	number	<optional>	When provided, this method acts as a setter and sets the handle value.

Returns:

The current stored handle value; otherwise it returns 'this' for use with the builder pattern.

Type: number | Description

hasKeyBoardFocus(hasKeyBoardFocus_opt) → {boolean|Description}

Indicates whether the object has keyboard focus.

Parameters:

Name	Type	Attributes	Description
`hasKeyBoardFocus`	boolean	<optional>	When provided, this method acts as a setter and sets the hasKeyBoardFocus value.

Returns:

The current stored hasKeyBoardFocus value; otherwise it returns 'this' for use with the builder pattern.

Type: boolean | Description

height(height_opt) → {number|Description}

The object's height (in pixels).

Parameters:

Name	Type	Attributes	Description
`height`	number	<optional>	When provided, this method acts as a setter and sets the height value.

Returns:

The current stored height value; otherwise it returns 'this' for use with the builder pattern.

Type: number | Description

isEnabled(isEnabled_opt) → {boolean|Description}

Indicates whether the object is enabled.

Parameters:

Name	Type	Attributes	Description
`isEnabled`	boolean	<optional>	When provided, this method acts as a setter and sets the isEnabled value.

Returns:

The current stored isEnabled value; otherwise it returns 'this' for use with the builder pattern.

Type: boolean | Description

isKeyboardFocusable(isKeyboardFocusable_opt) → {boolean|Description}

Indicates whether the object can accept keyboard focus.

Parameters:

Name	Type	Attributes	Description
`isKeyboardFocusable`	boolean	<optional>	When provided, this method acts as a setter and sets the isKeyboardFocusable value.

Returns:

The current stored isKeyboardFocusable value; otherwise it returns 'this' for use with the builder pattern.

Type: boolean | Description

isOffScreen(isOffScreen_opt) → {boolean|Description}

Indicates whether the object is Offscreen.

Parameters:

Name	Type	Attributes	Description
`isOffScreen`	boolean	<optional>	When provided, this method acts as a setter and sets the isOffScreen value.

Returns:

The current stored isOffScreen value; otherwise it returns 'this' for use with the builder pattern.

Type: boolean | Description

isPassword(isPassword_opt) → {boolean|Description}

Indicates whether the object contains protected content or a password.

Parameters:

Name	Type	Attributes	Description
`isPassword`	boolean	<optional>	When provided, this method acts as a setter and sets the isPassword value.

Returns:

The current stored isPassword value; otherwise it returns 'this' for use with the builder pattern.

Type: boolean | Description

name(name_opt) → {string|Description}

The name of the control.

Parameters:

Name	Type	Attributes	Description
`name`	string	<optional>	When provided, this method acts as a setter and sets the name value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored name value; otherwise it returns 'this' for use with the builder pattern.

Type: string | Description

nativeClass(nativeClass_opt) → {string|Description}

The class name assigned to the test object.

Parameters:

Name	Type	Attributes	Description
`nativeClass`	string	<optional>	When provided, this method acts as a setter and sets the nativeClass value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored nativeClass value; otherwise it returns 'this' for use with the builder pattern.

Type: string | Description

path(path_opt) → {string|Description}

The path in the application's object hierarchy, separated by semicolons. Objects in the path are represented by their name or automationId property values.

Parameters:

Name	Type	Attributes	Description
`path`	string	<optional>	When provided, this method acts as a setter and sets the path value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored path value; otherwise it returns 'this' for use with the builder pattern.

Type: string | Description

processId(processId_opt) → {number|Description}

The UIAutomation object process id.

Parameters:

Name	Type	Attributes	Description
`processId`	number	<optional>	When provided, this method acts as a setter and sets the processId value.

Returns:

The current stored processId value; otherwise it returns 'this' for use with the builder pattern.

Type: number | Description

processName(processName_opt) → {string|Description}

The UIAutomation object process name.

Parameters:

Name	Type	Attributes	Description
`processName`	string	<optional>	When provided, this method acts as a setter and sets the processName value.

Returns:

The current stored processName value; otherwise it returns 'this' for use with the builder pattern.

Type: string | Description

status(status_opt) → {string|Description}

Describes the status of the current object. For example, an item associated with a contact in a messaging application might be "Busy" or "Connected".

Parameters:

Name	Type	Attributes	Description
`status`	string	<optional>	When provided, this method acts as a setter and sets the status value.

Returns:

The current stored status value; otherwise it returns 'this' for use with the builder pattern.

Type: string | Description

supportedPatterns(supportedPatterns_opt) → {Array.<string>|Description}

The list of patterns supported for the test object.

Parameters:

Name	Type	Attributes	Description
`supportedPatterns`	Array.<string>	<optional>	When provided, this method acts as a setter and sets the supportedPatterns value.

Returns:

If no parameter is provided, the method acts as a getter and returns the current stored supportedPatterns value; otherwise it returns 'this' for use with the builder pattern.

Type: Array.<string> | Description

width(width_opt) → {number|Description}

The object's width (in pixels).

Parameters:

Name	Type	Attributes	Description
`width`	number	<optional>	When provided, this method acts as a setter and sets the width value.

Returns:

The current stored width value; otherwise it returns 'this' for use with the builder pattern.

Type: number | Description

x(x_opt) → {number|Description}

The object's x-coordinate (left) relative to the parent object (in pixels).

Parameters:

Name	Type	Attributes	Description
`x`	number	<optional>	When provided, this method acts as a setter and sets the x value.

Returns:

The current stored x value; otherwise it returns 'this' for use with the builder pattern.

Type: number | Description

y(y_opt) → {number|Description}

The object's y-coordinate (top) relative to the parent object (in pixels).

Parameters:

Name	Type	Attributes	Description
`y`	number	<optional>	When provided, this method acts as a setter and sets the y value.

Returns:

The current stored y value; otherwise it returns 'this' for use with the builder pattern.

Type: number | Description

Window

UIAPro. Window

new Window(propsopt) → {Window}

Methods

absX(absXopt) → {number|Description}

absY(absYopt) → {number|Description}

acceleratorKey(acceleratorKeyopt) → {string|Description}

accessKey(accessKeyopt) → {string|Description}

automationId(automationIdopt) → {string|Description}

controlType(controlTypeopt) → {string|Description}

frameworkId(frameworkIdopt) → {string|Description}

handle(handleopt) → {number|Description}

hasKeyBoardFocus(hasKeyBoardFocusopt) → {boolean|Description}

height(heightopt) → {number|Description}

isEnabled(isEnabledopt) → {boolean|Description}

isKeyboardFocusable(isKeyboardFocusableopt) → {boolean|Description}

isOffScreen(isOffScreenopt) → {boolean|Description}

isPassword(isPasswordopt) → {boolean|Description}

name(nameopt) → {string|Description}

nativeClass(nativeClassopt) → {string|Description}

path(pathopt) → {string|Description}

processId(processIdopt) → {number|Description}

processName(processNameopt) → {string|Description}

status(statusopt) → {string|Description}

supportedPatterns(supportedPatternsopt) → {Array.<string>|Description}

width(widthopt) → {number|Description}

x(xopt) → {number|Description}

y(yopt) → {number|Description}

Send Help Center Feedback

new Window(props_opt) → {Window}

absX(absX_opt) → {number|Description}

absY(absY_opt) → {number|Description}

acceleratorKey(acceleratorKey_opt) → {string|Description}

accessKey(accessKey_opt) → {string|Description}

automationId(automationId_opt) → {string|Description}

controlType(controlType_opt) → {string|Description}

frameworkId(frameworkId_opt) → {string|Description}

handle(handle_opt) → {number|Description}

hasKeyBoardFocus(hasKeyBoardFocus_opt) → {boolean|Description}

height(height_opt) → {number|Description}

isEnabled(isEnabled_opt) → {boolean|Description}

isKeyboardFocusable(isKeyboardFocusable_opt) → {boolean|Description}

isOffScreen(isOffScreen_opt) → {boolean|Description}

isPassword(isPassword_opt) → {boolean|Description}

name(name_opt) → {string|Description}

nativeClass(nativeClass_opt) → {string|Description}

path(path_opt) → {string|Description}

processId(processId_opt) → {number|Description}

processName(processName_opt) → {string|Description}

status(status_opt) → {string|Description}

supportedPatterns(supportedPatterns_opt) → {Array.<string>|Description}

width(width_opt) → {number|Description}

x(x_opt) → {number|Description}

y(y_opt) → {number|Description}