DtvLong dal_iwf_brw_ent (par)

Fills the current browser window with data.

Input Parameters Significance
char par Id and parameters of the sub-function:
[] = dal_iwf_lis_ent
C>[] = dal_iwf_lis_typ
R>[] = dal_iwf_lis_ref
A>[] = dal_iwf_lis_agg

Output Parameters Significance
none -

Return Code Significance
0 no error
1 function is not supported for current client

Can be called as On_Select userexit at any menu item or as On_Event userexit in any state of the user interface.

The model object (entity, type, refine-relation, aggregate-relation) defines the beginning of the structure display. All records in the corresponding table will be displayed as objects of the first level in the browser window.

If, alternatively, @ACT is specified, the beginning of the structure display will be automatically set to the table which the currently active mask is pointing to. After opening the browser, all records displayed in the mask will be displayed as objects of the first level in the browser window.

If, alternatively, @SEL is specified, all selected records in the active mask will be displayed as elements of the first level in the browser window. In forms this is the record displayed.

Note! For DTV version 4.1 and higher, in lists the behaviour at @SEL is the same like at @ACT.

If no model object is specified, the browser will automatically display all entities of the application as objects of the first level in the structure window.

The list named defines, which list will open after a mouse double click on an object icon and which data of the object will be displayed (subsequently called browser list).

If no list is specified, the default list of the passed model object will open.

The index tabs for the relation selection of directly inherited from the Select menu of the browser list. DataView checks the selection userexits installed there and automatically recognises functions used to display depending elements (e.g. dal_iwf_lis_agg, dal_iwf_lis_ref, ...).

The call of dal_iwf_brw_ent is asynchronous. That`s why you may only refer to the current widget with @ACT or @SEL when you call this function from within a program if it does not change within the current program flow.

The call of dal_iwf_brw_ent with @ACT or @SEL does not work within an initialization routine specified via the USXINIT default variable.