DtvLong dal_mas_set_ltx_fld (idf, row, txt)

Sets a long string for the Longtext field at the row position specified.

Input Parameters Significance
DtvLong idf field-Id
DtvLong row row position
char *txt longstring

Output Parameters Significance
none -

Return Code Significance
0 all ok
1 field is no Longtext field
2 incorrect row position

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.