Spaltenüberschriften

#### Search Results

Search

# Spaltenüberschriften

Dieses Dokument beschreibt verschiedene Möglichkeiten, wie Sie die Anzeige der von einem `DISPLAY`-Statement erzeugten Spaltenüberschriften beeinflussen können.

Folgende Themen werden behandelt:

- Standard-Spaltenüberschriften

- Standard-Spaltenüberschriften unterdrücken — die NOHDR-Option

- Eigene Spaltenüberschriften definieren

- NOTITLE und NOHDR kombinieren

- Spaltenüberschriften zentrieren — der HC-Parameter

- Breite von Spaltenüberschriften — der HW-Parameter

- Füllzeichen für Überschriften — die Parameter FC und GC

- Unterstreichungszeichen für Überschriften — der UC-Parameter

- Spaltenüberschriften unterdrücken — die Schrägstrich-Notation (’/’)

- Weitere Beispiele für Spaltenüberschriften

## Standard-Spaltenüberschriften

Standardmäßig wird jedes mit einem `DISPLAY`-Statement ausgegebene Datenbankfeld mit einer (für das Feld im DDM definierten) Standard-Spaltenüberschrift ausgegeben.

    ** Example 'DISPLX01': DISPLAY
    ************************************************************************
    DEFINE DATA LOCAL
    1 VIEWEMP VIEW OF EMPLOYEES
      2 PERSONNEL-ID
      2 NAME
      2 BIRTH
      2 JOB-TITLE
    END-DEFINE
    *
    READ (3) VIEWEMP BY BIRTH
      DISPLAY PERSONNEL-ID NAME JOB-TITLE
    END-READ
    END

Ausgabe des Programms `DISPLX01`:

Das obige Beispielprogramm verwendet Standard-Spaltenüberschriften und erzeugt folgende Ausgabe:

    Page      1                                                  04-11-11  14:15:54

    PERSONNEL         NAME                  CURRENT
       ID                                  POSITION
    --------- -------------------- -------------------------

    30020013  GARRET               TYPIST
    30016112  TAILOR               WAREHOUSEMAN
    20017600  PIETSCH              SECRETARY

## Standard-Spaltenüberschriften unterdrücken — die NOHDR-Option

Wünschen Sie in Ihrem Report keine Spaltenüberschriften, geben Sie im `DISPLAY`-Statement das Schlüsselwort `NOHDR` an, zum Beispiel:

    DISPLAY NOHDR PERSONNEL-ID NAME JOB-TITLE

## Eigene Spaltenüberschriften definieren

Wenn Sie statt der Standard-Spaltenüberschriften eigene Spaltenüberschriften ausgeben möchten, geben Sie unmittelbar vor dem jeweiligen Feld einen Text in Apostrophen (') an, wobei `'text'` die für das Feld zu verwendende Spaltenüberschrift ist.

    ** Example 'DISPLX08': DISPLAY  (with column title in 'text')
    ************************************************************************
    DEFINE DATA LOCAL
    1 VIEWEMP VIEW OF EMPLOYEES
      2 PERSONNEL-ID
      2 NAME
      2 BIRTH
      2 JOB-TITLE
    END-DEFINE
    *
    READ (3) VIEWEMP BY BIRTH
      DISPLAY PERSONNEL-ID
             'EMPLOYEE' NAME
             'POSITION' JOB-TITLE
    END-READ
    END

Ausgabe des Programms `DISPLX08`:

Das obige Programm enthält für das Feld `NAME` die Spaltenüberschrift `EMPLOYEE` und für das Feld `JOB-TITLE` die Spaltenüberschrift `POSITION`; für das Feld `PERSONNEL-ID` wird die Standard-Spaltenüberschrift verwendet. Das Programm erzeugt folgende Ausgabe:

    Page      1                                                  04-11-11  14:15:54

    PERSONNEL       EMPLOYEE               POSITION
       ID
    --------- -------------------- -------------------------

    30020013  GARRET               TYPIST
    30016112  TAILOR               WAREHOUSEMAN
    20017600  PIETSCH              SECRETARY

## NOTITLE und NOHDR kombinieren

Zur Ausgabe eines Reports ohne Kopfzeilen und Spaltenüberschriften geben Sie die Optionen `NOTITLE` und `NOHDR` gleichzeitig an, und zwar in der folgenden Reihenfolge:

    DISPLAY NOTITLE NOHDR PERSONNEL-ID NAME JOB-TITLE

## Spaltenüberschriften zentrieren — der HC-Parameter

Standardmäßig werden Spaltenüberschriften zentriert über den Spalten ausgegeben. Mit dem Session-Parameter `HC` (Header Centering) können Sie die Ausrichtung der Spaltenüberschriften beeinflussen:

`HC=L` | Spaltenüberschriften werden linksbündig ausgerichtet.
`HC=R` | Spaltenüberschriften werden rechtsbündig ausgerichtet.
`HC=C` | Spaltenüberschriften werden zentriert. Dies ist die Standardeinstellung.

Sie können den `HC`-Parameter in einem `FORMAT`-Statement angeben; er gilt dann für den gesamten Report. Sie können ihn auch in einem `DISPLAY`-Statement angeben, und zwar sowohl auf Statement- wie auf Elementebene.

Beispiel für die Angabe des HC-Parameters auf Statement-Ebene, d.h. für die linksbündige Ausrichtung aller Spaltenüberschriften:

    DISPLAY (HC=L) PERSONNEL-ID NAME JOB-TITLE

## Breite von Spaltenüberschriften — der HW-Parameter

Mit dem Session-Parameter `HW` (Header Width) bestimmen Sie die Breite einer von einem `DISPLAY`-Statement erzeugten Spalte.

`HW=ON` | Die Breite einer `DISPLAY`-Spalte wird entweder durch die Länge des Feldes oder durch die Länge der Spaltenüberschrift bestimmt, je nachdem was länger ist. Dies ist die Standardeinstellung.
`HW=OFF` | Wenn Sie `HW=OFF` angeben, wird die Breite einer `DISPLAY`-Spalte allein durch die Länge des Feldes bestimmt. Bitte beachten Sie, dass `HW=OFF` nur bei `DISPLAY`-Statements, die keine Spaltenüberschriften erzeugen, wirkt; d.h. bei einem ersten `DISPLAY`-Statement mit `NOHDR`-Option, oder bei einem nachfolgenden `DISPLAY`-Statement.

Sie können den `HW`-Parameter in einem `FORMAT`-Statement verwenden; er gilt dann für den gesamten Report. Sie können ihn auch in einem `DISPLAY`-Statement angeben, und zwar sowohl auf Statement- wie auf Elementebene.

## Füllzeichen für Überschriften — die Parameter FC und GC

Mit dem Session-Parameter `FC` (Filler Character) bestimmen Sie das Füllzeichen, das auf beiden Seiten der von einem `DISPLAY`-Statement erzeugten Überschrift über die gesamte Breite der Spalte erscheint. Voraussetzung ist, dass die Spaltenbreite durch die Feldlänge und nicht durch die Überschrift bestimmt wird (vgl. `HW`-Parameter und Beschreibung oben), sonst hat der `FC`-Parameter keine Wirkung.

Wenn eine Feldgruppe oder eine Periodengruppe mit einem `DISPLAY`-Statement ausgegeben wird, wird eine Gruppenüberschrift über den Überschriften der einzelnen Felder der Gruppe ausgegeben. Mit dem Session-Parameter `GC` (Group Filler Character) bestimmen Sie das Füllzeichen, das auf beiden Seiten der Gruppenüberschrift erscheinen soll.

Während der `FC`-Parameter für Überschriften einzelner Felder gilt, bezieht sich der `GC`-Parameter auf Überschriften für Feldgruppen.

Sie können die Parameter `FC` und `GC` in einem `FORMAT`-Statement verwenden; sie gelten dann für den gesamten Report. Sie können sie auch in einem `DISPLAY`-Statement angeben, und zwar sowohl auf Statement- wie auf Elementebene.

    ** Example 'FORMAX01': FORMAT (with parameters FC, GC)
    ************************************************************************
    DEFINE DATA LOCAL
    1 VIEWEMP VIEW OF EMPLOYEES
      2 NAME
      2 INCOME (1:1)
        3 CURR-CODE
        3 SALARY
        3 BONUS (1:1)
    END-DEFINE
    *
    FORMAT FC=* GC=$
    *
    READ (3) VIEWEMP BY NAME
      DISPLAY NAME (FC==) INCOME (1)
    END-READ
    END

Ausgabe des Programms `FORMAX01`:

    Page      1                                                  04-11-11  14:15:54

    ========NAME======== $$$$$$$$$$$$INCOME$$$$$$$$$$$$

                         CURRENCY **ANNUAL** **BONUS***
                             CODE     SALARY
    -------------------- -------- ---------- ----------

    ABELLAN              PTA         1450000          0
    ACHIESON             UKL           10500          0
    ADAM                 FRA          159980      23000

## Unterstreichungszeichen für Überschriften — der UC-Parameter

Standardmäßig werden Kopfzeilen und Überschriften mit einem Bindestrich (-) unterstrichen.

Mit dem Session-Parameter `UC` (Underlining Character) können Sie ein anderes Zeichen bestimmen, das als Unterstreichungszeichen verwendet werden soll.

Sie können den `UC`-Parameter in einem `FORMAT`-Statement verwenden; er gilt dann für den gesamten Report. Sie können ihn auch in einem `DISPLAY`-Statement angeben, und zwar sowohl auf Statement- wie auf Elementebene.

    ** Example 'FORMAX02': FORMAT (with parameter UC)
    ************************************************************************
    DEFINE DATA LOCAL
    1 VIEWEMP VIEW OF EMPLOYEES
      2 PERSONNEL-ID
      2 NAME
      2 BIRTH
      2 JOB-TITLE
    END-DEFINE
    *
    FORMAT UC==
    *
    WRITE TITLE LEFT JUSTIFIED UNDERLINED 'EMPLOYEES REPORT'
    SKIP 1
    READ (3) VIEWEMP BY BIRTH
      DISPLAY PERSONNEL-ID (UC=*) NAME JOB-TITLE
    END-READ
    END

Im obigen Programm ist der `UC`-Parameter auf Programmebene und auf Feldebene gesetzt: das im `FORMAT`-Statement angegebene Unterstreichungszeichen (=) gilt für den ganzen Report außer für das Feld `PERSONNEL-ID`, für das ein anderes Unterstreichungszeichen (*) angegeben ist.

Ausgabe des Programms `FORMAX02`:

    EMPLOYEES REPORT
    ===============================================================================

    PERSONNEL         NAME                  CURRENT
       ID                                  POSITION
    ********* ==================== =========================

    30020013  GARRET               TYPIST
    30016112  TAILOR               WAREHOUSEMAN
    20017600  PIETSCH              SECRETARY

## Spaltenüberschriften unterdrücken — die Schrägstrich-Notation (’/’)

Mit der Notation Apostroph-Schrägstrich-Apostroph (`'/'`) können Sie die Ausgabe von Standard-Spaltenüberschriften für einzelne Felder in einem `DISPLAY`-Statement unterdrücken.

Im Gegensatz zur `NOHDR`-Option, mit der Sie die Ausgabe von Standard-Spaltenüberschriften für alle Spalten unterdrücken können, können Sie mit der `'/'`-Notation die Überschrift für eine einzelne Spalte unterdrücken.

Dazu geben Sie die Notation `'/'` in einem `DISPLAY`-Statement jeweils unmittelbar vor dem Namen des Feldes an, dessen Spaltenüberschrift unterdrückt werden soll.

Zwei Beispiele zum Vergleich:

#### Beispiel 1:

    DISPLAY NAME PERSONNEL-ID JOB-TITLE

In diesem Beispiel werden die Standardüberschriften aller drei Spalten ausgegeben:

    Page      1                                                  04-11-11  14:15:54

            NAME         PERSONNEL          CURRENT
                              ID             POSITION
    -------------------- --------- -------------------------

    ABELLAN              60008339  MAQUINISTA
    ACHIESON             30000231  DATA BASE ADMINISTRATOR
    ADAM                 50005800  CHEF DE SERVICE
    ADKINSON             20008800  PROGRAMMER
    ADKINSON             20009800  DBA
    ADKINSON             20011000  SALES PERSON

#### Beispiel 2:

    DISPLAY '/' NAME PERSONNEL-ID JOB-TITLE

In diesem Beispiel wird mit der Notation `'/'` die Spaltenüberschrift für das Feld `NAME` unterdrückt:

    Page      1                                                  04-11-11  14:15:54

                         PERSONNEL          CURRENT
                            ID             POSITION
                         --------- -------------------------

    ABELLAN              60008339  MAQUINISTA
    ACHIESON             30000231  DATA BASE ADMINISTRATOR
    ADAM                 50005800  CHEF DE SERVICE
    ADKINSON             20008800  PROGRAMMER
    ADKINSON             20009800  DBA
    ADKINSON             20011000  SALES PERSON

## Weitere Beispiele für Spaltenüberschriften

Siehe die folgenden Beispiel-Programme:

- DISPLX15 − DISPLAY-Statement (mit FC, UC)

- DISPLX16 − DISPLAY-Statement (mit '/', 'text', 'text/text')

### On this page

- Standard-Spaltenüberschriften
- Standard-Spaltenüberschriften unterdrücken — die NOHDR-Option
- Eigene Spaltenüberschriften definieren
- NOTITLE und NOHDR kombinieren
- Spaltenüberschriften zentrieren — der HC-Parameter
- Breite von Spaltenüberschriften — der HW-Parameter
- Füllzeichen für Überschriften — die Parameter FC und GC
- Unterstreichungszeichen für Überschriften — der UC-Parameter
- Spaltenüberschriften unterdrücken — die Schrägstrich-Notation (’/’)
- Weitere Beispiele für Spaltenüberschriften