MASKNAM

Contents


masknam returns the open screens' names.

 

Syntax

   masknam(<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

   # List of open screens in the current application
    Description I, J, NBMSK:  NBMSK = 25
    Char VARMSK (10) (1..NBMSK)
    I = 1:  J = 1
    Repeat
       If masknam(I) <> ""
          VARMSK(J) = masknam(I)
          J += 1
       Endif
       I += 1
    Until I > NBMSK

 

Description and Comments

masknam returns the name of the screen for which the abbreviation or internal number is given in parameters. In the event of an abbreviation, 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 empty string ("").

The result of the function is of the Char type.

 

Associated Errors

Error

Description

ERCLAS ( 7)

Class does not exist

ERDOM (50)

exp_num < 0.

 

Associated Keywords

MASK  - MASKABR - MASKNBF - MASKCOU


CONTENTS


Copyright © Sage 1999 - 2007