set_table_for_first_display 

Verwendung

Anzeigen einer Ausgabetabelle in der ALV Control Instanz. Beim Aufruf muß 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 wollen, benutzen Sie die Methode refresh_table_display. Die Methode set_table_for_first_display muß 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.

Voraussetzungen

Die Ausgabetabelle muß entweder global definiert sein oder ein öffentliches Attribut einer Klasse sein.

Funktionsumfang

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

Flag, das die Anwendung setzen sollte, wenn der Aufruf der Methode statisch ist: der Aufruf erfolgt immer mit dem gleichen Feldkatalog. 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 der Benutzer zum Abspeichern eines Layout hat:

  • 'X':         nur globales Speichern
  • 'U':         nur benutzerspezifisches Speichern
  • 'A':         entspricht 'X' und 'U'
  • SPACE:  kein Speichern

I_DEFAULT

Dieser Parameter bestimmt, ob der Benutzer eine Layoutvoreinstellung definieren darf:

  • 'X':       Layoutvoreinstellung erlaubt (Voreinstellung)
  • SPACE: Layoutvoreinstellung nicht erlaubt

Ist eine Layoutvoreinstellung erlaubt, existiert eine solche 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

IT_SPECIAL_GROUPS

Wurden im Feldkatalog mit dem Feld SP_GROUP die Spalten in Gruppen unterteilt, muß man hier eine Tabelle mit Texten für diese Gruppen übergeben. Im Fenster zum aktuellen Layout läßt sich dann die Spaltenauswahl mit einer Listbox auf eine dieser Gruppen eingrenzen.

IT_TOOLBAR_EXCLUDING

Diese Tabelle enthält Funktionskodes der Toolbar, die Sie für die Lebensdauer des ALV Grid Controls ausblenden möchten. Die Funktionskodes sind als Konstanten-Attribute mit dem Prefix MC_FC_ gekennzeichnet.

IT_HYPERLINK

Diese Tabelle ordnet jedem Handle (Feld HANDLE von LVC_S_HYPE ) eine Hyperlinkadresse (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)

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

 

Zur Übersicht: Methoden der Klasse CL_GUI_ALV_GRID

 

Aktivitäten

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.