ALWAYS-ON-TOP attribute

(Windows only)

Indicates whether the window should remain on top of all windows, even windows belonging to other applications.

Data type:

LOGICAL

Access:

Readable/Writeable

Applies to:

WINDOW widget

This attribute differs from the TOP-ONLY attribute, which indicates that the window should remain on top of all windows of the ABL session. Windows that have the ALWAYS-ON-TOP attribute set are always above TOP-ONLY windows in the z-order; they are also above dialog boxes in some cases.

A window cannot have both the TOP-ONLY and ALWAYS-ON-TOP attributes set. Setting the ALWAYS-ON-TOP attribute to TRUE will set the TOP-ONLY attribute to FALSE. The default value of the ALWAYS-ON-TOP attribute is FALSE.

.NET forms also have a TopMost property that also indicates whether the form should remain on top of all forms of all running applications. Windows allows you to set both an ABL window as an ALWAYS-ON-TOP window and a .NET form as a TopMost form. The window and form will each stay on top of all other windows on the desktop, because Windows maintains two categories of windows—top-most windows and non-topmost windows. All topmost windows appear in front of all non-topmost windows, and you can shuffle the Z-order of the two groups of windows relative to their siblings.

See also:

TOP-ONLY attribute