WRITE
[(rep)] TITLE
[LEFT [JUSTIFIED ]] [UNDERLINED ]
|
||||||||
[(statement-parameters)] | ||||||||
nX
|
'text' [(attributes)] | |||||||
nT
|
'c'( n ) [(attributes)] | |||||||
x/y | ['='] operand1 [(parameters)] | |||||||
[SKIP
operand2 [LINES ]]
|
Dieses Dokument behandelt folgende Themen:
Eine Erläuterung der in dem Syntax-Diagramm verwendeten Symbole entnehmen Sie dem Abschnitt Syntax-Symbole.
Verwandte Statements: AT END OF PAGE | AT TOP OF PAGE | CLOSE PRINTER | DEFINE PRINTER | DISPLAY | EJECT | FORMAT | NEWPAGE | PRINT | SKIP | SUSPEND IDENTICAL SUPPRESS | WRITE | WRITE TRAILER
Gehört zur Funktionsgruppe: Erstellen von Ausgabe-Reports
Das Statement WRITE TITLE
dient dazu, statt einer
Standard-Kopfzeile eine eigene Seitenüberschrift auszugeben. Das Statement wird
immer dann ausgeführt, wenn eine neue Ausgabeseite initiiert wird.
Siehe auch die folgenden Abschnitte (im Leitfaden zur Programmierung):
Dieses Statement ist nicht-prozedural (das heißt, seine Ausführung hängt von einem Ereignis ab, nicht davon, wo im Programm es steht).
Wenn ein Report durch Statements in verschiedenen Objekten erzeugt
wird, wird das WRITE TITLE
-Statement nur ausgeführt, wenn es in
demselben Objekt steht wie das Statement, das die Ausgabe einer neuen Seite
auslöst.
WRITE TITLE
darf höchstens einmal pro Ausgabe-Report
verwendet werden.
WRITE TITLE
darf nicht an eine logische Bedingung
geknüpft sein.
WRITE TITLE
darf nicht in einer Subroutine stehen.
Operanden-Definitionstabelle:
Operand | Mögliche Struktur | Mögliche Formate | Referenzierung erlaubt | Dynam. Definition | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
operand1 | S | A | G | N | A | U | N | P | I | F | B | D | T | L | G | O | ja | nein | ||
operand2 | C | S | N | P | I | B | ja | nein |
Syntax-Element-Beschreibung:
(rep) |
Report-Spezifikation:
Erzeugt ein Programm mehrere Reports, kann mit der
Notation
Es kann ein Wert von 0 bis 31 oder ein logischer Name, der mit
einem Wenn Informationen, wie Sie das Format eines mit Natural erstellten Ausgabe-Reports steuern, finden Sie im Abschnitt Steuerung der Ausgabe von Daten im Leitfaden zur Programmierung. |
---|---|
Kopfzeilenausrichtung und
Unterstreichung:
Normalerweise werden Seitenkopfzeilen zentriert und ohne Unterstreichung ausgegeben. Eine linksbündige Ausrichtung der Kopfzeile erreichen Sie durch
Angabe des Schlüsselwortes Eine unterstrichene Kopfzeile erhalten Sie durch Angabe des
Schlüsselwortes Bevor die Zeile zentriert wird, führt Natural erst alle
Leerstellen- und Tabulatoranweisungen aus. Bei einer Tabulator-Notation von
|
|
statement-parameters |
Parameter-Definition auf
Statement-Ebene:
Unmittelbar nach dem Wenn Sie mehrere Parameter angeben, müssen Sie sie durch ein oder mehrere Leerzeichen voneinander trennen. Eine einzelne Parameterangabe darf sich nicht über zwei Sourcecode-Zeilen erstrecken. Anmerkung: Informationen zur Benutzung der Parameter, siehe
Liste der
Parameter (beim |
Format-Notation und
Abstandselemente:
Siehe Format-Notation und Abstandselemente (weiter unten). |
|
Text/Attribut-Zuweisung:
Siehe Text/Attribut-Zuweisungen (weiter unten). |
|
operand1 |
In der Überschrift anzuzeigendes
Feld:
Als operand1 können Sie ein oder mehrere Feld/er angeben, die in der Kopfzeile ausgegeben werden sollen. Arrays mit Bereichen, die es ermöglichen, die Anzahl der Ausprägungen zur Ausführungszeit zu variieren, können nicht angegeben werden. |
parameters |
Parameter-Definition auf
Element-Ebene:
Ein einzelner oder mehrere in Anführungszeichen stehende Parameter
kann/können auf Element-Ebene unmittelbar hinter
operand1 angegeben werden. Jeder auf diese Art
angegebene Parameter überschreibt den entsprechenden, vorher auf
Statement-Ebene oder in einem Wenn mehr als ein Parameter angegeben wird, müssen ein oder mehr Leerzeichen zwischen jedem Eintrag stehen. Eine einzelne Parameterangabe darf sich nicht über zwei Sourcecode-Zeilen erstrecken. Informationen zur Benutzung der Parameter siehe
Liste der
Parameter (beim |
SKIP operand2 LINES |
Einfügen von Leerzeilen nach der
Kopfzeile:
Mit der Anmerkung: |
nX |
Spaltenabstand:
Mit dieser Notation fügen Sie
|
---|---|
nT |
Setzen der Tabulatoren:
Die Notation Eine Spalte, die in derselben Ausgabezeile bereits belegt ist, darf nicht angegeben werden. |
x/y |
x/y-Positionierung:
Mit dieser Notation erreichen Sie, dass ein Feld
x Zeilen unter der Ausgabe des letzten Statements,
und zwar ab Spalte Eine Spalte, die in derselben Ausgabezeile bereits belegt ist, darf nicht angegeben werden. |
'text' |
Text-Zuweisung:
Es wird die in Apostrophen stehende Zeichenkette angezeigt. |
---|---|
'c'(n) |
Zeichen-Wiederholung:
Das in Apostrophen stehende Zeichen (character)wird unmittelbar vor dem Feldwert n mal angezeigt. |
attributes |
Felddarstellung und Farbattribute:
Es ist möglich, verschiedene Attribute für die Text/Feldanzeige zuzuweisen. Diese Attribute und die Syntax, die benutzt werden kann, sind im Abschnitt Ausgabeattribute weiter unten beschrieben. Beispiele: WRITE TITLE 'TEXT' (BGR) WRITE TITLE 'TEXT' (B) WRITE TITLE 'TEXT' (BBLC) |
attributes gibt die für die Text-Anzeige zu benutzenden Ausgabe-Attribute an. Es gibt die folgenden Attribute:
|
||||
AD-value
|
Die möglichen Parameterwerte sind in der Parameter-Referenz aufgeführt.
AD - Attribute Definition, Abschnitt Feldanzeige
Anmerkung:
Der Compiler akzeptiert tatsächlich mehr als ein Attributwert für
ein Ausgabefeld. Zum Beispiel können Sie Folgendes angeben:
AD=BDI
. In solch einem Fall gilt allerdings nur der letzte Wert.
Im hier gezeigten Beispiel erhält nur der Wert I
Gültigkeit, und
das Ausgabefeld wird intensiviert (hell hervorgehoben) angezeigt.
** Example 'WTIEX1': WRITE (with TITLE option) ************************************************************************ DEFINE DATA LOCAL 1 EMPL-VIEW VIEW OF EMPLOYEES 2 NAME 2 FIRST-NAME 2 CITY 2 JOB-TITLE END-DEFINE * * FORMAT LS=70 * WRITE TITLE LEFT JUSTIFIED UNDERLINED *TIME 3X 'PEOPLE LIVING IN NEW YORK CITY' 11X 'PAGE:' *PAGE-NUMBER SKIP 1 * FIND EMPL-VIEW WITH CITY = 'NEW YORK' DISPLAY NAME FIRST-NAME 3X JOB-TITLE END-FIND END
Ausgabe des Programms WTIEX1
:
09:33:16.5 PEOPLE LIVING IN NEW YORK CITY PAGE: 1 --------------------------------------------------------------------- NAME FIRST-NAME CURRENT POSITION -------------------- -------------------- ------------------------- RUBIN SYLVIA SECRETARY WALLACE MARY ANALYST