ui.Window.forName

Get a window object by name.

Syntax

ui.Window.forName(
   name STRING )
  RETURNS ui.Window
  1. name defines the name of the window.

Usage

The ui.Window.forName() class method returns the ui.Window object corresponding to an identifier used to create the window with the OPEN WINDOW instruction, or the predefined "screen" window.

Declare a variable of type ui.Window to hold the window object reference.

The name of the window passed as parameter can use the same letter case as in the OPEN WINDOW instruction: The lookup is case-insensitive.

When invoking the ui.Window.forName() method to get the initial default "screen" window, an OPEN FORM/DISPLAY FORM must have been executed. Otherwise, the method will return NULL. To create a form dynamically in the initial "screen" window, see ui.Window.createForm.

Example

DEFINE w ui.Window
OPEN WINDOW w1 WITH FORM "custform"
LET w = ui.Window.forName("w1")
...