DtvLong dal_mas_chk_ltx_fld (idf)

Returns the virtual width for the Longtext field.

Input Parameters Significance
DtvLong idf field Id

Output Parameters Significance
none -

Return Code Significance
value virtual width of the long string
0 no Longtext field

A field will only be permanently buffered in local memory if its string length is <= 255 characters. Fields with a string length > 255 are automatically Longtext fields.

If the Keep flag (dal_mas_set/ret_lxk_mas) is set, Longtext contents are loaded into the special Longtext buffer of local memory (higher performance with higher memory usage). If the Keep flag is not set, the Longtext buffer is not filled before editing starts (opening the Longtext editor). With dal_mas_chk_ltx_fld you first check if the field is a Longext field. With dal_dbi_get_ltx you can read the content of the Longtext field from the database and write it into the Longtext buffer with dal_mas_set_ltx_fld. The function dal_mas_ret_ltx_fld informs you if the Longtext buffer has already been filled. If you need to check texts for Longtext properties, you can use the function dal_mas_chk_val_ltx.

If the user leaves Mask-Edit state, DataView saves all changes to Longtext field contents in the database. The Longtext buffer in local memory remains unchanged until the mask has been filled from the database again.