DtvLong dal_iwf_lis_ref (ent_mas)

Creates the defined refine list widget for the relation, loads the corresponding data and outputs it on the screen.

Input Parameters Significance
char *ent_mas name of the entity-1 [> < = from widget]
name of the entity-2 [> < = selection menu]
name of the view [> < = selection menu]
name of the list [> < = default refine list]

Output Parameters Significance
none -

Return Code Significance
0 no error
1 wrong entity-1 name passed
2 specified relation does not exist
3 no access to the relation granted
4 no list for the relation defined
GLB_RET_BRK menu cancelled < glbdef.h >

Can be invoked as on_select-userexit in any menu or on_event-userexit in any state of the user interface.

If you invoke the function from the widget menu, you may not pass the entity-1 (is read from the active widget automatically).

You can only pass a view together with the entity-2.

If you do not pass an entity-2 and no view, DataView will create a selection menu containing all relations already defined at the entity-1.

You can only pass a list together with the view.

If you do not pass any list, DataView will create the widget using the default refine list specified in the relation definition.

All parameters must be separated by spaces.