Event-Methoden

Events sind der Mechanismus, mit dem das Frontend des Designers auf Benutzeraktionen reagiert. Im Mobile Builder verknüpfen Sie eine Komponente mit einer Methode der gebundenen ABAP-Klasse, die beim Auslösen des Events aufgerufen wird.

Voraussetzungen

Voraussetzung	Hinweis
Die View ist an eine ABAP-Klasse gebunden	Siehe View an Klasse binden
Die Methode existiert in der gebundenen Klasse	Sonst wird der Event zur Laufzeit ignoriert / Fehler geworfen
Die Methode hat eine Mobile-Builder-konforme Signatur	Pflicht-Importing-Parameter für den Designer-Kontext

Event in der Komponente eintragen

Selektieren Sie eine Komponente und wechseln Sie im Eigenschaften-Panel auf den Reiter Events. Sie sehen pro unterstütztem Event-Typ ein Eingabefeld – tragen Sie dort den Methodennamen ein.

Beispiel: Bei einem Button-Control geben Sie unter onPress den Namen on_login_press ein. Beim Klick auf den Button wird zur Laufzeit die Methode on_login_press der gebundenen Klasse aufgerufen.

Verfügbare Event-Arten

Welche Events eine Komponente unterstützt, hängt vom Typ ab:

Event	Komponenten	Auslöser
onPress	Button, Link, GenericTag, Tile	Klick / Tap
onSelect	CheckBox, RadioButton, IconTabBar	Auswahl
onChange	Input, TextArea, ComboBox, Switch, StepInput, TimePicker	Wert geändert
onSubmit	Input, TextArea	Drücken der Entertaste
onSelectionChange	List, Table, ComboBox, RadioButtonGroup, SegmentedButton	Auswahländerung
onScanSuccess	BarcodeScannerButton	Barcode erkannt
onScanFail	BarcodeScannerButton	Scan abgebrochen
onClose	MessageStrip	Schließen-Klick
onSave	SignaturePad	Signatur gespeichert
onNavButtonPress	View (Header)	Klick auf Zurück-Button

Methoden-Signatur

Jede Event-Methode wird mit einem Standard-Parameter-Set aufgerufen. Beim Generieren einer neuen Klasse legt der Mobile Builder die korrekte Signatur automatisch an. Bei manueller Implementierung halten Sie sich an folgendes Schema:

Parameter	Typ	Bedeutung
iv_view_id	String	Die controlId der View, in der das Event ausgelöst wurde
iv_control_id	String	Die controlId der auslösenden Komponente
iv_event_type	String	Event-Name (z.B. onPress)
it_event_data	Tabelle	Event-spezifische Zusatzdaten (z.B. der gescannte Barcode bei onScanSuccess)

Die exakte Signatur entnehmen Sie dem von Generieren angelegten Methoden-Stub.

Aktionen in der Event-Methode

Innerhalb der Event-Methode greifen Sie über die Mobile-Builder-API auf Frontend-Komponenten zu, lesen und setzen Werte, navigieren zwischen Views, zeigen Meldungen und rufen Backend-Logik auf.

Typische Muster:

Anwendungsfall	Aktion
Aktuellen Wert eines Eingabefelds lesen	get_property für value
Ergebnis im Detail-Feld anzeigen	set_property für text
Liste neu laden	Daten ermitteln, anschließend set_items auf der Liste
Meldung an den Benutzer	show_message (Toast oder Strip)
Navigation in eine andere View	navigate_to_view mit Ziel-controlId
Vor Eingabe-Speicherung validieren	Eingabe lesen, prüfen, ggf. set_value_state auf Error

Mehrere Events auf eine Methode

Sie können dieselbe Methode bei mehreren Komponenten eintragen, sofern die Logik identisch ist – das spart Redundanz. Über iv_control_id und iv_event_type unterscheiden Sie zur Laufzeit, woher der Aufruf kam.

Fehlerbild: Methode nicht gefunden

Wenn die hinterlegte Methode in der ABAP-Klasse nicht existiert, schlägt der Aufruf zur Laufzeit fehl. Im Lizenz-Monitor-Log und im Browser-Debug-Log erscheint ein entsprechender Hinweis. Lösung:

1. Prüfen Sie, ob die Methode in der korrekten Klasse implementiert ist
2. Prüfen Sie, ob der Methodenname exakt mit dem Eintrag im Designer übereinstimmt (Groß-/Kleinschreibung in ABAP irrelevant – Mobile Builder normalisiert intern)
3. Prüfen Sie, ob die Methode public sichtbar ist

Nächste Schritte

• Mobile-Builder-API – wie Sie Frontend-Komponenten ansprechen
• Konstanten-Klasse – controlId-Werte typsicher referenzieren
• Logic Flow – Alternative zur ABAP-Event-Methode für einfache Logik