DtvLong dal_iwf_ins_elm ()

Inserts a new record at the current cursor position of the mask of the active widget, puts the mask into insert mode of mask edit state and jumps into the mask-edit-loop.

Input Parameters Significance
none -

Output Parameters Significance
none -

Return Code Significance
0 no error
1 no insert operation possible in main entity in the widget
2 parent element of the relation is temporarily deleted
3 parent element of the relation is finally deleted
4 parent element of the relation is locked
5 no insert-access to the main entity in the widget granted
6 no creation of new records possible in the mask

Can be invoked as on_select-userexit in widget menus or as on_event-userexit in the widget state of a mask. Calls in SEL- or MAS states are not allowed.

The system checks the edit_action-trigger before editing, the pre_action-trigger before the insert transaction, and the post_action-trigger of the mask after the insert transaction.During this process the triggers execute the functions you programmed for insert mode.

Attention! A new master entry and a new relation entry will be created in relation masks.