Table Control

ABAP/4 table control

Basic form

CONTROLS ctrl TYPE TABLEVIEW USING SCREEN scr.

Effect

Creates a table control ctrl of the type TABLEVIEW. The reference screen for the initialization is the screen scr.

Area of use

The table control (referred to here as TC ) facilitates the display and entry of one-line, tabular data in dialog transactions.
The functional scope has been defined so that you can implement many typical set operations that are usually handled by an elementary STEP-LOOP very easily with the standard methods of a TC.

Functional scope

Programming

The data exchange between the application and the SAPgui is achieved with a STEP-LOOP , i.e. an ABAP/4 module is called to transfer data for each page.

PROCESS BEFORE OUTPUT. 
LOOP WITH CONTROL ctrl. 
  MODULE ctrl_pbo. 
ENDLOOP. 
 
PROCESS AFTER INPUT. 
LOOP WITH CONTROL ctrl. 
  MODULE ctrl_pai. 
ENDLOOP.

In this case, the module ctrl_pbo OUTPUT is called once for each output line before the screen is displayed, in order to fill the output fields.
After the user has entered data on the screen, the module ctrl_pai INPUT is executed to check the input and copy the new contents.

PROCESS BEFORE OUTPUT. 
LOOP AT itab WITH CONTROL ctrl CURSOR ctrl-CURRENT_LINE. 
ENDLOOP. 
 
PROCESS AFTER INPUT. 
LOOP AT itab WITH CONTROL ctrl. 
  MODULE ctrl_pai. 
ENDLOOP.

Here, the system fills the output fields before displaying the screen by reading the internal table itab.
When the user has entered data, the module ctrl_pai INPUT must be executed to check the input and to refresh the contents of the internal table.
If there are several table controls on one screen, the order of the loop statements in the flow logic must correspond to the order of the controls on the screen (from top left to bottom right).
Vertical scrolling with the scroll bar is followed by the event PAI for the displayed page. Then, cntl-TOP_LINE is increased and PBO is processed for the next page.
Program-driven scrolling and the most of the functionality described above is achieved by manipulating the control attributes.

Attributes

The CONTROLS statement creates a complex data object of the type CXTAB_CONTROL with the name of the control.

You maintain the initial values in the Screen Painter and assign the screen with the initial values for a control using the addition USING SCREEN.

Initialization is achieved automatically in the "1st access to the control" (setting or reading values).

You can use the Customizing button (in the top right corner) to save the current setting (column widths and column positions) and use it as the initial value for the next call.

All the initial values can be overwritten by the program using the MOVE ... TO TC attributes statement.

The contents of the SCREEN structure (table Cols) acts as a default value for each line of this column, but within LOOP ... ENDLOOP (flow logic), it can be overwritten by LOOP AT SCREEN / MODIFY SCREEN.

With the attributes listed below, you should be aware of the following:

LINES This must always be set as the only attribute if you are not using LOOP AT itab.

TOP_LINE Also set by the SAPgui through the vertical scroll bar slider box.

CURRENT_LINE Read only, set by the system (TOP_LINE + SY-STEPL - 1)

LEFT_COL Also set by the SAPgui through the horizontal scroll bar slider box.

COLS-INDEX Also set by the SAPgui after moving columns.

COLS-SELECTED Also set by the SAPgui after column selection.

When displaying the control, the system uses the current contents when the event DCO occurs (i.e. after all PBO modules have run). The modified values (changed by the user on the screen) are set immediately after DCI (i.e. before the first PAI module runs).