Show TOC Anfang des Inhaltsbereichs

Funktionsdokumentation set_table_for_first_display  Dokument im Navigationsbaum lokalisieren

Verwendung

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.

Hinweis

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.

Voraussetzungen

Achtung

Die Ausgabetabelle muss 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

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

 

Aktivitäten

Beispiel

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.

Beispiel

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.

 

 

 

 

 

 

 

 

 

 

 

Ende des Inhaltsbereichs