DtvLong dal_mas_cre_fld (len_fld,wid_fld, len_vir,wid_vir, rec_flg,dsc)

Creates a new mask field (still unassigned).

Input Parameters Significance
DtvLong len_fld visible row length of the field
DtvLong wid_fld visible column width of the field
DtvLong len_vir virtual row length of the field [0 = visible length]
DtvLong wid_vir virtual column width of the field [0 = visible width]
char rec_flg record flag:
0 = multi -record field
1 = single-record field
char *dsc name of the field

Output Parameters Significance
no -

Return Code Significance
value Id of the field

Fields must only be explicitly created using this function if you want to create or change the entire mask via program functions of the < mas> module.

The record flag specifies the field as part of a list or of a form. List masks contain multi-record fields. Form mask contain single-record fields.

Set the virtual row length of the field to the value > 0 < if you want to insert the field into an empty mask via dal_mas_ins_fld after creating it. If the mask in which you want to insert the field already contains a number of records, the virtual row length to be defined must correspond to the record number.

Please set the field type using dal_mas_set_typ_fld immediately after creating a field. If a field dimension is changed using dal_mas_siz_fld later, the type must be known. The dal_mas_siz_fld function automatically limits the total field length of all non-BLOB fields to 255 characters.