List

GET_LIST

Mit der Methode GET_LIST bekommt man über die ControlID die Instanz der Liste zurück und hat dann Zugriff auf die Eigenschaften der Liste. Sie wird genutzt, um verschiedene Elemente in einer geordneten oder ungeordneten Listendarstellung anzuzeigen.

Attribute im Designer

List

AttributBeschreibungStandardwert
controlIdEindeutige Id der KomponenteWird automatisch generiert
noDataTextText, der bei fehlenden Items angezeigt werden soll
showNoDataDefiniert, ob ein No-Data-Text bei fehlenden Items angezeigt werden sollTrue
headerTextText der Überschrift
itemsListe der möglichen Items, repräsentiert durch einen List Item
modeAuswahlmodus in der Liste mit möglichen Werten: None, SingleSelect, SingleSelectLeft, SingleSelectMaster, MultiSelectNone
visibleGibt an, ob die Komponente angezeigt werden solltrue
spanSGibt die Breite des Controls im Grid-Layout an. Definiert, wie viele Spalten eingenommen werden sollen12
spanMGibt die Breite des Controls im Grid-Layout an. Definiert, wie viele Spalten eingenommen werden sollen12
spanLGibt die Breite des Controls im Grid-Layout an. Definiert, wie viele Spalten eingenommen werden sollen12
spanXLGibt die Breite des Controls im Grid-Layout an. Definiert, wie viele Spalten eingenommen werden sollen12
MethodeBeschreibung
ADD_LIST_ITEMHinzufügen eines Elements zur Liste
ADD_LIST_ITEMSHinzufügen mehrerer Elemente zur Liste
GET_HEADER_TEXTSetzen des Texts des Headers
GET_ITEMLesen eines Elements anhand eines Schlüssels
GET_ITEMSLesen aller Items
GET_MODELesen des gesetzten Auswahlmodus‘
GET_NO_DATA_TEXTLesen des gesetzten No-Data-Texts
GET_SELECTED_ITEMSLesen der ausgewählten Items
GET_SHOW_NO_DATALesen, ob der No-Data-Text angezeigt wird
ITEMS_COUNTLesen der Anzahl aller Items
REMOVE_ALL_ITEMSEntfernen aller Elemente in der Liste
REMOVE_ITEMEntfernen eines Items anhand einer ID
SET_HEADER_TEXTSetzen des Texts des Headers
SET_MODESetzen des Auswahlmodus‘
SET_NO_DATA_TEXTSetzen des No-Data-Texts
SET_SHOW_NO_DATASetzen, ob der No-Data-Text angezeigt werden soll

Code-Beispiel

List
DATA(ls_list_item_1) = VALUE /mobbuild/cl_list=>ty_list_item(
  key = 'item_1'
  title = 'item_1_title'
  description = 'item_1_description'
  visible = abap_true
).

  lo_list->add_list_item( ls_list_item_1 ).

Geerbte Methoden von

CONTROL

Vererbt an

Keine

Implementiert das Interface

Keines

Methoden

ADD_LIST_ITEM

Hinzufügen eines Elements zur Liste.

ÜbergabeparameterTypStandardwertBeschreibung
IS_STANDARD_LIST_ITEMTY_LIST_ITEMHinzuzufügendes Listen-Item
RückgabeparameterTypBeschreibung
RO_CONTROLListReferenz auf this, um Methodenverkettung zu erlauben

ADD_LIST_ITEMS

Hinzufügen mehrerer Elemente zur Liste.

ÜbergabeparameterTypStandardwertBeschreibung
IT_LIST_ITEMSTT_LIST_ITEMListe der hinzuzufügenden Items
RückgabeparameterTypBeschreibung
RO_CONTROLListReferenz auf this, um Methodenverkettung zu erlauben

GET_HEADER_TEXT

Lesen des Texts des Headers.

RückgabeparameterTypBeschreibung
RV_VALUEStringAuszulesender Header-Text

GET_ITEM

Lesen eines Items anhand eines Keys.

ÜbergabeparameterTypStandardwertBeschreibung
IV_KEYStringKey, anhand dessen ausgelesen werden soll
RückgabeparameterTypBeschreibung
RS_LIST_ITEMTY_LIST_ITEMAuszulesendes Item

GET_ITEMS

Lesen aller Items.

RückgabeparameterTypBeschreibung
RT_LIST_ITEMTT_LIST_ITEMAlle Items in der Liste

GET_MODE

Lesen des Auswahlmodus‘.

RückgabeparameterTypBeschreibung
RV_LIST_MODEStringGesetzter Auswahlmodus mit möglichen Werten None, SingeSelect, SingleSelectLeft, SingleSelectMaster, MultiSelect

GET_NO_DATA_TEXT

Lesen des No-Data-Texts. Dieser kann angezeigt werden, wenn keine Daten in der Liste vorhanden sind. Standard auf „Keine Daten“ gesetzt.

RückgabeparameterTypBeschreibung
RV_VALUEStringGesetzter No-Data-Text

GET_SELECTED_ITEMS

Lesen aller ausgewählten Items.

RückgabeparameterTypBeschreibung
RT_LIST_ITEMTT_LIST_ITEMAlle ausgewählten Items

GET_SHOW_NO_DATA

Lesen, ob der No-Data-Text angezeigt wird. Dies passiert in der Regel, wenn keine Daten zur Liste hinzugefügt wurden.

RückgabeparameterTypBeschreibung
RV_VALUEBOOLE_DTrue, wenn der No-Data-Text angezeigt wird, andernfalls False

ITEMS_COUNT

Lesen der Anzahl aller hinzugefügten Items.

RückgabeparameterTypBeschreibung
RV_COUNTIAnzahl aller Items

REMOVE_ALL_ITEMS

Entfernen aller Items.

RückgabeparameterTypBeschreibung
RO_CONTROLListReferenz auf this, um Methodenverkettung zu erlauben

REMOVE_ITEM

Entfernen eines Items anhand eines Keys.

ÜbergabeparameterTypStandardwertBeschreibung
IV_KEYStringKey des zu entfernenden Items
RückgabeparameterTypBeschreibung
RO_CONTROLListReferenz auf this, um Methodenverkettung zu erlauben

SET_HEADER_TEXT

Setzen des Texts des Headers.

ÜbergabeparameterTypStandardwertBeschreibung
IV_VALUEStringZu setzender Header-Text
RückgabeparameterTypBeschreibung
RO_CONTROLListReferenz auf this, um Methodenverkettung zu erlauben

SET_MODE

Setzen des Auswahlmodus‘.

ÜbergabeparameterTypStandardwertBeschreibung
IV_LIST_MODEStringZu setzender Auswahlmodus mit möglichen Werten None, SingeSelect, SingleSelectLeft, SingleSelectMaster, MultiSelect
RückgabeparameterTypBeschreibung
RO_CONTROLListReferenz auf this, um Methodenverkettung zu erlauben

SET_NO_DATA_TEXT

Setzen des No-Data-Texts. Dieser kann angezeigt werden, wenn keine Daten in der Liste vorhanden sind. Standard auf „Keine Daten“ gesetzt.

ÜbergabeparameterTypStandardwertBeschreibung
IV_VALUEStringZu setzender No-Data-Text
RückgabeparameterTypBeschreibung
RO_CONTROLListReferenz auf this, um Methodenverkettung zu erlauben

SET_SHOW_NO_DATA

Setzen, ob der No-Data-Text angezeigt werden soll. Dies passiert in der Regel, wenn keine Daten zur Liste hinzugefügt wurden.

ÜbergabeparameterTypStandardwertBeschreibung
IV_VALUEBOOLE_DTrue, wenn der No-Data-Text angezeigt werden soll, andernfalls False
RückgabeparameterTypBeschreibung
RO_CONTROLListReferenz auf this, um Methodenverkettung zu erlauben