Event 26 

Execution : 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:

Realization

This event has no standard routine. The following global data is available for the realization of the user routine:

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 form routine is as follows:

FORM <name>:
FIELD-SYMBOLS: <fcat> TYPE slis_fieldcat_alv
*1. Modify structure table...
*1.1. check whether already done

READ TABLE vim_alv_fcat WITH KEY field name = <field name>
tabname = <table name> TRANSPORTING NO FIELDS.

*1.2. if not yet done > modify

IF SY-SUBRC...

* Get field information for fields to be inserted
* modify VIM_ALV_FCAT, e.g. APPEND or DELETE

* 2. Modify value table, e.g. insert or remove fields in rows

LOOP AT ALV_VALUE_TAB.
.........
ENDLOOP.
ENDFORM.

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: