TriStateCheckBox-Eigenschaften
-
activateAccessKey
Aktivierung von Zugangstasten.
Diese Eigenschaft ist sowohl von einem Administrator als auch von einem Anwender personalisierbar.
-
checked
Beschreibung, ob das Oberflächenelement angewählt ist.
HinweisVerwenden Sie als Context-Attribut-Typ den Typ WDUI_TRI_STATE.
Es ist eine Vorbelegung mit Werten möglich, siehe auch Allgemeines zu Methoden und Eigenschaften der UI-Elemente.
Wert
Beispiel für die visuelle Darstellung
Beschreibung
Über Personalisierung setzbar
false
Option ist nicht ausgewählt, und die Grafik wird auf der Benutzungsoberfläche ohne Häkchen dargestellt
ja
true
Option ist ausgewählt, und die Grafik wird auf der Benutzungsoberfläche mit einem Häkchen dargestellt
ja
undecided
Option ist mit einem Sternchen versehen, um darzustellen, dass man sich nicht entscheiden kann, ob man sie auswählt oder nicht
ja
HinweisDie Option undecided kann auch als Status in einem Baum verwendet werden, wenn die untergeordneten Elemente sowohl true als auch false als Werte besitzen:
-
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. Siehe auch 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 TriStateCheckBox 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.
Wert
Beispiel für die visuelle Darstellung
Beschreibung
normal
Normalzustand des Oberflächenelements
required
Das Eingeben eines Wertes ist erforderlich
-
text
Beschriftungstext, der als erläuternder Text innerhalb der TriStateCheckBox 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.
-
textDirection
Text- oder Schreibrichtung.
Damit wird für das Oberflächenelement das Lesen von Beschriftungen in anderen Sprachen ermöglicht, die eine bestimmte Textrichtung bedingen, z.B. Hebräisch und Arabisch als RTL-Sprachen im Gegensatz zu Englisch als LTR-Sprache.
Diese Eigenschaft ist von einem Administrator personalisierbar.
Wert
Beschreibung
Über Personalisierung setzbar
INHERIT
Die Textrichtung wird vom Eltern-Element geerbt und besitzt damit die gleiche Textrichtung wie das Eltern-Element
ja
LTR
Left-to-Right, d.h. die Textrichtung ist von links nach rechts
ja
RTL
Right-to-Left, d.h. die Textrichtung ist von rechts nach links
ja
-
undecidedStateSelectable
Diese Eigenschaft ermöglicht es, zu bestimmen, auf welche Art und Weise die Option undecided des Attributes checked ausgewählt werden kann.
Wert
Beschreibung
true
Ausgangswert
Die Option undecided kann durch Contextbinding oder dynamisch gesetzt oder manuell ausgewählt werden.
false
Diese Option kann nur durch Contextbinding oder dynamisch gesetzt werden.
Das manuelle Auswählen der Option undecided ist nicht möglich.