set_table_for_first_display
Anzeigen einer Ausgabetabelle in der ALV-Control-Instanz. Beim Aufruf muss entweder eine Referenzstruktur des Data Dictionary angegeben werden oder ein passender Feldkatalog. Sie können mit optionalen Parametern zusätzlich vor Ausführung ein Layout laden, die Tabelle nach Feldern sortieren, für Spalten einen Filter setzen und Eigenschaften des Grid Controls festlegen.

Wenn Sie die angezeigten Daten der Ausgabetabelle auffrischen möchten, benutzen Sie die Methode refresh_table_display. Die Methode set_table_for_first_display muss nur ein zweites Mal aufgerufen werden, wenn sich die Struktur der Ausgabetabelle ändert.
Der Report BCALV_GRID_DEMO der Entwicklungsklasse SLIS ist ein Beispiel für den einfachsten Aufruf dieser Methode.

Die Ausgabetabelle muss entweder global definiert sein oder ein öffentliches Attribut einer Klasse sein.
CALL METHOD <Ref.var. auf CL_GUI_ALV_GRID > ->set_table_for_first_display
EXPORTING
I_BUFFER_ACTIVE =
<beliebiger Typ (
ANY )>
I_STRUCTURE_NAME =
<String vom Typ
DD02L-TABNAME>
IS_VARIANT =
<Struktur vom Typ
DISVARIANT>
I_SAVE =
<Var. vom Typ
CHAR01>
I_DEFAULT =
< Var. vom Typ
CHAR01>
IS_LAYOUT =
<Struktur vom Typ
LVC_S_LAYO>
IS_PRINT =
<Struktur vom Typ
LVC_S_PRNT>
IT_SPECIAL_GROUPS =
<interne Tabelle vom Typ
LVC_T_SGRP>
IT_TOOLBAR_EXCLUDING =
<interne Tabelle vom Typ
UI_FUNCTIONS>
IT_HYPERLINK =
<interne Tabelle vom Typ
LVC_T_HYPE>
IT_ALV_GRAPHICS =
<interne Tabelle vom Typ
DTC_T_TC>
CHANGING
IT_OUTTAB =
<interne Tabelle>
IT_FIELDCATALOG =
<interne Tabelle vom Typ LVC_T_FCAT>
IT_SORT =
<interne Tabelle vom Typ LVC_T_SORT>
IT_FILTER =
<interne Tabelle vom Typ LVC_T_FILT>
Parameter |
Bedeutung |
I_BUFFER_ACTIVE |
Kennzeichen, das die Anwendung setzen sollte, wenn der Aufruf der Methode statisch ist: Das bedeutet, dass der Aufruf immer mit dem gleichen Feldkatalog erfolgt. In diesem Fall kann der Feldkatalog in einem speziellen Buffer gehalten werden. Dies beschleunigt besonders die Anzeige von kleinen Listen. |
I_STRUCTURE_NAME |
Name der DDIC-Struktur (z.B: 'SFLIGHT') zu den Daten in der Ausgabetabelle. Bei Angabe dieses Parameters wird der Feldkatalog vollautomatisch generiert. |
IS_VARIANT |
Bestimmt das Layout, mit der die Ausgabetabelle angezeigt werden soll. Bei Verwendung dieses Parameters müssen Sie wenigstens das Feld REPORT der Struktur vom Typ DISVARIANT füllen. |
I_SAVE |
Bestimmt, welche Möglichkeiten Benutzer zum Speichern eines Layouts haben: ● 'X': nur globales Speichern ● 'U': nur benutzerspezifisches Speichern ● 'A': entspricht 'X' und 'U' ● SPACE: kein Speichern |
I_DEFAULT |
Dieser Parameter bestimmt, ob Benutzer eine Layoutvoreinstellung definieren dürfen: ● 'X': Layoutvoreinstellung erlaubt (Voreinstellung) ● SPACE: Layoutvoreinstellung nicht erlaubt Ist eine Layoutvoreinstellung erlaubt, existiert ein solches Layout und ist kein abweichendes Layout in IS_VARIANT angegeben, wird die Layoutvoreinstellung beim Aufruf dieser Methode automatisch geladen. |
IS_LAYOUT |
Bestimmt Eigenschaften des Grid Controls. Die Layout-Struktur hat nichts mit dem Layout zum Speichern der Filter-, Sortier- und Spalteneigenschaften zu tun. |
IS_PRINT |
Parameter für das Drucken am Backend Eines der Felder der Struktur LVC_S_PRNT ist PRINT_CTRL. Sie benutzen es, um Parameter für das Drucken bereitzustellen. Wenn Sie PRINT_CTRL benutzen, stellen Sie sicher, dass Sie zunächst die Parameter über den Funktionsbaustein UNSET_PRINTPARAMETER initialisieren. |
IT_SPECIAL_GROUPS |
Wurden im Feldkatalog mit dem Feld SP_GROUP die Spalten in Gruppen unterteilt, muss man hier eine Tabelle mit Texten für diese Gruppen übergeben. Im Fenster zum aktuellen Layout lässt sich dann die Spaltenauswahl auf eine dieser Gruppen über ein Listenfeld eingrenzen. |
IT_TOOLBAR_EXCLUDING |
Diese Tabelle enthält Funktionscodes der Toolbar, die Sie für die Lebensdauer des ALV Grid Controls ausblenden möchten. Die Funktionscodes sind als Konstanten-Attribute mit dem Präfix MC_FC_ gekennzeichnet. |
IT_HYPERLINK |
Diese Tabelle ordnet jedem Handle (Feld HANDLE von LVC_S_HYPE) eine Hyperlink-Adresse (Feld HREF von LVC_S_HYPE) zu. Über das Handle kann man dann Hyperlinks im Grid einbinden. |
IT_ALV_GRAPHICS |
Einstellungen für die Darstellung der ALV-Liste als Diagramm (zum Beispiel Achsenbeschriftungen). Der Zeilentyp der Tabelle hat zwei Felder (Variablen-/Werte-Paare): ● PROP_ID: Weisen Sie diesem Feld ein Konstanten-Attribut der Klasse CL_ALV_GRAPHICS_CU mit dem Präfix CO_PROPID_ zu, um festzulegen, was in der Grafik geändert werden soll. Mit dem Attribut CL_ALV_GRAPHICS_CU=>CO_PROPID_TITLE beziehen Sie sich beispielsweise auf den Titel des Diagramms. ● PROP_VAL: Der Wert zum zugehörigen Topic, beispielsweise 'My Title'. |
IT_OUTTAB |
Ausgabetabelle mit den anzuzeigenden Daten. |
IT_FIELDCATALOG |
Bestimmt die Struktur der Ausgabetabelle und die Formatierung der anzuzeigenden Daten |
IT_SORT |
Tabelle mit Sortiereigenschaften für Spalten, die initial sortiert werden sollen |
IT_FILTER |
Tabelle mit Filtereigenschaften für Spalten, bei denen initial ein Filter gesetzt werden soll |
Weitere Informationen finden Sie unter Methoden der Klasse CL_GUI_ALV_GRID

Bei diesem Aufruf erzeugt das ALV Grid Control den Feldkatalog zur Ausgabetabelle vor der Anzeige automatisch über eine DDIC-Struktur:
DATA: GRID1 TYPE REF TO CL_GUI_ALV_GRID,
GT_SFLIGHT TYPE TABLE OF
SFLIGHT.
<Instanziierung von GRID1 und Integration auf Dynpro>
CALL METHOD
GRID1->SET_TABLE_FOR_FIRST_DISPLAY
EXPORTING I_STRUCTURE_NAME = 'SFLIGHT'
CHANGING IT_OUTTAB =
GT_SFLIGHT.

Feldkatalog explizit übergeben:
DATA: GRID1 TYPE REF TO CL_GUI_ALV_GRID,
GT_SFLIGHT TYPE TABLE OF SFLIGHT,
GT_FIELDCAT TYPE
LVC_T_FCAT.
<Manueller oder halbautomatischer
Aufbau des Feldkatalogs>
<Instanziierung von GRID1 und Integration
auf Dynpro>
CALL METHOD
GRID1->SET_TABLE_FOR_FIRST_DISPLAY
CHANGING
IT_FIELDCATALOG = GT_FIELDCAT
IT_OUTTAB =
GT_SFLIGHT.