Table-Eigenschaften

accessibilityDescription

Wenn Sie die Barrierefreiheit aktiviert haben, wird der zugeordnete Text der Quick-Info hinzugefügt. Diese Beschreibung soll das Oberflächenelement semantisch näher erläutern und wird vom Bildschirmlesegerät nur vorgelesen, wenn der Benutzer das komplette Oberflächenelement fokussiert.

Diese Eigenschaft ist von einem Administrator personalisierbar

activateAccessKey

Aktivierung von Zugangstasten.

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

cellStyleClassNames

Mit dieser Eigenschaft können Sie, ähnlich wie mit der Eigenschaft styleClassName für UI-Elemente, eigene Style-Definitionen anlegen, um das Erscheinungsbild einer Tabellenzelle verändern. Dafür verwenden Sie das View-Element TableStandardCell (TABLE_STANDARD_CELL). Über die Parameter ROW_ID und COLUMN_ID bestimmen Sie die Zelle. Weitere Informationen zu styleClassName finden Sie unter UIElement-Eigenschaften.

Eine Beispielanwendung finden Sie im System unter der Component WDR_TEST_CUSTOM_STYLES.

columnResizeMode

Falls die Personalisierung eingeschaltet ist, so kann die Breite der Tabellenspaltenbreiten mit der Maus durch Ziehen der Spaltenbegrenzungslinien vom Benutzer verändert werden. Die neuen Werte werden in den Personalisierungsdaten des Benutzers persistiert. Falls der Applikationsparameter WDUIGUIDELINE=GL20 ist, so kann mit Hilfe dieser Eigenschaft das Verhalten dieses Features eingestellt werden.

Diese Eigenschaft ist sowohl von einem Administrator als auch von einem Anwender personalisierbar Letzteres passiert, wenn Sie die Option Horizontales Scrollen erlauben im Tabellenpersonalisierungsdialog ein- oder ausschalten.

Hinweis

Falls columnResizeMode=preserveOtherColumnWidths, müssen die folgenden Bedingungen erfüllt sein:

Table.width muss angegeben werden
Alle TableColumn.width müssen eine Breite in ex, em oder px gesetzt haben

Wenn eine solche Breite nicht gesetzt ist, versucht das Web-Dynpro-Framework, aus dem Zelleditor eine Breite zu ermitteln.

Wert	Beschreibung	Über Personalisierung setzbar
preserveOtherColumnWidths	Durch das Verändern der Breite einer Spalte durch Ziehen der Spaltentrennlinien in der Kopfzeile mit der Maus wird die Breite aller anderen Spalten nicht beeinflusst. Wenn die Summe aller Spaltenbreiten größer ist als die Breite der gesamten Tabelle, dann wird gleichmäßiges/glattes Client-seitiges Scrollen ermöglicht. Hinweis Beachten Sie, dass bei dieser Ausprägung sowohl Table.ScrollableColCount als auch Table.firstVisibleScrollableCol nicht verwendet werden können	ja
preserveTableWidth (Standardwert)	Das Verhalten bei der Größenveränderung ist wie gewohnt: Durch das Verändern der Breite einer Spalte durch Ziehen der Spaltentrennlinien in der Kopfzeile mit der Maus wird die Breite aller anderen Spalten ebenfalls beeinflusst.	ja

Wert

Beschreibung

Über Personalisierung setzbar

preserveOtherColumnWidths

Durch das Verändern der Breite einer Spalte durch Ziehen der Spaltentrennlinien in der Kopfzeile mit der Maus wird die Breite aller anderen Spalten nicht beeinflusst.

Wenn die Summe aller Spaltenbreiten größer ist als die Breite der gesamten Tabelle, dann wird gleichmäßiges/glattes Client-seitiges Scrollen ermöglicht.

Hinweis

Beachten Sie, dass bei dieser Ausprägung sowohl Table.ScrollableColCount als auch Table.firstVisibleScrollableCol nicht verwendet werden können

ja

preserveTableWidth (Standardwert)

Das Verhalten bei der Größenveränderung ist wie gewohnt: Durch das Verändern der Breite einer Spalte durch Ziehen der Spaltentrennlinien in der Kopfzeile mit der Maus wird die Breite aller anderen Spalten ebenfalls beeinflusst.

ja

Achtung

Einschränkungen für preserveOtherColumnWidths:

Diese Ausprägung steht nur bei gesetztem Applikationsparameter WDUIGUIDELINE = GL20 zur Verfügung.
Feste Spalten und Selektionsspalten werden ignoriert und scrollen ebenfalls.
Alle TableColumn/ TreeBy*TableColumn.Width müssen mit absoluten Einheiten gefüllt sein ( px, em, ex). Relative Spaltenbreiten (mit der Einheit %) werden ignoriert. In diesem Fall wird ein geschätzter absoluter Wert verwendet.
Table.width muss gesetzt sein. Hierbei sind 100% und andere absolute Breitenangaben ( px, ex, em) möglich. Ist keine Table.width gesetzt, dann setzt das Web-Dynpro-ABAP-Framework die Breite auf Table.width = 100%.

Sie finden ein Beispiel für beide Werte im System in der Testapplikation WDR_TEST_TABLE_BTC.

dataSource

Context-Knoten mit den Daten für die Table. Jedes Element des Context-Knotens entspricht dabei einer Tabellenzeile.

Primäre Eigenschaft.

defaultButtonId

Id eines ToolBarButton von der ToolBar der Table. Wenn der Benutzer in einem ( ToolBar) InputField in einer Table Enter drückt, dann wird der Action-Handler dieses Button s aufgerufen. Ein ähnlicher Mechanismus steht für TransparentContainer, Group s etc zur Verfügung.

Sie finden ein Beispiel im System in der Compponent WDR_TEST_TABLE in Cell Alignment. Wenn Sie dort in einem InputField in der Table Enter drücken, dann wird der Action-Handler für den Button Zellen einfügen in der ToolBar ausgelöst.

Diese Eigenschaft ist von einem Administrator personalisierbar

design

Darstellung der Table. Sie sollten design<>standard nur im Fall von table.readonly=true benutzen. Die Hintergrundfarbe der Table und Tabellenzellen wird zusätzlich noch durch und das Property cellDesign von TableColumn und Zellvarianten beeinflusst. Das Property table.gridMode beeinflusst das Zeichnen der Gitterlinien.

Hinweis

Nur falls table.design<>alternating gesetzt ist, wird die Farbe von tableColumn.cellDesign und das cellDesign von etwaigen Zellvarianten angezeigt.

Diese Eigenschaft ist von einem Administrator personalisierbar.

Wert	Beschreibung	Über Personalisierung setzbar
alternating	Weiß/grau alternierende Zeilen, nur bei readOnly möglich	ja
standard	Standard-Tabellenhintergrund: Der Hintergrund der Table wird einheitlich mit einer Farbe angezeigt, die einzelnen Zellen werden mit Gitternetzlinien dargestellt.	ja
transparent	Der Hintergrund der Table ist transparent, die einzelnen Zellen werden ohne Gitternetzlinien dargestellt.	ja
transparentWithGrid	Der Hintergrund der Table ist transparent, die einzelnen Zellen werden mit Gitternetzlinien dargestellt.	ja

displayEmptyRows

Mit dieser Eigenschaft wird überprüft, ob leere Zeilen im Bereich für sichtbare Zeilen dargestellt werden. Wenn Sie diese Eigenschaft auf false setzen, werden die sichtbaren Zeilen derart zusammengeklappt, dass die eigentlichen Anzahl der Zeilen mit Inhalt dargestellt wird.

Falls die Anzahl der tatsächlich vorhandenen Zeilen kleiner ist als table.visibleRowCount, so werden im Falle von displayEmptyRows=true zusätzliche inaktive, leere Zeilen hinzugefügt.

dropOnRowName

Name der DropTargetInfo, die das Droppen auf Table-Zeilen festlegt.

Wenn der Wert initial ist, ist kein Droppen auf eine Zeile möglich. Wenn der Wert dem Namen einer DropTargetInfo entspricht, dann legt diese DropTargetInfo das Verhalten der Table-Zeile als Drop-Ziel fest. Durch Context-Binding kann für jede Zeile so ein anderes DropTargetInfo angegeben werden.

Weitere Informationen: Drag&Drop

emptyTableText

Text, der bei einer leeren Table angezeigt wird.

Diese Eigenschaft ist von einem Administrator personalisierbar.

firstActualRow

Achtung

Diese Eigenschaft ist deprecated. Siehe auch Daten-Ausschnitte im Context.

Zeile der Table (ab 0 gezählt!), die dem ersten Element im Context entspricht. Damit kann erreicht werden, dass der Context nur einen Ausschnitt der Table enthält.

Benutzen Sie diese Eigenschaft nur für Table s mit extrem großen Datenaufkommen.

Hinweis

Beachten Sie, dass dies nicht zulässig ist für TreeByKeyTableColumn bzw. TreeByNestingTableColumn.

firstVisibleRow

Erste sichtbare Zeile der Table (ab 0 gezählt!).

Hinweis

Liegt die firstVisibleRow außerhalb den tatsächlich vorhandenen Datensätzen, so wird die "erste sichtbare Zeile" intern so neu berechnet, dass möglichst viele Zeilen am Ende des Datenbestandes sichtbar werden. Der Wert wird jedoch nicht in das UI-Element zurück geschrieben. Ist die Zeile zwar in den Datensätzen vorhanden, jedoch reichen die folgenden Datensätze nicht aus, um alle Zeilen aufzufüllen, so werden für die fehlenden Datensätze leere Zeilen angezeigt. Eine Korrektur der "ersten sichtbaren Zeile" wird hier nicht vorgenommen.

Diese Eigenschaft, die nicht gebunden sein muss, kann vom Client geändert werden. Siehe auch Eigenschaften bei der Verwendung in MultiPane oder TablePopin.

firstVisibleScrollableCol

Erste sichtbare scrollbare Spalte der Table (ViewElement-Id).

Hinweis

Diese Eigenschaft, die nicht gebunden sein muss, kann vom Client geändert werden. Siehe auch Eigenschaften bei der Verwendung in MultiPane oder TablePopin.

fixedTableLayout

Bei fixedTableLayout ist jede Spalte der Table genauso breit wie angegeben. In diesem Fall müssen unbedingt die Breiten für die Table und die TableColumn s gesetzt sein. Weitere Informationen finden Sie in SAP Hinweis 1253282 Auf SAP-Site veröffentlichte Informationen . Ist der Inhalt größer, so wird er rechts abgeschnitten. Ohne fixedTableLayout ist eine Spalte so breit wie angegeben oder der breiteste sichtbare TableCellEditor. In diesem Fall wirken Tabellenspaltenbreiten wie Mindestbreiten. In diesem Modus kann sich beim vertikalen Scrollen der Table die Breitenverteilung der Tabellenspalten verändern.

Hinweis

Bei Verwendung von scrollableColCount=-2 sollte fixedTableLayout gesetzt sein.

Diese Eigenschaft ist von einem Administrator personalisierbar.

footerVisible

Diese Eigenschaft wird zur Zeit nicht ausgewertet.

gridMode

Gitter-Modus. Diese Einstellung wird bei readOnly- Table s mit design=transparent ignoriert.

Diese Eigenschaft ist von einem Administrator personalisierbar

Wert	Beschreibung	Über Personalisierung setzbar
both	Horizontale und vertikale Linen werden angezeigt.	ja
horizontal	Horizontale Linen werden angezeigt.	ja
none	Die Table besitzt keine Trennlinien.	ja
vertical	Vertikale Linen werden angezeigt.	ja

handleHotkeys

Festlegung, ob Aktionstasten, die innerhalb des UI-Elements definiert werden, global oder lokal (d.h. wenn der Fokus im UI-Element ist) ausgelöst werden können.

legendId

Id der zugeordneten Legend.

multiColSorting

Aktiviert die Fähigkeit, mehrere Spalten zu sortieren. Sie finden ein Beispiel im System in der Component: WDR_TEST_TABLE in der View CELL_POPIN.

Über STRG und Anklicken der gewünschten Spalten können Sie dann mehrere Spalten zum Sortieren auswählen.

readOnly

Die Table unterscheidet zwischen editierbarem und readOnly-Modus. Im editierbaren Modus ( readOnly=false) werden eingabefähige Zellen mit weißen Hintergrund und nicht eingabefähige Zellen ausgegraut dargestellt. Eingabefähig sind Zellen, wenn die Table enabled ist, der darin befindliche TableCellEditor an sich eingabefähig, enabled und nicht readOnly ist.

Im readOnly-Modus sind alle Zellen nicht eingabefähig. Sie werden aber nicht ausgegraut dargestellt. Außerdem ist es möglich, semantische Farben ( TableColumn.cellDesign) und alternierenden Hintergrund ( Table.design=alternating) zu nutzen.

Die UI-Elemente InputField, DropDownByIndex und DropDownByKey werden als Text visualisiert. Es ist also auch keine Werteliste verfügbar.

Die UI-Elemente CheckBox und RadioButton werden als readOnly visualisiert.

Hinweis

Nur wenn readonly=X, dann hat Table.design=alternating eine Wirkung.

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

rowCount

Achtung

Diese Eigenschaft ist deprecated. Siehe auch Daten-Ausschnitte im Context.

Anzahl von Zeilen, die in der Table visualisiert werden (nur für Context-Paging).

Beachten Sie, dass Sie nicht gleichzeitig den rowCount setzen und eine TreeByNestingTableColumn oder TreeByKeyTableColumn einfügen dürfen.

rowSelectable

Die Eigenschaft rowSelectable erlaubt es, über Context-Bindung gezielt gewisse Tabellenzeilen selektierbar oder nicht-selektierbar zu machen.

Beispiel

Beispielsweise sollen im WDA ALV Summenzeilen für Ergebnisse und Zwischenergebnisse nicht selektiert werden können, da sie keinen Daten entsprechen, und mittels rowSelectable werden diese Zeilen in einen nicht selektierbaren Zustand gebracht.

Sie sollten den Wert rowSelectable jedoch nicht ohne Context-Bindung fest auf false setzen. Falls die Selektion komplett ausgeschaltet werden soll, setzen Sie den selectionMode auf none. Es ist also nicht zulässig, rowSelectable=false für selektierte Zeilen/Context-Elemente zu setzen!

scrollableColCount

Anzahl von scrollbaren Spalten, die auf einmal angezeigt werden.

Mögliche Werte	Beschreibung
Kleinere Werte als -1	nicht zulässig
-1	Alle Spalten werden angezeigt. Es gibt kein Spalten-Scrolling.
0	Keine Spalten werden angezeigt. Es werden auch keine TableColumn-Header angezeigt, und der folgende Hinweis erscheint: `Die Tabelle enthält keine sichtbaren Spalten`.
Werte größer 0	Ein Scrollbalken für das Spalten-Scrolling erscheint und die angegebene Anzahl der Spalten wird angezeigt.

Diese Eigenschaft ist von einem Administrator personalisierbar

selectedPopin

Aktuell sichtbares TablePopin.

ID des für die Zeile sichtbaren Popins: Entweder die ID des TablePopin oder eines der Spalten-Popins. Lassen Sie diese Eigenschaft leer, um kein Popin anzuzeigen.

selectionChangeBehaviour

Die Umschaltung der Lead-Selection im Context, als Folge der Selektionsänderung durch den Benutzer, kann automatisch oder manuell, d.h. durch die Anwendung selbst, erfolgen.

Diese Funktionalität zieht nur, wenn die Lead-Selection vom Benutzer gesetzt oder entfernt wird.

Wert	Beschreibung
auto	Lead-Selection wird mit umgeschaltet. Achtung Bei WDUIGUIDELINE=GL20 oder falls Table.selectionColumnDesign=toggle, darf nur auto benutzt werden.
manual	Die Lead-Selection wird nicht vom Framework gesetzt. Der Anwendungsentwickler kann im Event-Handler von onLeadSelect die Lead-Selection setzen.
ifNoLoss	für zukünftige Erweiterungen

selectionColumnDesign

Hiermit können Sie das Verhalten und Aussehen einer selektierbaren Web-Dynpro-ABAP- Table beeinflussen.

Achtung

Bei selectionColumnDesign=none ist eine Selektion nur durch das Klicken in die Tabellenzellen möglich. Allerdings ist dies nicht möglich, wenn man auf einen editerbaren oder klickbaren Zelleditor wie InputField oder Button klickt. Daher empfehlen wir, dieses Feature nur für readOnly- Table s zu verwenden.

Weitere Informationen finden Sie unter Selektieren in einer Table.

Wert	Beispiel für die visuelle Darstellung	Beschreibung
default		Falls WDUIGUIDELINE=GL11, wird standard benutzt; falls WDUIGUIDELINE=GL22, dann wird toggle benutzt (Standardeinstellung).
none		Die Selektionszellen am Anfang der Zeile verschwinden.
standard		Es gibt keine Änderungen an der Darstellung der Selektionszellen.
toggle		Selektionszellen sind sichtbar, verhalten sich jedoch anders als gewohnt, siehe auch Selektieren in einer Table. Achtung Der Wert toggle darf nur zusammen mit der Eigenschaft Table.selectionChangeBehaviuour=auto verwendet werden.

selectionMode

Festlegung, wie die Selektion der Table erfolgen kann. Durch einen linken Mausklick auf einer Selektionszelle wird eine Zeile selektiert. D.h. es wird eine Selektion und die Lead-Selection (außer bei singleNoLead und multiNoLead) auf dem zugehörigen Element gesetzt. Falls weitere Selektionen vorliegen, werden diese gelöscht.

Im Modus multi, multiNoLead und auto mit Knoten-Kardinalität 0..n bzw. 1..n ist Folgendes möglich:

STRG+Klick, STRG+Leertaste

Umschalten einer Selektion
SHIFT+Klick, SHIFT+Leertaste

Selektieren des Bereichs von der Lead-Selection bis zur gewählten Zeile. Ist keine Lead-Selection gesetzt, so wird von der ersten Zeile aus die Selektion gezogen. In dem Modus multiNoLead wird die Selektion ausgehend von der letzten ausgewählten Zeile gezogen.

Wert	Beschreibung
auto	Lead-Selection und Single-Selection bzw. Multi-Selection, falls der Context-Knoten dies zulässt.
single	Lead-Selection und Single-Selection.
multi	Lead-Selection und Multiple-Selection.
none	Keine Selektion.
singleNoLead	Single-Selection (ohne Lead-Selection).
multiNoLead	Multiple-Selection (ohne Lead-Selection).

visibleRowCount

Anzahl der Zeilen, die in der Table auf einmal sichtbar sind.

Ist die Anzahl der Zeilen in der dataSource kleiner als visibleRowCount, so wird die Table mit leeren Zeilen aufgefüllt. Diese Zeilen sind nicht eingabefähig.

Achtung

Table.visibleRowCount = -1 ist deprecated.

Mit -1 werden alle Zeilen aus der dataSource auf einmal angezeigt. Dies kann jedoch auf der Client-Seite zu Performance-Einbußen führen. Verwenden Sie daher stattdessen Table.displayEmptyRows=false kombiniert mit Table.visibleRowCount>0. Zusätzlich müssen Sie die entsprechende maximale Anzahl sichtbarer Zeilen für Ihre Anwendungsoberflächen spezifizieren.

Hinweis

Eine große Zahl sichtbarer Einträge (z.B. mehr als 30) kann zu Performance-Problemen führen. Verwenden Sie die eingebaute Paging- bzw. Scroll-Möglichkeiten des dazugehörigen UI-Elements.

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

width

Breite der Table. Die Table wird mindestens so groß wie diese Angabe, jedoch auch groß genug, dass der Inhalt in die Table passt. Die Angabe der Breite für die Table empfiehlt sich daher nur bei der Verwendung von prozentualen Spaltenbreiten. Siehe auch SAP Hinweis 1253282 Auf SAP-Site veröffentlichte Informationen .

Empfehlung

Wir empfehlen, die Eigenschaft width einer Table immer zu setzen (z.B. auf 100%), da sonst die Table im Firefox Browser gestaucht angezeigt werden kann.

Diese Eigenschaft ist von einem Administrator personalisierbar.