DEFAULT-WINDOW system handle

A handle to the static window of the current ABL session. Every ABL session has one static window. This window displays all frames until the CURRENT-WINDOW system handle is set to the handle of another [dynamic] window or unless a displayed frame is explicitly parented to another window. Its message area also displays messages that have no other available display destination. Use the DEFAULT-WINDOW handle to set or examine the attributes of this unnamed session window.

Syntax 

 

DEFAULT-WINDOW [ :attribute ]

attribute

An attribute of the DEFAULT-WINDOW.

Attributes

The DEFAULT-WINDOW handle has all the attributes of a window widget.

Notes 

If you display or view a frame without the IN WINDOW option and without first explicitly or implicitly setting CURRENT-WINDOW to the handle of a non-default window, the ABL virtual machine (AVM) displays the frame in the default window.

If the CURRENT-WINDOW does not have a message area and you execute the MESSAGE statement without an explicit or implicit VIEW-AS ALERT-BOX option, the AVM displays the default window in order to display the message in its own message area.

In a character interface, or at the start of a GUI client session, the ACTIVE-WINDOW, CURRENT-WINDOW, and DEFAULT-WINDOW handles all return the handle of the static window for the current ABL session.

You can make the default window the current window by assigning DEFAULT-WINDOW to CURRENT-WINDOW.

You can enable or disable the default window by changing the value of DEFAULT-WINDOW:SENSITIVE (the SENSITIVE attribute).

You can set the menu bar for the default window by assigning the handle of a menu bar to DEFAULT-WINDOW:MENUBAR (the MENUBAR attribute).

You can make the default window visible or invisible by changing the value of DEFAULT-WINDOW:VISIBLE (the VISIBLE attribute).

Because DEFAULT-WINDOW is the initial default parent for ABL frames, you cannot set DEFAULT-WINDOW to the handle of a .NET form’s shadow window. If allowed, this would make the associated .NET form a possible parent for ABL frames, and ABL cannot parent ABL frames to .NET forms. A .NET form’s shadow window handle is provided by the ProWinHandle property of the Progress.Windows.Form class, which an OpenEdge .NET class designed for instantiating .NET forms in an ABL session. Therefore, any attempt to set DEFAULT-WINDOW to a ProWinHandle property value raises a run-time error.

See also 

ACTIVE-WINDOW system handle, CURRENT-WINDOW system handle