Show TOC

DataGridLocate this document in the navigation structure

Verwendung

Das UI-Element DataGrid erlaubt es, Daten zweidimensional in Tabellenzellen darzustellen, die in Zeilen und Spalten angeordnet sind. Es eignet sich somit für Anwendungen, bei denen Daten nach zwei Dimensionen angesprochen werden sollen (z. B. eine Anwendung, die Daten zur Absatzplanung nach Produkt und Zeit visualisieren soll). Die klassischen Tabellen Table und C-Table werden dagegen nur durch einen Index (die row identification) definiert. Das DataGrid erlaubt eine schnelle client-seitige Behandlung von Aktionen wie Scrollen, Resizing von Spalten und Zeilen oder Selektion.

Das DataGrid UI-Element enthält Eigenschaften, die für das gesamte DataGrid gelten, wie beispielsweise die Festlegung seiner Höhe und Breite.

Fügen Sie DataGrids über Root-Element austauschen im Kontextmenü als Root-Element einer View ein.

Visualisierung

Das Web-Dynpro- DataGrid setzt sich aus dem übergeordneten UI-Element DataGrid und mehreren View-Elementen für Segmente, Segmentspalten, Segmentzeilen und Segmentzellen zusammen.

Die folgende Grafik stellt ein DataGrid dar:

Features des DataGrid

Die folgende Tabelle listet die Features des DataGrid auf:

Feature

Beschreibung

Weitere Informationen

Zelldesign bestimmen

Sie können die folgenden Elemente zur semantischen Markierung der Zellen verwenden:

  • Decorators

  • Icons

  • Bilder

  • Hintergrundfarbe

DataGridCell-Eigenschaften

DataGrid-Aggregationen

Zelleditoren

Sie können für die einzelnen Zellen verschiedene Zelleditoren bestimmten (z.B. CInputField oder CTextView). Zelleditoren im DataGrid

Darstellung von Hierarchie

Sie können Zeilen und Spalten hierarchisch anordnen, sodass bestimmte Hierarchieebenen vom Benutzer nach Bedarf ein- oder ausgeblendet werden können.

Hierarchische DataGrids erstellen
Selektion

Benutzer können durch Mausklick oder Tastendruck Zellen des DataGrid selektieren.

Das Verhalten der Selektion und ob es eine Selektion am DataGrid gibt, wird durch das Ereignis onSelect des DataGridSegment bestimmt.

DataGridSegment-Eigenschaften
Sortieren Mit der Eigenschaft sortState der DataGridCell legen Sie fest, wie eine Spalte des DataGrid sortiert ist. DataGridCell-Eigenschaften
Filtern Mit der Eigenschaft isFiltered der DataGridCell legen Sie fest, ob eine Filterikone in der Spaltenüberschrift angezeigt werden soll. Dies soll visualisieren, dass die aktuellen DataGrid-Einträge nach Werten in dieser DataGridSegmentCol gefiltert sind. DataGridCell-Eigenschaften
Zellen verbinden Sie können Zellen mit gleichem Wert zu einer Zelle zusammenfassen. DataGridCell-Eigenschaften
Kopieren und Einfügen von Werten

Als Zelleditor in das DataGrid eingefügte CInputFields können mit kopierten Tabellendaten umgehen, die aus dem Clipboard mit der Tastenkombination CTRL + V eingegeben werden.

CInputField-Ereignisse

Höhe und Breite des DataGrid anpassen

Sie können durch Kombination bestimmter Eigenschaften von UI-Elementen festlegen, dass das DataGrid seine Höhe bzw. Breite automatisch an die Größe des Browserfensters anpasst.

Bestimmung der Höhe und Breite des DataGrid
Range-Supply

Mithilfe eines Range-Supply-Knotens ist es möglich, nur genau die Datenmenge an den Context-Knoten zu übergeben, die angefordert wird (z.B. die momentan sichtbaren Zeilen des DataGrid). Damit kann der vom Context-Knoten benötigte Speicher reduziert werden.

Zweidimensionalen Context-Knoten mit Range-Supply erzeugen

Änderungsprotokoll

Das Änderungsprotokoll zeigt eine Liste mit Änderungen an, die der Benutzer clientseitig am DataGrid vorgenommen hat.

Benutzereingaben mit dem Context-Change-Log aufzeichnen
Hinweis

Führen Sie Web-Dynpro-Anwendungen, die DataGrids verwenden, immer im Standards-Modus des Browsers aus. Setzen Sie dazu den Anwendungsparameter WDPREFERREDRENDERING auf den Wert STANDARDS. Weitere Informationen finden Sie unter Applikationsparameter und URL-Parameter.

Weitere Informationen:

DataGrids erstellen

Implementierungsdetails

Laufzeit-Klasse:

CL_WD_DATA_GRID

Eigenschaften im View Designer

Name

Typ

Anfangswert

Bindbar

id

STRING

(automatisch)

nein

enabled

WDY_BOOLEAN

true

ja

height

STRING

ja

visible

WDUI_VISIBILITY

visible

ja

width

STRING

ja

Aggregationen im View Designer

Hinweis

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

Dynamische Programmierung der Eigenschaften

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

View Designer Name

Laufzeitname

Typ

enabled

ENABLED

WDY_BOOLEAN

height

HEIGHT

STRING

visible

VISIBLE

WDUI_VISIBILITY

visible: none

CL_WD_C_TABLE=>E_VISIBLE-NONE

visible: visible

CL_WD_C_TABLE=>E_VISIBLE-VISIBLE

width

WIDTH

STRING

Dynamische Programmierung der Aggregationen

View Designer Name

Laufzeitname

Kardinalität

SEGMENTS

SEGMENT

0..n

SEGMENT_COLS

SEGMENT_COL

0..n

SEGMENT_ROWS

SEGMENT_ROW

0..n

Beispiel

Ein Beispiel finden Sie im System unter WDR_TEST_DATA_GRID.