DtvLong dal_wdg_ret_act ()

Returns the ident number of the active widget.

Input Parameters Significance
no -

Output Parameters Significance
no -

Return Code Significance
value Id of the active widget,
If no widget is active -> Id of the trash basket widget

This function is an elementary function for usage in mask triggers. You need the widget Id in order to edit widget attributes or to establish the path to the active mask.

If data are finally deleted from a mask (dal_wdh_del_tra), not the active widget but the trash basket widget is the source mask. Thus, you should use dal_wdg_ret_tra to determine the active widget Id within action userexits in Delete mode instead of dal_wdg_ret_act.

This function always returns a widget Id. If no widget is active, the Id of the trash basket is returned. Thus, Checks for 0 are not required because the return code 0 does not exist.