UIElement-Eigenschaften

enabled

Festlegung, ob durch Benutzerinteraktion ein Ereignis ausgelöst werden kann. Falls der Wert TRUE ist, werden auch die darüber liegenden View-Elemente zur Laufzeit zur Bestimmung des Wertes herangezogen. Das bedeutet, wenn der umgebende Container nicht enabled ist, sind alle darin liegenden Container ebenfalls nicht enabled.

Im Web Dynpro ABAP wird enabled immer von Parent zu Child weitergegeben. Wenn ein UI-Element beliebig tief verschachtelt in einem anderen UI-Element liegt, das enabled=FALSE ist, dann ist es ebenfalls enabled=false.

Werte	Beschreibung
TRUE	Über dem Element liegende View-Elemente werden zur Laufzeit zur Bestimmung des Wertes herangezogen
FALSE	Über dem Element liegende View-Elemente werden zur Laufzeit nicht zur Bestimmung des Wertes herangezogen

Bei einemInteractiveForm-UI-Element ist enabled die Festlegung, ob es sich um ein interaktives Formular oder ein (nicht-interaktives) Druckformular handelt. Falls der Wert TRUE ist, so ist das Formular interaktiv und eingabebereit. Verwenden Sie den Wert FALSE für reine Druckformulare.

Beachten Sie, dass die Eigenschaft enabled bei einem InteractiveForm-Oberflächenelement standardmäßig nicht aktiv ist.

Diese Eigenschaft ist von einem Administrator personalisierbar. Über die Personalisierung kann dieser Eigenschaft der Wert false zugeordnet werden.

styleClassName

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.

Hinweis

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 Auf SAP-Site veröffentlichte Informationen .

Beispiel

Im folgenden Beispiel wird eine Style-Definition angelegt und der Anwendung hinzugefügt. Die Style-Definition sorgt dafür, dass der Text bei Buttons, welche diese Style-Definition verwenden, in der Farbe rot dargestellt wird:

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.

Weitere Informationen finden Sie in der Systemdokumentation der folgenden Schnittstellen:

IF_WD_CUSTOM_STYLE
IF_WD_CUSTOM_STYLE_MANAGER

tooltip

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 einehotkey 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.

visible

Sichtbarkeit des Oberflächenelements.

Diese Eigenschaft ist sowohl von einem Administrator als auch von einem Anwender personalisierbar.

Werte	Beschreibung	Über Personalisierung setzbar
NONE	Das Oberflächenelement wird am Bildschirm nicht dargestellt und nimmt keinen Raum ein	ja
VISIBLE	Das Oberflächenelement wird am Bildschirm dargestellt	nein