MASKLEV |
masklev returns the "locality level" of the open screens.
masklev(<class | num_exp>)
|
Element |
Description |
Restrictions |
|
class |
Describes a screen's abbreviation |
The class must exist. |
|
num_exp |
Numeric expression that describes a screen |
num_exp >= 0 |
# Names and "locality levels" of the open screens in the current application
Libelle I, NBMSK I = 1: NBMSK = 25 RepeatInfbox masknam(I)-num$(masklev(I))
I += 1 Until I > NBMSK
masklev returns the "locality level" of a screen for which the abbreviation or internal number (used by Adonix) is given. The value zero (0) means that the screen is not open; one (1) that it was opened in a process; and, N that it was opened in the Nth subroutine "embedded" by the Call instruction.
If you give an abbreviation as a parameter, the screen must be open. The internal number (used by Adonix) corresponds to the line number in the list of open screens displayed in the debugger, and starts with one (1). No error is returned when a numeric parameter does not correspond to a single open screen, since the function returns the value zero (0).
The result of the function is of the Integer type.
|
Error |
Description |
|
ERCLAS ( 7) |
Class does not exist |
|
ERDOM (50) |
num_exp < 0. |
MASK - MASKABR - MASKNAM - MASKCOU
|
|