Show TOC

SpaltentitelLocate this document in the navigation structure

Verwendung

Standardmäßig besitzt jede Spalte der ALV-Ausgabe einen Spaltentitel. Sie müssen somit nicht erst die entsprechenden Objekte erzeugen.

Sie können den Spaltentitel ändern. Dazu können Sie folgende Bestandteile einrichten:

  • Text

  • Grafik

  • ToolTip

Sie können folgende Einstellungen zum Spaltentitel vornehmen:

  • Objekt des Spaltentitels erzeugen, holen und löschen

  • Wortlaut des Spaltentitels festlegen

  • Festlegen, ob im Spaltentitel Zeilenumbruch möglich ist

  • Pfad der Grafik im Spaltentitel angeben

  • Position der Grafik im Spaltentitel festlegen

  • Wortlaut des ToolTip festlegen

Information zum Standard-Spaltentitel

Die Standard-Spaltentitel enthalten lediglich Text. Der Wortlaut hängt von dem Attribut des Context-Knotens ab:

  • Das Attribut hat keinen DDIC-Bezug

    Dann verwendet das System standardmäßig den technischen Namen des Attributs als Spaltentitel.

  • Das Attribut hat einen DDIC-Bezug

    Dann verwendet das System folgende Spaltentitel:

    • Wenn zu dem DDIC-Datenelement Feldbezeichner definiert sind, so verwendet das System den Kurztext des DDIC-Datenelements als Spaltentitel.

    • Wenn keine Feldbezeichner definiert sind, so verwendet das System den technischen Namen des DDIC-Datenelements.

Objekt des Spaltentitels holen, erzeugen und löschen

Der Spaltentitel einer Spalte Ihrer ALV-Ausgabe ist eine Instanz der Klasse CL_SALV_WD_COLUMN_HEADER. Zu jedem Spaltenobjekt kann ein Objekt des Spaltentitels existieren.

Um das Objekt für den Spaltentitel zu holen, zu erzeugen oder zu löschen, verwenden Sie Methoden der Klasse CL_SALV_WD_COLUMN.

Methoden zum Holen, Erzeugen und Löschen des Spaltentitels

Funktion

Methode

Objekt des Spaltentitels holen

GET_HEADER

Objekt des Spaltentitels erzeugen

CREATE_HEADER

Objekt des Spaltentitels löschen

DELETE_HEADER

Wortlaut des Spaltentitels festlegen

Sie können selbst festlegen, welcher Text als Spaltentitel angezeigt wird. Hierzu haben Sie folgende Möglichkeiten:

  • Sie geben einen beliebigen Text an.

  • Sie geben ein geeignetes DDIC-Datenelement an, dessen Feldbezeichner als Spaltentitel verwendet werden soll.

Für eine DDIC-Beziehung geben Sie zunächst das DDIC-Datenelement an, das den Wortlaut des Spaltentitels liefert. Hierzu verwenden Sie die Methode SET_PROP_DDIC_BINDING_ELEMENT. Sie machen folgende Angaben:

  • Spaltentitel oder ToolTip

    Der Text aus dem DDIC soll hier für den Spaltentitel verwendet werden.

  • Name des DDIC-Datenelements

Wenn Sie keine weiteren Angaben machen, wird der Kurztext des DDIC-Datenelements verwendet. Sie können auch Überschrift, Mittel- oder Langtext des DDIC-Datenelements verwenden. Hierzu verwenden Sie zusätzlich die Methode SET_PROP_DDIC_BINDING_FIELD.

Hinweis

Wenn Sie beliebigen Text als Spaltentitel angeben, müssen Sie mit dieser Methode die DDIC-Beziehung explizit ausschalten.

Um den Wortlaut des Spaltentitels anzugeben, verwenden Sie Methoden der Klasse CL_SALV_WD_COLUMN_HEADER.

Methoden zum Wortlaut des Spaltentitels

Funktion

Methode

Beliebigen Text als Spaltentitel festlegen

DDIC-Beziehung explizit ausschalten

SET_TEXT

SET_PROP_DDIC_BINDING_FIELD

Wortlaut des Spaltentitels holen

GET_TEXT

DDIC-Datenelement angeben, dessen Feldbezeichner als Spaltentitel verwendet werden soll

SET_PROP_DDIC_BINDING_ELEMENT

Namen des DDIC-Datenelements holen

GET_ PROP_DDIC_BINDING_ELEMENT

Typ des Feldbezeichners angeben, der als Spaltentitel verwendet werden soll

SET_ PROP_DDIC_BINDING_FIELD

Typ des Feldbezeichners holen, der als Spaltentitel verwendet wird

GET_ PROP_DDIC_BINDING_FIELD

Zeilenumbruch im Spaltentitel

Standardmäßig nimmt das System im Spaltentitel keinen Zeilenumbruch vor. Die Spalte ist damit mindestens so breit, wie der Wortlaut des Spaltentitels. Sie können festlegen, dass im Spaltentitel Zeilenumbrüche möglich sind.

Hinweis

Damit der Spaltentitel umgebrochen wird, muss für die ALV-Ausgabe das Table-Layout fixiert sein (siehe auch Größe von ALV-Anzeige, Spalte, Zelle).

Wenn der Spaltentitel Zeichen enthält, bei denen ein Zeilenumbruch möglich ist (z. B. Leerzeichen, Bindestrich), und die Breite der Spalte gering ist, kann das System den Text auf mehrere Zeilen aufteilen. Dazu verwenden Sie Methoden der Klasse CL_SALV_WD_COLUMN_HEADER.

Methoden zum Zeilenumbruch im Spaltentitel

Funktion

Methode

Zeilenumbruch einstellen

SET_HEADER_TEXT_WRAPPING

Ermitteln, ob Zeilenumbruch im Spaltentitel eingestellt ist

GET_HEADER_TEXT_WRAPPING

Pfad der Grafik im Spaltentitel festlegen

Sie können im Spaltentitel jede Grafik darstellen, die für die Web Dynpro-Umgebung geeignet ist (siehe Handling von Bildern und Web-Ikonen). Um den Pfad bzw. den Bezeichner der Grafikdatei festzulegen, verwenden Sie Methoden der Klasse CL_SALV_WD_COLUMN_HEADER.

Methoden zum Festlegen des Pfades der Grafikdatei

Funktion

Methode

Pfad bzw. Bezeichner der Grafik festlegen

SET_IMAGE_SOURCE

Pfad bzw. Bezeichner der Grafik holen

GET_IMAGE_SOURCE

Position der Grafik im Spaltentitel festlegen

Sie können entscheiden, ob Sie die Grafik, die Sie im Spaltentitel anzeigen möchten, vor oder nach dem Text des Spaltentitels platzieren. Dazu verwenden Sie Methoden der Klasse CL_SALV_WD_COLUMN_HEADER.

Methoden zum Platzieren der Grafik im Titel

Funktion

Methode

Position innerhalb des Titels festlegen

SET_IMAGE_FIRST

Position innerhalb des Titels holen

GET_IMAGE_FIRST

Wortlaut des ToolTip festlegen

Der ToolTip des Spaltentitels wird sichtbar, wenn der Benutzer den Mauszeiger über den Titel der Spalte führt und dort kurz ruhen lässt.

Sie können selbst festlegen, welcher Text als ToolTip angezeigt wird. Hierzu haben Sie folgende Möglichkeiten:

  • Sie geben einen beliebigen Text an.

  • Sie geben ein geeignetes DDIC-Datenelement an, dessen Feldbezeichner als ToolTip verwendet werden soll.

Für eine DDIC-Beziehung geben Sie zunächst das DDIC-Datenelement an, das den Wortlaut des ToolTip liefert. Hierzu verwenden Sie die Methode SET_PROP_DDIC_BINDING_ELEMENT. Sie machen folgende Angaben:

  • Spaltentitel oder ToolTip

    Der Text aus dem DDIC soll hier für den ToolTip verwendet werden.

  • Name des DDIC-Datenelements

Wenn Sie keine weiteren Angaben machen, wird der Kurztext des DDIC-Datenelements verwendet. Sie können auch Überschrift, Mittel- oder Langtext des DDIC-Datenelements verwenden. Hierzu verwenden Sie zusätzlich die Methode SET_PROP_DDIC_BINDING_FIELD.

Hinweis

Wenn Sie beliebigen Text als ToolTip angeben, müssen Sie mit dieser Methode die DDIC-Beziehung explizit ausschalten.

Um den Wortlaut des ToolTip anzugeben, verwenden Sie Methoden der Klasse CL_SALV_WD_COLUMN_HEADER.

Methoden zum Wortlaut des ToolTip

Funktion

Methode

Beliebigen Text als ToolTip festlegen

DDIC-Beziehung explizit ausschalten

SET_TOOLTIP

SET_PROP_DDIC_BINDING_FIELD

Wortlaut des ToolTip holen

GET_TOOLTIP

DDIC-Datenelement angeben, dessen Feldbezeichner als ToolTip verwendet werden soll

SET_PROP_DDIC_BINDING_ELEMENT

Namen des DDIC-Datenelements holen

GET_ PROP_DDIC_BINDING_ELEMENT

Typ des Feldbezeichners angeben, der als ToolTip verwendet werden soll

SET_ PROP_DDIC_BINDING_FIELD

Typ des Feldbezeichners holen, der als ToolTip verwendet wird

GET_ PROP_DDIC_BINDING_FIELD