Methoden und Eigenschaften der
UI-Elemente
Methoden zum Umgang mit Eigenschaften
Zu einer Eigenschaft eines Oberflächenelements gibt es jeweils eine Get- und eine Set-Methode:
Setter- und Gettermethoden
● Die Set-Methoden setzen den Wert einer Eigenschaft oder ein Element. Wenn eine Eigenschaft readOnly ist, wird diese Methode nicht implementiert.
Der Name der Methode wird nach
folgendem Schema gebildet:
SET_<Laufzeitname der Eigenschaft>
Beispiel: Table, Eigenschaft: design, Methode: SET_DESIGN.
● Die Get-Methoden liefern den Wert einer Eigenschaft oder ein Element.
Der Name der Methode wird nach
folgendem Schema gebildet:
GET_<Laufzeitname der Eigenschaft>
Beispiel: Table, Eigenschaft: design, Methode: GET_DESIGN
Methoden zur Datenbindung
Wenn eine Eigenschaft an den Context gebunden werden kann oder muss, gibt es die dazugehörigen Bind- und Bound-Methoden.
● Die Bind-Methoden binden den Wert einer Eigenschaft an das durch den Pfad spezifizierte Context-Element.
Der Name der Methode wird nach
folgendem Schema gebildet:
BIND_<Laufzeitname der Eigenschaft>
Beispiel: Table, Eigenschaft: design, Methode: BIND_DESIGN.
● Die Bound-Methoden liefern den Pfad des Context-Elements, an das eine Eigenschaft gebunden ist und liefern NULL, wenn keine Bindung existiert.
Der Name der Methode wird nach
folgendem Schema gebildet:
BOUND_<Laufzeitname der Eigenschaft>
Beispiel: Table, Eigenschaft: design, Methode: BOUND_DESIGN.
Siehe auch:
Methoden zum Umgang mit Events
●
Die Get-Methoden liefern den Wert eines
Events. Der Name der Methode wird nach folgendem Schema gebildet:
GET_<Laufzeitname der Eigenschaft>
Beispiel: Table, Event: onFilter, Methode: GET_ON_FILTER.
●
Die Set-Methoden setzen den Wert eines
Events. Der Name der Methode wird nach folgendem Schema gebildet:
SET_<Laufzeitname der Eigenschaft>
Beispiel: Table, Event: onFilter, Methode: SET_ON_FILTER.
●
Die Map-Methoden liefern das
Parameter-Mapping zu einem Event. Der Name der Methode wird nach folgendem
Schema gebildet:
MAP_<Laufzeitname des Ereignisses>
Beispiel: Table, Event: onFilter, Methode: MAP_ON_FILTER.
Methoden zum Umgang mit Aggregationen
Wenn ein Oberflächenelement über Aggregationen andere Elemente enthalten kann, stehen folgende Methoden zur Verfügung:
● Zwei Add-Methoden, die ein Element hinzufügen.
○ Wird nur das Element als Parameter übergeben, wird das Element am Ende einer Liste hinzugefügt
○ Wird ein Index mit übergeben, wird dieses Element an der angegeben Indexposition übergeben.
Der Name beider Methoden wird nach
folgendem Schema gebildet:
ADD_<Laufzeitname des Elements>
Beispiel: Table, Element: Tabellenspalte, Methode: ADD_COLUMN.
●
Die Get-Methoden dienen zur Feststellung
der Zuordnung zu den übergeordneten oder untergeordneten Elementen. Der Name
der Methode wird nach folgendem Schema gebildet:
GET_<Laufzeitname der Elemente>
Beispiel: Table, Element: Tabellenspalte, Methode: GET_COLUMN.
●
Die Has-Methoden testen, ob aggregierte
Elemente innerhalb dieses Elements existieren. Der Name der Methode wird nach
folgendem Schema gebildet:
HAS_<Laufzeitname der Elemente>
Beispiel: Table, Element: Tabellenspalte, Methode: HAS_COLUMNS.
● Die Remove-Methoden entfernen die jeweiligen aggregierten Elemente. Diese bleiben erhalten und können wieder dem aktuellen Element wieder hinzugefügt werden.
Sie können einzelne oder alle Elemente entfernen:
○
Bei einzelnen Elementen können Sie
entweder den Index oder die ID mit übergeben, die Methode wird nach folgendem
Schema gebildet:
REMOVE_<Laufzeitname des Elements>.
Beispiel: Table, Element: Tabellenspalte, Methode: REMOVE_COLUMN.
○
Wollen Sie alle Elemente entfernen,
benutzen Sie eine Methode, die nach folgendem Schema gebildet wird:
REMOVE_ALL_<Laufzeitname der Elements>
Beispiel: Table, Element: Tabellenspalte, Methode: REMOVE_ALL_COLUMNS
Standard-Parameter
● ID
ID des auslösenden UI-Elements (d.h. das Element, zu dem der Event gehört)
● CONTEXT_ELEMENT
CONTEXT_ELEMENT ist vom Typ IF_WD_CONTEXT_ELEMENT, welcher direkt den Pointer zu dem betroffenen Context-Element enthält. Dabei handelt es sich um das Context-Element der dataSource einer Table oder MultiPane, für das das Ereignis ausgelöst wurde:
○ Wenn sich das Element in einer Table befindet, dann ist das Context-Element das Element von der Zeile, in der die Aktion ausgelöst wurde (vertikale Koordinate).
○ Wenn sich das Element in einer MultiPane befindet, dann ist das Context-Element das Element von der Pane (d.h. Zelle), in der die Aktion ausgelöst wurde (vertikale Koordinate).
○ Befindet sich das Element weder in einer Table noch in einer MultiPane, dann ist es initial.
UI-Element-Eigenschaften und deren Bindung
Die boolschen Werte von Web Dynpro ABAP sind in der Domäne WDY_BOOLEAN zu finden. Diese Domäne dient als Ersatz für echte boolsche Typen. Dabei steht X für wahr und keine Angabe für falsch.
Formulare
Als Überschrift für Formulare können Sie ein TextView mit design=GroupTitle verwenden. Dazu setzen Sie den umliegenden TransparentContainer auf isLayout = false und vergeben Sie für dessen AccessibilityDescription den gleichen Text wie für den groupTitle. Hintergrund hierzu ist, dass ein TextView mit design=GroupTitle nicht vom Bildschirmausleseprogrammen vorgelesen wird.
Beachten Sie daher:
●
UI-Element TextView
Einsatz für den sehenden Benutzer
●
Eigenschaft AccessibilityDescription
Einsatz für Bildschirmausleseprogramme
Primäre Eigenschaft
Siehe Primäre Eigenschaft
Vom Client änderbare Eigenschaften, die nicht gebunden sein müssen
Siehe Eigenschaften bei der Verwendung in MultiPane oder TablePopin
Vorbelegung von Werten bestimmter UI-Elemente im Rahmen der Personalisierung
Es ist sowohl für Endbenutzer als auch für Administratoren möglich, im Rahmen der Personalisierung Werte für bestimmte UI-Elemente vor zu belegen. Da heißt für ein InputField beispielsweise, dass der Endbenutzer oder der Administrator irgend einen Wert hineinschreibt, dann das Kontextmenü aufruft und dort den Menüpunkt Aktuellen Wert als Standardwert nutzen auswählt. Beim nächsten Start geht das System so vor, als ob der Benutzer diesen Wert bereits eingetippt hätte.
Das Vorbelegen steht nur dann zur Verfügung, wenn das jeweilige Feld tatsächlich eingabebereit ist.
Diese Funktionalität steht für die folgenden UI-Elemente und ihre Eigenschaften zur Verfügung:
Vorbelegung
UI-Element |
Eigenschaft |
value |
|
value |
|
checked |
|
checked |
|
checked |
|
checked |
|
value |
|
checked |
Daten-Ausschnitte im Context
Siehe Daten-Ausschnitte im Context
Numerische Angaben für CSS-Größen
Für die häufig verwendeten Properties width und height können die Angaben in CSS-Größen wie em, ex, Pixel oder Prozentwerte gemacht werden. Dabei können Sie zwischen absoluten Angaben (z.B. Millimeter) und relativen Angaben (z.B. Prozent gegenüber "normal") wählen. Die folgenden Kürzel stehen zur Verfügung:
Kürzel für CSS-Größen
Kürzel |
Beschreibung |
em |
Bezug auf die Schriftgröße. |
ex |
Bezug auf die Höhe des Kleinbuchstaben x in diesem Element. |
px |
Pixel-Angabe. Diese Angabe hängt von der Pixeldichte des Ausgabegerätes ab. |
% |
Prozent-Angabe. Abhängig von der CSS-Eigenschaft kann dies relativ zu Folgendem sein: ● Zur Element-eigenen Größe ● Zur Größe des Eltern-Elements ● Zur einem allgemeineren Kontext |
Weitere Informationen über numerische Angabe bei CSS-Größen finden Sie im Internet, z.B. bei http://de.selfhtml.org/.
Empfehlungen für absolute und relative Werte für Größen (height, width)
● %
Verwenden Sie Prozent-Angaben umsichtig. Prozent-Werte funktionieren normalerweise nicht für Höhenangaben. Sie können sie jedoch für Breitenangaben von Layoutdaten verwenden, z.B. MatrixData, um Ihrem Bildschirmbild eine horizontale Struktur zu geben oder die zur Verfügung stehende Breite auszunutzen.
Alle Prozent-Angaben beziehen sich auf die width/height des umgebenden Containers bzw. der Layout-Daten.
● *
Standardeinstellung: Belegt so viel Platz wie nötig.
● px (Pixel)
Beachten Sie, dass es in diesem Zusammenhang zu Problemen kommen kann, wenn der Benutzer die Schriftgröße ändert.
● ex (Höhe des Zeichens x)
Angabe, die relativ zur Schriftgröße ist. Wir empfehlen diese Einheit. Sie können sie für die width von beispielsweise einer TableColumn verwenden.
Empfehlungen für Tables:
● Legen Sie für die Table eine width fest, z.B. 40ex oder 100%
● Verwenden Sie tableLayoutFixed, um zu vermeiden, dass die Table abhängig vom Inhalt breiter oder schmaler wird
● Wenn die width bekannt ist oder langer Text abgeschnitten werden soll, verwenden Sie ex-Angaben für TextViews, DropDown-Listen und InputFields
● Verwenden Sie * (oder keine Angabe) für Spalten, die langen Text enthalten, so dass sie mit der Table skalieren, wenn diese beispielsweise 100% ist. Wenn Sie die width der Table festlegen, ordnen Sie mindestens einer Spalte den Stern zu.
Beachten Sie bei ScrollContainer/TransparentContainer
mit scrollingMode ungleich none:
Prozent-Angaben funktionieren nicht korrekt. Verwenden Sie daher Angaben wie
ex oder px.
Deprecated Objekte
Einige Funktionen, UI-Elemente, Properties, Events, etc werden in der Dokumentation und im System als deprecated bezeichnet. Dies bedeutet:
● Die jeweilige Funktion existiert nach wie vor, soll aber nicht mehr genutzt werden
● Deprecated Eigenschaften werden ab NW 7.10 und NW 7.11 vom View Designer angemahnt
● Im allgemeinen existiert ein gleichwertiger Ersatz für die Funktionalität. Weitere Informationen finden Sie im Langtext der Warnung im View Designer (ab NW 7.10 und NW 7.11)
Wir behalten uns vor, die jeweilige deprecated Funktionalität zu einem späteren Release zu entfernen.
Siehe auch: