Skip to content

ABAP Keyword Documentation →  ABAP - Reference →  User Dialogs →  Classic Lists →  Displaying Lists 

SET PF-STATUS - List

Short Reference

Other versions: 7.31 | 7.40 | 7.54

Syntax


SET PF-STATUS status [OF PROGRAM prog] [EXCLUDING fcode] 
                     [IMMEDIATELY].

Extras

1. ... OF PROGRAM prog

2. ... EXCLUDING fcode
3. ... IMMEDIATELY

Effect

During list processing, this statement sets the GUI status specified in status for the display window of the current list, and all subsequent list levels until the next SET PF-STATUS statement. The statement mainly has the same function as for screens.

Unlike the screen layouts of screens, however, every list level is automatically linked to the GUI status that is set for it. If the system returns from displaying a higher list level to a lower list level, the latter is displayed again with the GUI status that was set for it.

If the status of the data object is initial, the standard list status is set and the additions OF PROGRAM and EXCLUDING have no effect. The standard list status contains predefined list-specific functions whose functions are handled by the runtime environment when a screen list is displayed, and do not lead to the call of event blocks in the ABAP program. If event blocks are also defined with AT LINE-SELECTION or AT PFnn, further function keys are automatically assigned function codes in the standard list status:

  • If AT LINE-SELECTION is used, the F2 key and the double-click function of the mouse is assigned the function code "PICK" and the function text Select. This function is then also automatically displayed in the application toolbar.
  • If AT PFnn is used, all the Fnn functions of the keyboard that are not handled by the runtime environment are assigned the function codes "PFnn", where "nn" is a number between 01 and 24.

If the standard list status is set, sy-pfkey is assigned the value "STLI".


Note

When setting the GUI status for the list screen, we recommend that you set a GUI status for which a list status has been included as a template status in the Menu Painter. Including this type of template status copies the list-specific functions of the standard list status into a self-defined GUI status.

Addition 1

... OF PROGRAM prog

Addition 2

... EXCLUDING fcode

Effect

As with screens.

Addition 3

... IMMEDIATELY

Effect

The addition IMMEDIATELY only has an effect if it is used when creating a details list, that is, within an event block following an interactive list event. The effect of this addition is that SET PF-STATUS has an effect on the current displayed list (sy-listi) and all subsequent list levels, and not only starting from the current details list (sy-lsind).


Example

In the following program segment, it is only possible to select a single line from the basic list by double-clicking the mouse or using the function key F2. This function is then deactivated for the basic list and all subsequent list levels.

START-OF-SELECTION. 
  SET PF-STATUS 'BASIC'. 
  WRITE / `Pick me!`. 

AT LINE-SELECTION. 
  SET PF-STATUS 'BASIC' EXCLUDING 'PICK' IMMEDIATELY. 
  WRITE / `Don't pick me!`.