Combo Box

GET_COMBO_BOX

Mit der Methode GET_COMBO_BOX bekommt man über die ControlID die Instanz der Combo-Box zurück und hat dann Zugriff auf die Eigenschaften der Combo-Box.

Eine Combo-Box ist ein grafisches Bedienelement in Benutzeroberflächen, das eine Kombination aus einem Textfeld und einer Dropdown-Liste darstellt.

Attribute im Designer

AttributBeschreibungStandardwert
controlIdEindeutige Id der KomponenteWird automatisch generiert
widthBreite der ComboBox
maxWidthMaximale Breite, die die ComboBox annehmen kann100%
showClearIconBestimmt, ob das Löschen-Icon angezeigt werden soll. Bei Klick auf dieses wird die Eingabe in die ComboBox gelöschtfalse
itemsListe der möglichen Items, repräsentiert durch ein Combo Box Item
selectedEingegebener Wert in der ComboBox. Kann benutzt werden, um nach Items zu suchen
valueStateBestimmt den Status der ComboBox mit möglichen Eingabewerten: Error, Warning, Success, Information, NoneNone
valueStateTextBestimmt den Text, der zum valueState (Status der ComboBox) angezeigt werden soll
editableDefiniert, ob die CheckBox bearbeitet werden kann.true
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_ITEMEine Option hinzufügen
ADD_ITEMSMehrere Optionen hinzufügen
GET_SELECTED_KEYLesen der ausgewählten Option
ITEMS_COUNTLesen der Anzahl aller Optionen
REMOVE_ALL_ITEMSAlle Optionen löschen
REMOVE_ITEMOption löschen
SET_SELECTED_KEYSetzen der auszuwählenden Option

Code-Beispiel

ComboBox
DATA(lo_cb_color) = me->get_combo_box( 'cbColors' ).

" set selected key
" hint:
"   with the set selected key method, the value is also
"   set with the value of the text property. If the key
"   does not exist, value is set to initial
lo_cb_color->set_selected_key( space ).

" set value state and value state text
lo_cb_color->set_value_state( /mobbuild/cl_value_state=>co_none ).
lo_cb_color->set_value_state_text( space ).

" add or remove items from combo box control (add_item / remove_item / remove_all_items)
lo_cb_color->remove_item( iv_key = 'Green' ).

" set focus on the control
me->set_focus( iv_control_id = 'cbColors' ).

Geerbte Methoden von

CONTROL

INPUT BASE

Vererbt an

Keine

Implementiert das Interface

Keines

Methoden

ADD_ITEM

Eine Option hinzufügen.

ÜbergabeparameterTypStandardwertBeschreibung
IV_KEYStringNeue Option
IV_TEXTStringAnzuzeigender Text der neuen Option
RückgabeparameterTypBeschreibung
RO_CONTROLCombo BoxReferenz zu this, um Methodenverkettung zu erlauben

ADD_ITEMS

Mehrere Optionen hinzufügen.

ÜbergabeparameterTypStandardwertBeschreibung
IT_DATAANY TABLEReferenztabelle
IV_KEY_FIELD_NAMEStringAlle Schlüssel zu den Optionen
IV_TEXT_FIELD_NAMEStringAlle Texte zu den Optionen
RückgabeparameterTypBeschreibung
RO_CONTROLCombo BoxReferenz zu this, um Methodenverkettung zu erlauben

GET_SELECTED_KEY

Lesen der ausgewählten Option. Mögliche Optionen müssen vorher zur Combo-Box hinzugefügt werden.

RückgabeparameterTypBeschreibung
RV_VALUEStringAusgewählte Option

ITEMS_COUNT

Lesen der Anzahl aller Optionen.

RückgabeparameterTypBeschreibung
RV_COUNTIAnzahl aller Optionen

REMOVE_ALL_ITEMS

Alle Optionen aus der Combo-Box entfernen.

RückgabeparameterTypBeschreibung
RO_CONTROLCombo BoxReferenz zu this, um Methodenverkettung zu erlauben

REMOVE_ITEM

Eine Option aus der Combo-Box entfernen.

ÜbergabeparameterTypStandardwertBeschreibung
IV_KEYStringKey der zu löschenden Option
RückgabeparameterTypBeschreibung
RO_CONTROLCombo BoxReferenz zu this, um Methodenverkettung zu erlauben

SET_SELECTED_KEY

Setzen der auszuwählenden Option. Mögliche Optionen müssen vorher zur Combo-Box hinzugefügt werden.

ÜbergabeparameterTypStandardwertBeschreibung
IV_VALUEStringAuszuwählende Option
RückgabeparameterTypBeschreibung
RO_CONTROLCombo BoxReferenz zu this, um Methodenverkettung zu erlauben
Combo Box Item
Control