TOPMOST Property

 

Specifies if a Window should be displayed with a TOPMOST style

 

 

Description:

 

A Window with a TOPMOST "style" always stays above any other Window, even when it is no longer in focus.

 

The image below demonstrates the effect when using the TOPMOST property. It is not used on Window 1 but is used on Window 2

 

Topmost Window

 

Syntax:

 

    DEFINE WINDOW <cFormName>

 

        [ ... Other Control Properties ... ]

 

        [ TOPMOST <lValue> ]

 

    END WINDOW

 

Valid For Use With:

 

This property is used when defining the following Window types -

 

    MAIN

    CHILD

    STANDARD

    PANEL

 

Notes:

  1. This property is only available during Window definition.

  2. There is bug when using this property. Where it is declared, it forces the Window to assume a "topmost" style regardless of the actual logical value assigned and even assigning a Nil value has this effect. The workaround is to not use the TOPMOST property unless a "topmost" style Window is actually required.

  3. More advanced information is available in the Windows API reference for the TOPMOST property

  4. The original version of the help file for this item can be viewed here.

Properties:

 

The following Property is only available when the Window is being defined

 

lValue Logical D Sets a Window to be a topmost style Window. Please refer to Note 2, above

 

D - Properties of this type can be used when defining a Window

R - Properties of this type can only be accessed (read) after the Window has been defined

W - Properties of this type can be changed (write) after the Window has been defined

 

See GETPROPERTY and SETPROPERTY functions for further infomation on accessing or changing properties or use semi-OOP syntax

 

Sample Code:

 

Sample code to test this Property can be found here