<<

Contents

Search

>>

 

ALWAYS_ON_TOP

 

 

Function

 

 

Syntax:

ALWAYS_ON_TOP(<Type>,<Activate>,<Handle>)

 

<Type>

= <NUM-EXPRESSION>

<Activate>

= <NUM-EXPRESSION>

<Handle>

= <NUM-EXPRESSION>

 

 

Meaning:

Changes the always-on-top window state. An always-on-top window is a window that stays above all other windows except maybe other always-on-top windows.

 

<Handle> specifies the window to which ALWAYS_ON_TOP refers. <Handle> can contain the window depth or the handle of a split window or a WINDOWCALL window.

 

ALWAYS_ON_TOP returns the following values:

0: Success.

-1: Window <Handle> not found

 

Parameter:

Type

= 0: Changes the state from always-on-top to normal.

<> 0: Makes the window always-on-top.

Activate

= 0: Does nothing.

<> 0: Brings the window to front.

This parameter has no effect if <Type> <> 0.

<Type> <> 0 bríngs the window always to front.

Handle

Window depth or handle of a split window or handle of a WINDOWCALL Window

 

Sample:

H% = ALWAYS_ON_TOP(1,0,EBUS_WDEPTH)

IF H% <> 0

THEN ... Error ...

ENDIF

 

See also:

SET_VISIBLE