Label

Verwendung

Das Label-Oberflächenelement dient der Beschriftung anderer Oberflächenelemente und ist daher immer mit einem anderen Oberflächenelement verknüpft. Sie können ein Label für die folgenden UI-Elemente verwenden:

BreadCrumb
Caption
CheckBox und CheckBoxGroup
DropDownByKey und DropDownByIndex
FileDownload und FileUpload
FormattedTextEdit und FormattedTextView
Image
InputField
ItemListBox
LinkToAction und LinkToUrl
ProgressIndicator
RadioButton, RadioButtonGroupByIndex und RadioButtonGroupByKey
Table
TextEdit und TextView
ThresholdSlider
TransparentContainer
TriStateCheckBox

Das Aussehen eines Label wird durch die Eigenschaft design definiert.

Besitzt das zugeordnete Oberflächenelement den Status einer Muss-Angabe (state=required), dann wird dies durch einen kleinen roten Stern rechts vom Label-Text angezeigt.

Bei einem inaktiven Oberflächenelement (enabled=false) wird auch das Label als inaktiv angezeigt.

Besitzt das zugeordnete Oberflächenelement einen erläuternden Text (explanation) und der Hilfe-Modus ist aktiviert, so wird dies durch ein kleines i rechts vom Label-Text angezeigt. Beim Bewegen der Maus über das Label wird zusätzlich der Text angezeigt.

Durch Klicken auf das Label wird das zugeordnete Oberflächenelement aktiviert (DropDown*-UI-Elemente und InputFields werden fokussiert, CheckBoxes umgeschaltet und RadioButtons angewählt).

Für ein Label in einem FormLayout werden, abhängig von der Größe des Browser-Fensters und des eingesetzten Browsers, die Funktionen des Abschneidens von Inhalten angeboten.

Mit diesem Oberflächenelement wird die Barrierefreiheit der Web-Dynpro-Anwendung unterstützt.

Hinweis

Um die Entwicklung barrierefreier Anwendungen zu ermöglichen, wird im Rahmen des Syntaxchecks die Eigenschaft tooltip nicht überprüft.

Beispiel für die visuelle Darstellung mit einem InputField

Laufzeit-Klasse

CL_WD_LABEL

Eigenschaften im View Designer

Name	Typ	Anfangswert	Bindbar
id	STRING	(automatisch)	nein
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	nein
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		nein
design	WDUI_LABEL_DESIGN	standard	ja
editable	WDY_BOOLEAN	false	ja
enabled	WDY_BOOLEAN	true	ja
labelFor	WDY_MD_UI_ELEMENT_REFERENCE		nein
styleClassName	STRING		ja
text	Übersetzbarer Text		ja
textDirection	WDUI_TEXT_DIRECTION	inherit	ja
tooltip	Übersetzbarer Text		ja
visible	WDUI_VISIBILITY	visible	ja
width	STRING		ja
wrapping	WDY_BOOLEAN	false	ja

Events im View Designer

Name
onChange

Hinweis

Weitere Eigenschaften, die über Vererbung zur Verfügung stehen, sind in den dazugehörigen übergeordneten Klassen definiert. Die dazugehörigen Oberflächenelemente sind:

Dynamische Programmierung

Für die dynamische Programmierung stehen dieselben Eigenschaften, Ereignisse und Aggregationen zur Verfügung wie im View Designer. Beachten Sie dabei die unterschiedlichen Schreibweisen

Dynamische Programmierung der Eigenschaften

View Designer Name	Laufzeitname	Typ
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_LABEL=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_LABEL=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_LABEL=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
design	DESIGN	WDUI_LABEL_DESIGN
design: emphasized	CL_WD_LABEL=>E_DESIGN-EMPHASIZED
design: light	CL_WD_LABEL=>E_DESIGN-LIGHT
design: standard	CL_WD_LABEL=>E_DESIGN-STANDARD
enabled	ENABLED	WDY_BOOLEAN
labelFor	LABEL_FOR	WDY_MD_UI_ELEMENT_REFERENCE
styleClassName	STYLE_CLASS_NAME	STRING
text	TEXT	WDY_MD_TRANSLATABLE_TEXT
textDirection	TEXT_DIRECTION	WDUI_TEXT_DIRECTION
textDirection: inherit	CL_WD_LABEL=>E_TEXT_DIRECTION-INHERIT
textDirection: ltr	CL_WD_LABEL=>E_TEXT_DIRECTION-LTR
textDirection: rtl	CL_WD_LABEL=>E_TEXT_DIRECTION-RTL
tooltip	TOOLTIP	WDY_MD_TRANSLATABLE_TEXT
visible	VISIBLE	WDUI_VISIBILITY
visible: none	CL_WD_LABEL=>E_VISIBLE-NONE
visible: visible	CL_WD_LABEL=>E_VISIBLE-VISIBLE
width	WIDTH	STRING
wrapping	WRAPPING	WDY_BOOLEAN

Beispiel

Beispiele für dieses Oberflächenelement finden Sie im System in der Web-Dynpro-Applikation WDR_TEST_UI_ELEMENTS sowie in der Component WDR_TEST_EVENTS in der View InputField.