Event 26: Before Displayed Data is Output in a List

Use

The function module REUSE_ALV_LIST_DISPLAY outputs the list. Other activities can be performed, for example:

Change table/view field display format
Print hidden fields
exclude fields from printing which were not flagged as hidden in the Data Dictionary.

Process

There are no standard routines for this event. The following global data is available for the realization of user routines:

Name		REUSE_ALV_LIST_DISPLAY parameter	Purpose	Default/Value
ALV_VALUE_TAB	Internal table	T_OUTTAB	Contains output values	Filled
VIM ALV_FCAT	Internal table	IT_FIELDCAT	Field Catalog	Dictionary value for table/view
VIM_ALV_VALUE_LENGTH	Parameter	-	For information only: Value table data record internal length	Defined
VIM_ALV_CALLED_BY	Parameter	-	Routine which calls ALV_LIST_DISPLAY	VIM_CALL_ALV
VIM_ALV_EVENTS	Internal table	IT_EVENTS	Events to perform in list output	contains TOP-OF-PAGE event definition
VIM_LIST_HEADER	Internal table	IT_LIST_COMMENTARY (function module REUSE_ALV_COMMENTARY_WRITE)	List header definition	Filled
VIM_ALV_VARIANT	Structure	IS_VARIANT	Variant information	empty
VIM_ALV_LAYOUT	Structure	IS_LAYOUT	Layout information	empty

If the internal table ALV_VALUE_TAB is empty immediately after the event, processing is cancelled. You can change the above parameters in your form routine to change the list structure.

If these formatting options are insufficient, you can specify another form routine, with which you call the ABAP List Viewer, in the VIM_ALV_CALLED_BY field. The definition of this second form routine must have the form FORM <name> TABLES alv_value_tab.

The user form routine should be as follows:

        
FORM <name>: FIELD-SYMBOLS: <fcat> TYPE slis_fieldcat_alv * 1. Strukturtabelle modifizieren... * 1.1. prüfen, ob bereits erledigt READ TABLE vim_alv_fcat WITH KEY fieldname = <fieldname> tabname = <tablename> TRANSPORTING NO FIELDS. * 1.2. falls noch nicht erledigt > modifizieren IF SY-SUBRC ... * Feldinformationen für die evtl. hinzuzufügenden * Felder besorgen * VIM_ALV_FCAT modifizieren, z.B. APPEND oder DELETE * 2. Wertetabelle modifizieren, z.B. Feldinhalte an die * Zeilen anhängen oder Feldinhalte aus den Zeilen * löschen LOOP AT ALV_VALUE_TAB. ......... ENDLOOP. ENDFORM.

Note

See also the documentation of the function modules "REUSE_ALV_…".

Additional List Output Information

The following internal tables must be modified to print or exclude additional fields:

VIM_ALV_FCAT describes the structure of the data to be printed
ALV_VALUE_TAB contains the data to be printed, according to the field catalog VIM_ALV_FCAT.