Ansicht
Dokumentation

EFG_SELECTION_LISTX - INTERN: Popup zur Auswahl aus einer Liste

Addresses (Business Address Services)   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

(last update 97-08-08)

Zeigt eine tabellarische Liste (auf Wunsch als Dialogfenster) an, in dem eine oder mehrere Tabellenzeilen ausgewählt werden können.

Die Tabelle hat pro auswählbarem Eintrag eine Zeile und bis zu drei Spalten:

• Typspalte zur Klassifizierung des Eintrags (z.B. Objekttyp)

• Schlüsselspalte zur Identifizierung des Eintrags

• Textspalte zur Beschreibung des Eintrags.

Über der eigentlichen Auswahlliste kann ein (maximal dreizeiliger) Kommentar ausgegeben werden, der in den Parametern X_COMMENTn übergeben wird.

Mit dem Parameter X_TITLE kann ein Fenstertitel vorgegeben werden. Sonst wird ein Standardtitel verwendet.

Fensterposition und Größe
Die Fenstergröße wird dynamisch aus den Zeilentexten, den Kommentartexten und dem Titel bestimmt. Die Fensterposition ist fest.
In den Parametern X_MINLEN_... können Mindestausgabelängen für die drei Spalten vorgegeben werden.
Mit den Parametern X_SUPPRESS_* kann die Typ- bzw. Schlüsselspalte deaktiviert werden.

Mit dem Parameter X_SELECTMODE wird gesteuert, ob ein (S) oder mehrere (M) Zeilen auswählbar sind oder ob die Liste nur angezeigt (D) wird.

• Einfachauswahl
  Die auswählbaren Tabellenzeilen können als Hotspot ausgegeben werden (Auswahl einer Zeile erfolgt durch Einfachklick), falls der Parameter X_HOTSPOT gesetzt ist.

• Mehrfachauswahl
  Jede auswählbare Zeile beginnt mit einem Ankreuzfeld zur Auswahl dieser Zeile. Die Bestätigung der Auswahl erfolgt mit Enter oder der entsprechenden Drucktaste.

Selektionsliste
Die Liste der Auswahlmöglichkeiten wird in der Tabelle T_SELECTLIST übergeben, die aus folgenden Feldern besteht (Struktur EBASELLIST):

• LINETYPE

Zeilentyp der Tabellenzeile. Folgende Werte sind möglich:

• SPACE:,,Standardzeile mit Typ-, Schlüssel- und Textspalte

• 'L': ,,waagerechte Linie; falls das Feld TEXT gefüllt ist, überlagert es die Linie ab Position 3 (Rahmentext).

• '1': ,,Text des Felds MULTITEXT wird über die gesamte Breite der drei Spalten ausgegeben.

• '2': ,,Text des Felds MULTITEXT wird über die Breite der Schlüssel- und Textspalte angegeben. Die Typspalte wird aus dem Feld TYPETEXT gefüllt.

• TOPOFPAGE
  Zeilen, bei denen dieses Kennzeichen gesetzt ist, werden zum Zeitpunkt TOP-OF-PAGE ausgegeben (als Überschrift) und bleiben dadurch beim Scrollen sichtbar.

• SELECTED
  Selektionskennzeichen für diese Zeile. Bei Einfachauswahl ist beim Rücksprung genau die ausgewählte Zeile hier mit einem 'X' versehen. Bei Mehrfachauswahl sind beliebig viele Zeilen selektiert. Auch die Vorbelegung von Zeilen mit 'X' ist in diesem Fall möglich.

• NO_SELECT
  Diese Zeile ist nicht auswählbar (Ankreuzfeld nicht eingabebereit bzw. Hotspot/F2 nicht wirksam)

• BOX_INVSBL
  Unterdrückt das Ankreuzfeld in dieser Zeile (nur bei Mehrfachauswahl)

• CALLINDEX
  Beliebiger durch den Aufrufer verwendbarer numerischer Ausdruck (z.B. Index in einer internen Tabelle).

• TYPETEXT, TYPECOLOR, TYPEINTSV

Feld zur Übergabe eines Objekttypbezeichners, der dann in der ersten Spalte (evtl. nach dem Ankreuzfeld) angezeigt wird. Soll der Typ nur intern benutzt werden, kann die Anzeige der Typspalte mit Parameter X_SUPPRESS_TYPE unterdrückt werden. Ist der Typ in keiner Zeile gefüllt, wird die Typspalte nicht angezeigt.

Der Text der Typspalte wird in der angegeben Farbe unter Berücksichtigung des Intensitätskennzeichens ausgegeben.

• KEYTEXT, KEYCOLOR, KEYINTSV

Feld zur Übergabe eines Schlüsselwertes, der dann in der mittleren Spalte angezeigt wird. Soll der Schlüssel nur intern benutzt werden, kann die Anzeige der Schlüsselspalte mit Parameter X_SUPPRESS_KEY unterdrückt werden. Ist der Schlüssel in keiner Zeile gefüllt, wird die Schlüsselspalte nicht angezeigt.

Der Text der Schlüsselspalte wird in der angegeben Farbe unter der Berücksichtigung des Intensitätskennzeichens ausgegeben.

• TEXT, TEXTCOLOR, TEXTINTSV

Text zur Beschreibung der Auswahlalternative.

Der Text wird an letzter Stelle in der angegebenen Farbe unter Berücksichtigung des Intensitätskennzeichens ausgegeben.

• MULTITEXT

Feld für Texte, die sich über mehrere Spalten erstrecken (siehe Feld LINETYPE). Der Text wird in der in TEXTCOLOR/TEXTINTSV spezifizierten Farbe ausgegeben.

Abbruch

Die Liste kann mit der entsprechenden Drucktaste ohne Auswahl abgebrochen werden. Dann endet der Baustein mit Exception CANCELLED.

Eigene Funktionen auf der Auswahlliste

Sie können die Auswahlliste um eigene Funktionen erweitern und einen eigenen PF-Status verwenden.

Wenn ein eigener Status verwendet werden soll, muss im Parameter X_CALLBACK_STATUS der Name eines Forms angegeben werden, in der der Aufrufer seinen eigenen Status setzen kann.
Das Form hat keine Parameter und wird in dem im Parameter X_CALLBACK_PROGRAM spezifizierten Programm aufgerufen.

Löst der Benutzer auf der Selektionsliste eine Funktion aus, wird das im Parameter X_CALLBACK_USER_COMMAND angebene Form aufgerufen.
Das Form kann etwa wie folgt definiert werden:

form

     using    x_ucomm             like sy-ucomm

              x_index             like sy-index

              x_selline           like ebasellist

     changing xy_exit_list        like ebagen-kennzx

              xy_process_standard like ebagen-kennzx.

Die Parameter des Forms haben folgende Bedeutung:

• X_UCOMM
  ausgelöster Funktionscode

• X_INDEX
  Index der Zeile, auf der der Cursor steht.

• X_SELLINE
  Inhalt der Zeile, auf der der Cursor steht.

• XY_EXIT_LIST
  Kennzeichen, ob die Selektionsliste verlassen werden soll.

• XY_PROCESS_STANDARD
  Kennzeichen, ob die Standardfuktionsbehandlung für den Funktionscode ausgeführt werden soll. Folgende Funktionscodes werden von der Selektionsliste interpretiert:

• CANC: Abbrechen

• OKAY: Übernehmen/Weiter

• MALL: Alle markieren (nur bei Mehrfachselektion)

• MDLT: Alle Markierungen löschen (nur bei Mehrfachselektion)

• PICK: Auswählen (nur bei Einfachselektion)

Beispiel

Einfachauswahl aus 3 Alternativen im Dialogfenster (Auswahl per Hotspot):

report xy.

include .

data: selind like sy-tabix,

      isel   like ebasellist occurs 3 with header line.

start-of-selection.

  isel-textcolor = col_normal.

  isel-text = 'Erste Möglichkeit'.

  append isel.

  isel-text = 'Zweite Auswahlalternative'.

  append isel.

  isel-text = 'Letze Chance'.

  append isel.

  call function 'EBA_SELECTION_LIST'

       exporting

            x_hotspot    = 'X'

       importing

            y_selectind  = selind

       tables

            t_selectlist = isel

       exceptions

            cancelled    = 1.

  if sy-subrc = 1 or selind is initial.

    write / 'Sie haben nichts ausgewählt.'.

  else.

    read table isel index selind.

    write: / 'Ihre Auswahl:',

           / isel-text.

  endif.

Hinweise

Die Festwerte zum Parameter X_SELCETMODE sind als Konstanten im Include IEBACONS definiert:

• CO_SELEMOD_DISPLAY ,,Anzeigemodus

• CO_SELEMOD_SINGLE ,,Einfachauswahl

• CO_SELEMOD_MULTI ,,Mehrfachauswahl

Dies Festwerte zum Feld LINETYPE in T_SELECTLIST sind ebenfalls dort definiert:

• CO_LINTYPE_STANDARD ,,Standardzeile

• CO_LINTYPE_LINE ,,Linie

• CO_LINTYPE_MULTI1 ,,Zeile über alle drei Spalten

• CO_LINTYPE_MULTI2 ,,Zeile mit zwei Spalten

Weiterführende Informationen

Parameter

T_SELECTLIST
X_COMMENT1
X_COMMENT2
X_COMMENT3
X_FLG_ALV
X_HOTSPOT
X_LENGTH_KEY
X_LENGTH_TEXT
X_LENGTH_TYPE
X_POPUP
X_RIF_ALV_CALLBACK
X_SELECT_MODE
X_STR_HEADER
X_SUPPRESS_KEY
X_SUPPRESS_TYPE
X_TITLE
X_WIDTH
Y_SELECTIND
Y_STR_SELECTED

Ausnahmen

CANCELLED

Funktionsgruppe

EFGSELLIST

CPI1466 during Backup   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 13558 Date: 20240523 Time: 135027     sap01-206 ( 131 ms )