MASKLEV

Contents


masklev returns the "locality level" of the open screens.

 

Syntax

   masklev(<class | num_exp>)

 

Parameters

Element

Description

Restrictions

class

Describes a screen's abbreviation

The class must exist.

num_exp

Numeric expression that describes a screen

num_exp >= 0

 

Examples

   # Names and "locality levels" of the open screens in the current application
    Libelle I, NBMSK
    I = 1:  NBMSK = 25
    Repeat
       Infbox masknam(I)-num$(masklev(I))
       I += 1
    Until I > NBMSK

 

Description and Comments

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.

 

Associated Errors

Error

Description

ERCLAS ( 7)

Class does not exist

ERDOM (50)

num_exp < 0.

 

Associated Keywords

MASK - MASKABR - MASKNAM - MASKCOU


CONTENTS


Copyright © Sage 1999 - 2007