TextView-Eigenschaften
Klappen Sie die Eigenschaften auf, um weitere Details anzuzeigen.
Die ID gibt eine eindeutige Identifikation.
Zuordnung der Kontextmenüs. Beachten Sie, dass in allen Fällen das Kontextmenü in der Hook-Methode WDDOONCONTEXTMENU überschrieben werden kann.
|
Wert |
Beschreibung |
|---|---|
|
inherit |
Das UI-Element erbt das statische Kontextmenü von seinen Eltern-UI-Elementen. |
|
provide |
Das Kontextmenü des UI-Elements ist dasjenige, dass durch contextMenuID spezifiert wurde. |
|
suppress |
Es wird kein statisches Kontextmenü erzeugt. |
ID für das Kontextmenü, das Sie definiert haben. Sie vergeben diese ID für ein UI-Element, wenn das Element selbst und alle darunter liegenden Elemente dieses Kontextmenü erhalten sollen. Wenn Sie beispielsweise bei einer Table eine solche contextMenuId hinterlegen, gilt das Kontextmenü für die komplette Table plus aller Kind-Elemente.
Mit dieser Eigenschaft können Sie eigene Style-Definitionen anlegen, um das Erscheinungsbild von UI-Elementen zu ändern (beispielsweise die Schriftfarbe eines Buttons).Mithilfe der Schnittstelle IF_WD_CUSTOM_STYLE_MANAGER (Methode CREATE_CUSTOM_STYLE) können Sie eigene Style-Klassen anlegen. Die verschiedenen Style-Definitionen zu einer Style-Klasse definieren Sie innerhalb von Objekten des Schnittstellentyps IF_WD_CUSTOM_STYLE in Form einer Name-/Wertliste. Diese Style-Definitionen können Sie dann bestimmten UI-Elementen zuweisen. Dazu muss der Wert des Parameters STYLE_CLASS_NAME der Methode CREATE_CUSTOM_STYLE identisch sein mit dem Wert der Eigenschaft styleClassName am UI-Element. Diese Eigenschaft ist von einem Administrator personalisierbar.
Dieses Feature ist nur im HTML Standards Mode verfügbar. Weitere
Informationen zum HTML Standards Mode finden Sie unter UI-Control-Rendering im Standards-Modus und im SAP Hinweis
1753544 
.
Beachten Sie, dass das Setzen eines Styles nicht immer sichtbar wird. Andere Eigenschaften können dominieren und diese überschreiben. Dies kann sich jetzt oder auch durch Veränderungen in der Zukunft auswirken.
data l_style_manager type ref to if_wd_custom_style_manager.
data l_style type ref to if_wd_custom_style.
" Get the custom style manager
l_style_manager =
wd_comp_controller->wd_get_api( )->get_application( )->get_custom_style_manager( ).
" Create a new custom style with name myButtonStyle for BUTTON elements
l_style =
l_style_manager->create_custom_style( style_class_name = `myButtonStyle`
element_type = 'BUTTON' ).
" Set font color to red
l_style->add_style_property( name = `fontColor`
value = `red` ).
" Add custom style
l_style_manager->add_custom_style( l_style ).
Um einem Button die so erzeugte Style-Definition zuzuweisen, setzen Sie an dem Button die Eigenschaft styleClassName auf den Wert myButtonStyle.
Eine Beispielanwendung finden Sie im System unter der Component WDR_TEST_CUSTOM_STYLES.
- IF_WD_CUSTOM_STYLE
- IF_WD_CUSTOM_STYLE_MANAGER
Text für die Quick-Info, der erscheint, wenn der Benutzer den Mauszeiger über das Oberflächenelement führt. Wenn Screen-Reader unterstützt werden, wird automatisch zusätzlicher Text zur Quick-Info hinzugefügt, um die Barrierefreiheit zu unterstützen. Beachten Sie Folgendes, wenn eine hotkey für eines der folgenden UI-Elemente gesetzt ist: AbstractButton und davon erbende UI-Elemente, IconButton, LinkToAction, LinkToUrl, MenuActionItem, ToolBarLinkToAction, ToolBarLinkToUrl: Die jeweilige Tastenkombination für die entsprechende Aktionstaste wird immer automatisch in den Tooltip des betreffenden UI-Elements hinzugefügt. Ist bereits ein Text für den Tooltip vorhanden, dann wird der Text für die Aktionstaste an das Ende angehängt. Diese Eigenschaft ist von einem Administrator personalisierbar. Siehe auch hotkey.
Breite des Oberflächenelements. Diese Eigenschaft ist von einem Administrator personalisierbar. Weitere Informationen: Allgemeines zu Methoden und Eigenschaften.
Aussehen des TextView-Oberflächenelements. Die von SAP ausgelieferten Portal-Themes beschreiben, wie die verschiedenen Möglichkeiten des design-Attributs angezeigt werden. Diese Eigenschaft ist von einem Administrator personalisierbar.
|
Wert |
Visuelle Darstellung |
Beschreibung |
|---|---|---|
|
emphasized |
|
Hervorgehobene Darstellung des Texts in Standardgröße |
|
groupTitle |
|
Überschrift für Formulare. Achtung
Dieser Enumerationswert ist deprecated. Verwenden Sie statt dessen einen SectionHeader. Wenn der Modus für die Barrierefreiheit eingeschaltet ist, wird bei TextView.design=groupTitle das TextView nicht in die Tab-Kette eingebunden und muss im umliegenden Container wiederholt werden. Dies hat den folgenden Hintergrund: Ein Scroll- oder TransparentContainer mit scrollingMode=none (TransparentContainer) wird dazu verwendet, um Formular-Elemente zu gruppieren. Der Titel soll von einem Bildschirmausleseprogramm dann vorgelesen werden, wenn der Benutzer in den Container navigiert. Daher sollte der Text der accessibilityDescription des Scroll- oder TransparentContainers hinzugefügt werden. Um zu verhindern, dass der Text zweimal vorgelesen wird, ist das TextView mit design=groupTitle nicht in der Tab-Kette enthalten. |
|
header1 |
|
Hervorgehobene Darstellung des Texts mit Schriftgröße +4 in Bezug zur Standardschriftgröße |
|
header2 |
|
Hervorgehobene Darstellung des Texts mit Schriftgröße +2 in Bezug zur Standardschriftgröße |
|
header3 |
|
Hervorgehobene Darstellung des Texts in Standardgröße |
|
header4 |
|
Hervorgehobene Darstellung des Texts mit Schriftgröße -1 (small) in Bezug zur Standardschriftgröße (so wie legend, jedoch hervorgehoben) |
|
label |
|
Darstellung des Texts in der Standardschriftart. Nach dem Text wird immer zusätzlich ein Leerzeichen hinzugefügt. |
|
label_small |
|
Darstellung des Texts in der Standardschriftart, wie label, nur mit Schriftgröße -1 (wie die Schriftgröße für header4) |
|
legend |
|
Darstellung des Texts in der Standardschriftart mit Schriftgröße -1 |
|
reference |
|
Darstellung des Texts kursiv und mit Standardschriftgröße |
|
standard |
|
Darstellung des Texts mit Standardschriftgröße. Es werden für diesen Wert keine Textattribute definiert |
|
monospace |
|
Darstellung des Texts in nicht-proportionaler Schriftart. Jeder Buchstabe nimmt dabei gleichviel Platz ein |
Horizontale Ausrichtung des Inhalts innerhalb des TextView-Oberflächenelements. Wir empfehlen, für die Positionierung des Textes den hAlign-Wert an dem LayoutData des UI-Elements und TableColumn.hAlign zu setzen und nicht TextView.hAlign zu verwenden. Wenn Sie doch TextView.hAlign verwenden, sollten Sie TextView.layout=block festlegen und eine passende width setzen. Diese Eigenschaft ist von einem Administrator personalisierbar.
|
Wert |
Beschreibung |
|---|---|
|
auto |
Automatische Ausrichtung des Textinhalts. Die Ausrichtung wird durch den Datentyp des darzustellenden Wertes bestimmt |
|
center |
Zentrierte Ausrichtung |
|
forcedLeft |
Der Textinhalt wird immer links dargestellt, unabhängig davon, ob für die Eigenschaft textDirection die Werte ltr oder rtl verwendet werden |
|
endOfLine |
Der Textinhalt wird immer am Ende der Zeile dargestellt. Für den Wert ltr der Eigenschaft textDirection wird somit der Textinhalt rechtsbündig dargestellt. Für den Wert rtl wird der Textinhalt linksbündig dargestellt |
|
forcedRight |
Der Textinhalt wird immer rechts dargestellt, unabhängig davon, ob für die Eigenschaft textDirection die Werte ltr oder rtl verwendet werden |
|
beginOfLine |
Der Textinhalt wird immer am Anfang der Zeile dargestellt. Für den Wert ltr der Eigenschaft textDirection wird somit der Textinhalt linksbündig dargestellt. Für den Wert rtl wird der Textinhalt rechtsbündig dargestellt |
Ausrichtung des Textes im TextView. Diese Eigenschaft ist von einem Administrator personalisierbar.
|
Wert |
Beschreibung |
Über Personalisierung setzbar |
|---|---|---|
|
block |
Stellt das TextView-Element in einem <div>-Tag dar. Siehe auch Eigenschaft hAlign. |
ja |
|
native |
Standard-Darstellung. Stellt das TextView-Element in einem <span>-Tag dar |
ja |
|
paragraph |
Stellt das TextView-Element in einem <p>-Tag dar. |
ja |
Das Setzen eines Wertes für diese Eigenschaft wirkt sich nur dann wie unten beschrieben aus, wenn dem TextView ein sichtbares Menü zugeordnet ist.
|
Wert |
Visuelle Darstellung |
Beschreibung |
|---|---|---|
|
iconPermanent |
|
Liefert ein Menü-Symbol hinter dem TextView. Durch Klicken des Symbols öffnet sich das Menü. |
|
triangleOnHover |
|
Standard-Darstellung Liefert ein kleines Dreieck hinter dem TextView, das dann erscheint, wenn Sie mit der Maus über das TextView fahren. Dabei ändert sich auch die Textfarbe. Durch Klicken des TextViews oder des Dreiecks öffnet sich das Menü. |
|
trianglePermanent |
|
Liefert ein kleines Dreieck hinter dem TextView, welches permanent sichtbar ist. Wenn Sie mit der Maus über das TextView fahren, ändert sich die Textfarbe und die Farbe des Dreiecks. Durch Klicken des TextViews oder des Dreiecks öffnet sich das Menü. |
Semantische Farbe. Beachten Sie in Hinblick auf die Barrierefreiheit, dass die Beschreibung der Farbe, "z.B. negativer Wert", automatisch in den Tooltip aufgenommen wird. Aus Barrierefreiheit-Sicht dürfen die Farben somit nur gemäß ihrer semantischen Bedeutung genutzt werden. Diese Eigenschaft ist von einem Administrator personalisierbar.
|
Wert |
Visuelle Darstellung |
Beschreibung |
|---|---|---|
|
standard |
|
Standard-Darstellung |
|
diminished |
|
Ausgegraute Darstellung |
|
positive |
|
Darstellung als positiv |
|
critical |
|
Darstellung als kritisch |
|
negative |
|
Darstellung als negativ |
|
marked1 |
|
Markierung erster Stufe |
|
marked2 |
|
Markierung zweiter Stufe |
Text der Beschriftung. Beachten Sie, dass jedes Vorkommen von cl_abap_char_utilities=>newline in dieser Eigenschaft durch einen Zeilenumbruch in der Darstellung im Browser ersetzt wird. Weitere Information finden Sie unter Primäre Eigenschaft. Diese Eigenschaft ist von einem Administrator personalisierbar.
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 |
Breite des Oberflächenelements, siehe auch Methoden und Eigenschaften der UI-Elemente. Bei der Angabe von width:
-
wrapping=true
Es wird bei Bedarf umgebrochen. Die Breite ist nicht garantiert.
-
wrapping=false
Der Text hat genau die angegebene Breite. Wenn nötig, wird die Ausgabe des Textes mit "..." abgekürzt.
Festlegung, ob der Text in die nächste Zeile umgebrochen werden kann, falls der Platz, der für das umgebene Layout angegeben ist, nicht mehr ausreicht. Andernfalls wird das TextView immer so breit wie der enthaltene Text Platz benötigt, und das umgebende Layout wird entsprechend verbreitert. Diese Eigenschaft ist von einem Administrator personalisierbar.