CheckBox-Eigenschaften
-
displayOnly
Festlegung, ob der Benutzer das UI-Element editieren kann oder ob es lediglich angezeigt werden soll.
Diese Eigenschaft hat fast dieselbe Funktionalität wie readOnly. Die Unterschiede sind, dass der Hintergrund der UI-Elemente weiß anstelle von grau ist und dass ein eventueller required Stern nach Aktivierung am Label nicht mehr angezeigt wird.
Die folgende Grafik zeigt diesen Unterschied am Beispiel des UI-Elements RadioButton:
Diese Eigenschaft ist von einem Administrator personalisierbar. Über die Personalisierung kann dieser Eigenschaft der folgende Wert zugeordnet werden: true
Wenn Sie displayOnly mit folgenden UI-Elementen verwenden, dann werden nicht mehr alle Eigenschaften unterstützt.
Im folgenden werden die unterstützten Eigenschaften aufgelistet:
-
displayOnly für das UI-Element InputField:
Verwenden Sie displayOnly für das UI-Element InputField, so werden nur noch folgende Eigenschaften unterstützt:
-
displayOnly für das UI-Element DropDownByKey oder DropDownByIndex:
Verwenden Sie displayOnly für das UI-Element DropDownByKey oder DropDownByIndex, so werden nur noch folgende Eigenschaften unterstützt:
-
Sind sowohl displayOnly = true und readOnly = true, dann wird das UI-Element im displayOnly- Stil angezeigt.
-
Bei den UI-Elementen InputField, DropDownByKey, DropDownByIndex und DropDownListBox wird wenn displayOnly = true ist ein TextView gerendert.
-
Die Eigenschaft displayOnly funktioniert nicht in ToolBar-Elementen.
-
Wenn für die UI-Elemente DropDownByIndex, DropDownByKey, DropDownListBox und InputField displayOnly = true gesetzt ist, kann es vorkommen, dass mehrere benachbarte Leerzeichen zu einem einzigen Leerzeichen komprimiert werden, wenn Sie die Anwendung im Internet Explorer ausführen. Das Problem tritt im Quirks-Modus bei allen IE-Versionen und im Standard-Modus bei IE8 und kleiner auf.
-
explanation
Hilfetext, der bei eingeschaltetem Hilfe-Modus ausgegeben wird.
Weitere Informationen: Hilfetexte in und für Web-Dynpro-Applikationen
Diese Eigenschaft ist von einem Administrator personalisierbar.
Die Eigenschaft explanation wird nur dann angezeigt, wenn es ein Label zu dem jeweiligen UI-Element gibt.
Beachten Sie hierbei die folgende Ausnahme:
Die Eigenschaft explanation einer AbstractTableColumn wird immer angezeigt. Verwenden Sie eine AbstractTableColumn.explanation als Ersatz für eine explanation am jeweiligen UI-Element (z.B. InputField), wenn das UI-Element in einer Table vorkommt und daher keinen Label besitzt.
-
readOnly
Festlegung, ob der Benutzer die CheckBox markieren kann oder ob sie nur zum Lesen angezeigt werden soll.
Diese Eigenschaft ist von einem Administrator personalisierbar. Über die Personalisierung kann dieser Eigenschaft der folgende Wert zugeordnet werden: true
-
state
Fehlerstatus des Oberflächenelements. Beachten Sie dabei auch den Hinweis zu dem required-Stern bei einem Label im FormLayout unter Abschneiden von Inhalten im FormLayout.
Diese Eigenschaft ist von einem Administrator personalisierbar.
Wert
Beispiel für die visuelle Darstellung
Beschreibung
Über Personalisierung setzbar
normal
Normalzustand des Oberflächenelements
nein
required
Das Eingeben eines Wertes ist erforderlich. Für die Visualisierung wird die CheckBox mit einem Stern dargestellt.
HinweisBeachten Sie, dass diese Ausprägung der Eigenschaft state nicht vom Web-Dynpro-Framework abgeprüft wird. Für das Prüfen von Pflichteingaben stehen jedoch Servicefunktionen zur Verfügung, siehe auch SAP Hinweis 948753
.ja
-
text
Beschriftungstext, der als erläuternder Text innerhalb der CheckBox ausgegeben wird.
Diese Eigenschaft ist von einem Administrator personalisierbar.
-
textDesign
Diese Eigenschaft bestimmt das Aussehen des Textes eines UI-Elements.
Wert
Beschreibung
standard
Defaultwert
emphasized
Der Text wird hervorgehoben.
Die folgende Grafik zeigt den Text eines Radiobuttons, wenn der Wert emphasized ist, d.h. der Text hervorgehoben werden soll:
Für die UI-Elemente RadioButton, CheckBox und TriStateCheckBox wird textDesign für den jeweiligen Text des entsprechenden UI-Elements gesetzt.
Für die UI-Elemente RadioButtonGroupByIndex, RadioButtonGroupByKey und CheckBoxGroup wird textDesign für den Text aller in der Gruppe beinhalteten RadioButtons und Checkboxen gesetzt. Das heißt, dass der Wert von textDesign an diese Elemente weitervererbt wird. Es ist nicht möglich, unterschiedliche Werte von verschiedenen Radiobuttons oder Checkboxen einer Gruppe zu setzen.
-
textWrapping
Wert
Beschreibung
false
Defaultwert
true
Der Text wird umgebrochen (siehe Grafik)
Die folgende Grafik zeigt den Text einer CheckBox, wenn der Wert true ist, d.h. der Text umgebrochen werden soll:
Für die UI-Elemente RadioButton, CheckBox und TriStateCheckBox wird textWrapping für den jeweiligen Text des entsprechenden UI-Elements gesetzt.
Für die UI-Elemente RadioButtonGroupByIndex, RadioButtonGroupByKey und CheckBoxGroup wird textWrapping für den Text aller in der Gruppe beinhalteten RadioButtons und Checkboxen gesetzt. Das heißt, dass der Wert von textWrapping an diese Elemente weitervererbt wird. Es ist nicht möglich, unterschiedliche Werte von verschiedenen Radiobuttons oder Checkboxen einer Gruppe zu setzen.