Erscheinungsbild
Control
Die Klasse Control ist die Basis aller anderen Komponenten-Klassen. Sie enthält die grundlegenden Methoden zum Lesen und Setzen von Attributen, Sichtbarkeit und ID. Jede Komponenten-Klasse erbt diese Methoden – Sie finden sie deshalb in den einzelnen Komponenten-Seiten nicht wiederholt.
Methoden-Übersicht
| Methode | Zweck |
|---|---|
GET_CONTROL_ID | Liefert die controlId der Komponente |
GET_CONTROL_TYPE | Liefert den Typ-Schlüssel der Komponente |
GET_CONTROL_DATA | Vollständige Datenstruktur der Komponente |
GET_PROPERTIES | Alle Attribute als Key-Value-Tabelle |
GET_PROPERTY_VALUE | Attributwert über Schlüssel als String |
GET_PROPERTY_VALUE_AS_BOOLE | Attributwert als Boolean |
GET_PROPERTY_VALUE_AS_FLOAT | Attributwert als Float |
GET_PROPERTY_VALUE_AS_INT | Attributwert als Integer |
GET_VISIBLE | Sichtbarkeitsstatus |
GET_FUNCTION_PROPERTY / SET_FUNCTION_PROPERTY | Attribut einer Logic-Flow-Funktion der Komponente lesen / schreiben |
GET_VARIABLE / SET_VARIABLE | Attribut einer Logic-Flow-Variablen der Komponente lesen / schreiben |
INIT | Komponente zurücksetzen (Basisklasse ohne Wirkung, wird je Komponente redefiniert) |
SET_CONTROL_ID | Setzt die controlId |
SET_PROPERTY_VALUE | Attributwert über Schlüssel als String |
SET_PROPERTY_VALUE_AS_BOOLE | Attributwert als Boolean |
SET_PROPERTY_VALUE_AS_FLOAT | Attributwert als Float |
SET_PROPERTY_VALUE_AS_INT | Attributwert als Integer |
SET_VISIBLE | Sichtbarkeit aktivieren / deaktivieren |
Vererbt an
Alle UI-Komponenten – siehe Übersicht.
Methoden-Details
GET_CONTROL_ID
Liefert die controlId der Komponente.
| Rückgabe | Typ | Beschreibung |
|---|---|---|
RV_CONTROL_ID | String | Gesetzte ID der Komponente |
GET_CONTROL_TYPE
Liefert den Typ-Schlüssel.
| Rückgabe | Typ | Beschreibung |
|---|---|---|
RV_CONTROL_TYPE | String | Typ der Komponente (z.B. Button, Input) |
GET_CONTROL_DATA
Liefert die vollständige Datenstruktur der Komponente – controlId, Attribute, Kind-Komponenten, Logic-Flow-Funktionen und -Variablen.
| Rückgabe | Typ | Beschreibung |
|---|---|---|
RS_CONTROL | /mobbuild/cl_types=>ty_control | Datenstruktur der Komponente |
GET_PROPERTIES
Liest alle Attribute als Tabelle aus.
| Rückgabe | Typ | Beschreibung |
|---|---|---|
RT_PROPERTIES | /mobbuild/cl_types=>tt_key_value | Alle Attribute der Komponente (Schlüssel/Wert) |
GET_PROPERTY_VALUE
Liest ein Attribut als String.
| Übergabe | Typ | Beschreibung |
|---|---|---|
IV_KEY | String | Attributname |
| Rückgabe | Typ | Beschreibung |
|---|---|---|
RV_VALUE | String | Attributwert |
GET_PROPERTY_VALUE_AS_BOOLE / _AS_FLOAT / _AS_INT
Wie GET_PROPERTY_VALUE, gibt aber den Wert typkonvertiert zurück (BOOLE_D, Float, Integer).
GET_VISIBLE
Liefert abap_true, wenn die Komponente sichtbar ist.
GET_FUNCTION_PROPERTY / SET_FUNCTION_PROPERTY
Lesen bzw. schreiben ein Attribut einer Logic-Flow-Funktion, die an dieser Komponente hängt. Die Funktion wird über ihre functionId adressiert (Attribut der Funktion im Designer), das Attribut über seinen Schlüssel (z.B. value). Gibt es Funktion oder Schlüssel nicht, liefert GET_FUNCTION_PROPERTY einen leeren String und SET_FUNCTION_PROPERTY bleibt ohne Wirkung.
| Übergabe | Typ | Beschreibung |
|---|---|---|
IV_FUNCTION_ID | String | functionId der Logic-Flow-Funktion |
IV_KEY | String | Attributname der Funktion |
IV_VALUE | String | Neuer Wert (nur SET_FUNCTION_PROPERTY) |
| Rückgabe | Typ | Beschreibung |
|---|---|---|
RV_VALUE | String | Attributwert (nur GET_FUNCTION_PROPERTY) |
GET_VARIABLE / SET_VARIABLE
Lesen bzw. schreiben ein Attribut einer Logic-Flow-Variablen dieser Komponente. Die Variable wird über ihren name adressiert, das Attribut über seinen Schlüssel – der Wert der Variablen steht unter value. Gibt es Variable oder Schlüssel nicht, liefert GET_VARIABLE einen leeren String und SET_VARIABLE bleibt ohne Wirkung. Damit lassen sich Logic-Flow-Variablen aus ABAP vorbelegen oder auslesen – siehe Logic Flow.
| Übergabe | Typ | Beschreibung |
|---|---|---|
IV_NAME | String | name der Variablen |
IV_KEY | String | Attributname, für den Wert value |
IV_VALUE | String | Neuer Wert (nur SET_VARIABLE) |
| Rückgabe | Typ | Beschreibung |
|---|---|---|
RV_VALUE | String | Attributwert (nur GET_VARIABLE) |
INIT
Setzt die Komponente zurück. In der Basisklasse ist die Methode ohne Wirkung; die Komponenten-Klassen redefinieren sie (Eingabefelder leeren z.B. Wert, valueState und valueStateText). me->init_controls( ) der View-Klasse ruft init( ) für jede Komponente der View auf – welche Komponenten dabei nichts tun, steht in der Einführung.
SET_CONTROL_ID
Setzt die controlId (Schlüssel der Komponente und Attribut controlId). Der Rückgabeparameter RO_CONTROL bleibt initial – rufen Sie die Methode daher nicht in einer Kette auf.
| Übergabe | Typ | Beschreibung |
|---|---|---|
IV_CONTROL_ID | String | Neue ID |
SET_PROPERTY_VALUE
Setzt ein Attribut als String.
| Übergabe | Typ | Beschreibung |
|---|---|---|
IV_KEY | String | Attributname |
IV_VALUE | String | Neuer Wert |
SET_PROPERTY_VALUE_AS_BOOLE / _AS_FLOAT / _AS_INT
Wie SET_PROPERTY_VALUE, akzeptiert aber typsicher Boolean / Float / Integer.
SET_VISIBLE
Komponente ein- oder ausblenden.
| Übergabe | Typ | Beschreibung |
|---|---|---|
IV_VALUE | BOOLE_D | abap_true = sichtbar, abap_false = ausgeblendet |
| Rückgabe | Typ | Beschreibung |
|---|---|---|
RO_CONTROL | /mobbuild/cl_control | me-Referenz für Methodenverkettung |
Nächste Schritte
- Komponenten-Übersicht
- Button – erste konkrete Komponente