MASKRK

Contents


maskrk returns the rows of the fields for an open screen.

 

Syntax

   maskrk(<class | num_exp>, row_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

row_exp

Numeric expression that describes a row in a screen

None

 

Examples

   # Names and rows of open screens in the current application
    Description I, J, NBMSK
    I = 1:  J = 1:  NBMSK = 25
    Repeat
       Infbox masknam(I)-":"
       Repeat
          Infbox num$(maskrk(I, J))
          J += 1
       Until maskrk(I, J) = 0
       I += 1
    Until I > NBMSK

 

Description and Comments

maskrk returns the values of rows of fields for a screen, depending on the value of the second parameter:

·         If row_exp = 1, you will get the number of the first row,

·         If row_exp = 2, you will get the number of the second row,

·         ... You get the value zero (0) as soon as row_exp exceeds the different number of rows.

·         If row_exp = -1, you will get the number of the last row,

·         If row_exp = -2, you will get the number of the next-to-last row,

·         ... You get the value zero (0) as soon as -row_exp exceeds the different number of rows.

The screen can be identified by its abbreviation or internal number (used by Adonix). This number 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 its value does not correspond to a single open screen, since maskrk 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)

exp_num < 0.

 

Associated Keywords

MASK - MASKABR - MASKNBF - MASKNAM - MASKCOU - MASKLEV


CONTENTS


Copyright © Sage 1999 - 2007