ui.Window.openWithForm()

 

variable.OpenWithForm("window name", form, y, x [, attributes])

 

This method is used with a variable of the WINDOW data type to initialize it and to open a window with the specified form in it. The window opened in such a way can be referenced by other methods for window manipulation, if they are used with the same WINDOW variable:

 

DEFINE  wo ui.Window

CALL wo.OpenWithForm("Window Name", "my_formfile", 3, 5, "border, form-line:1")

 

This method accepts five arguments. The first argument is a quoted string or a variable of a character data type standing for a window name. This name will also be displayed to the window titlebar unless a form file does not define another titlebar text.

The form argument is either a quoted character string or a variable of a character data type containing the name of the form file without the file extension, but with the relative path, if necessary. Y stands for the row and x for the column at which the upper left corner of the window will appear; these are both literal integers or integer variables.

The attributes argument is a quoted string containing the standard display attributes of color and intensity, the BORDER attribute and the attributes setting the positions of the reserved lines.

There may be more than one attribute in the character string, they should be separated by commas. Here are the attributes you can use:

 

The integer here stands for the number of the row where you want to position the reserved line. If the position for the reserved line is greater than the window height, the prompt will appear at the last line of the window.