This variable has meaning only on graphical systems such as Windows. The ACUCOBOL-GT runtime system automatically sets the title of the application window to the base name of the initial object file. For example, if you run a program called notepad.cbx, then the title on the main window will be set to Notepad. The title is shown in lower-case except for the first letter, which is made upper case.

You may provide an alternate title by setting WINDOW_TITLE to the desired text. No translation of the text is done, so you should enter it using the desired case.

Note: Setting WINDOW_TITLE from within a program has no effect, because the WINDOW_TITLE setting determines only the window's initial title.

To change the title from within your program, use a DISPLAY statement. The syntax is:


where text is an alphanumeric literal or variable. Enter the title with the desired case. The title is always shown in the ANSI font, so if you are using a different font, your text will be translated to ANSI.

To ensure that the WINDOW_TITLE variable operates as expected, make sure that the first screen operation in your program is not DISPLAY WINDOW with a title (the DISPLAY WINDOW title is stored in the same place as the WINDOW_TITLE). Instead, do some other screen operation first, such as DISPLAY WINDOW, ERASE.