Share this page

# Window

## PowerBuilder. Window

## new Window(propsopt) → {Window}

The description of a power builder Window test object.

##### Parameters:

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

##### Returns:

the description object that was initialized.

Type
  Window

# Methods

## absoluteLocation(locationopt) → {Point|Description}

The object's coordinates relative to the screen in pixels. 0,0 is the top-left corner of the primary monitor.

##### Parameters:

Name | Type | Attributes | Description
--- | --- | --- | ---
`location` | Point | <optional> | When provided, this method acts as a setter and sets the absoluteLocation value.

##### Returns:

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

Type
  Point | Description

## hasBorder(hasBorderopt) → {boolean|Description}

Indicates whether the Window or the Dialog has borders.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## hasCaption(hasCaptionopt) → {boolean|Description}

Indicates whether the Window or the Dialog has a cation.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## hasSizebox(hasSizeboxopt) → {boolean|Description}

Indicates whether the Window or the Dialog has a sizebox.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## hasSystemMenu(hasSystemMenuopt) → {boolean|Description}

Indicates whether the Window or the Dialog has system menu.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isActive(isActiveopt) → {boolean|Description}

Indicates whether the Window or the Dialog is active.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isChildWindow(isChildWindowopt) → {boolean|Description}

Indicates whether the window or the dialog is a child window/dialog.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isEnabled(isEnabledopt) → {boolean|Description}

Indicates whether the object is enable.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isFocused(isFocusedopt) → {boolean|Description}

Indicates whether the object is focused.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isMaximizable(isMaximizableopt) → {boolean|Description}

Indicates whether the Window or the Dialog is maximizable.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isMdiChildWindow(isMdiChildWindowopt) → {boolean|Description}

Indicates whether the Window or the Dialog is MDI child window/dialog.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isMinimizable(isMinimizableopt) → {boolean|Description}

Indicates whether the Window or the Dialog is minimizable.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isOwnedWindow(isOwnedWindowopt) → {boolean|Description}

Indicates whether the window or the dialog is an owned window/dialog.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isPopupWindow(isPopupWindowopt) → {boolean|Description}

Indicates whether the Window or the Dialog is a popup window/dialog.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isRightAligned(isRightAlignedopt) → {boolean|Description}

Indicates whether the object is right aligned.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isRightToLeftLayout(isRightToLeftLayoutopt) → {boolean|Description}

Indicates whether the object is Right to Left layout.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isRightToLeftReading(isRightToLeftReadingopt) → {boolean|Description}

Indicates whether the object is Right to Left reading.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isToolWindow(isToolWindowopt) → {boolean|Description}

Indicates whether the Window or the Dialog is a tool window.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isTopmost(isTopmostopt) → {boolean|Description}

Indicates whether the Window or the Dialog is top-most.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## isVisible(isVisibleopt) → {boolean|Description}

Indicates whether the object is visible.

##### Parameters:

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

##### Returns:

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

Type
  boolean | Description

## location(locationopt) → {Point|Description}

The object's coordinates relative to the parent's location in pixels.

##### Parameters:

Name | Type | Attributes | Description
--- | --- | --- | ---
`location` | Point | <optional> | When provided, this method acts as a setter and sets the location value.

##### Returns:

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

Type
  Point | Description

## objectName(objectNameopt) → {string|Description}

The object's name as set by the developer.

##### Parameters:

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

##### Returns:

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

Type
  string | Description

## size(sizeopt) → {Size|Description}

The object's size in pixels.

##### Parameters:

Name | Type | Attributes | Description
--- | --- | --- | ---
`size` | Size | <optional> | When provided, this method acts as a setter and sets the size value.

##### Returns:

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

Type
  Size | Description

## text(textopt) → {string|Description}

The text associated with the object.

##### Parameters:

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

##### Returns:

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

Type
  string | Description

## windowTitleRegExp(windowClassRegExpopt) → {string|Description}

The constant part of the window title.

##### Parameters:

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

##### Returns:

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

Type
  string | Description

Tips to improve your search results... UFT Developer JavaScript SDK Reference Version 15.0-15.0.2 UFT Developer SDK Reference All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: