<<

Contents

Search

>>

 

DEL_FIELD

 

 

Function

 

 

Syntax:

DEL_FIELD(<Row>,<Column>[,<Handle>])

 

or

 

DEL_FIELD(<Mask Field>[,<Handle>])

 

<Row>

= <NUM-EXPRESSION>

<Column>

= <NUM-EXPRESSION>

<Handle>

= <NUM-EXPRESSION>

<Mask Field>

= <MASK FIELD>

 

 

Meaning:

DEL_FIELD removes a mask field. It is not necessary that the mask field had been created with ADD_FIELD.

 

<Row> and <Column> specify the position of the field.

 

<Handle> specifies the window that contains the mask field. <Handle> can contain the window depth or the handle of a split window or a WINDOWCALL window. If the parameter <Handle> is missing, the mask field must be on the current mask.

 

DEL_FIELD returns the value0 if no error occurred, otherwise it returns one of the following error numbers:

 

Error number

Meaning

6122

There is no mask field <Mask Field> resp. in <Row>,<Column>.

6125

Mask does not contain any fields.

6128

Mask was created in another subprogram.

-99

Mask not found.

 

Parameter:

Row

Row of mask field

Column

Column of mask field

Handle

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

Mask Field

Mask Field (#<Masknumber>. ...) which shall be deleted.

 

Sample:

H% = DEL_FIELD(3,10)

IF H% <> 0

THEN … Error …

ENDIF

 

H% = DEL_FIELD(#4.#NUMBER,10)

 

See also:

ADD_FIELD

MOVE_FIELD