Deck- und Zwischenblätter

<< Click to Display Table of Contents >>

Navigation:  Datenauswertung > Tabellengestaltung >

Deck- und Zwischenblätter

Die Befehle TITLEPAGE und CHAPTERPAGE dienen dem Einfügen von Titel- bzw. Zwischenseiten in PostScript- bzw. PDF-Tabellenbänden.

Beide Statements funktionieren in der Darstellung identisch. Unterscheiden tun sie sich in der Positionierung der Seiten.

Siehe hier für die Syntax und ein Anwendungsbeispiel.


Syntax

Alle TITLEPAGEs werden vor allen anderen Seiten des Tabellenbandes ausgegeben, also vor einem eventuellen Inhaltsverzeichnis und auch vor einer PROTOCOLPAGE. Sie gehören auch nicht in den Nummernkreis der PAGENUMBERs.

CHAPTERPAGEs werden hinter den Tabellen eingefügt, hinter denen das CHAPTERPAGE-Statement steht.

Syntax:

TITLEPAGE ::= { | element }*n ;
CHAPTERPAGE::= { | element }*n ;

element ::= { text | line | drawbox | titlebox | eps }

text ::= TEXT { textoption }*n x y <text>
textoption ::= : [ font | color ]
font ::= USEFONT <fontname> SIZE <number>
color ::= FOREGROUND <gesscolor>

line ::= LINE { lineoption }*n x1 y1 x2 y2
lineoption ::= : [ width | color ]

drawbox ::= DRAWBOX { boxoption }*n x1 y1 x2 y2
boxoption ::= : [ linewidth | color | background ]

TitleBox ::= TITLEBOX { boxoption2 }*n x1 y1 x2 y2 text <text>
boxoption ::= : [ width | linewidth | color | background ]

eps ::= EPS <filename> x y [ WIDTH ] 

width ::= WIDTH <number>
background ::= BACKGROUND <gesscolor>
foreground ::= FOREGROUND <gesscolor>
gesscolor ::= <red> <green> <blue> | $RRGGBB
<red> <red> <green> <blue> ::= number, range 0.0..1.0

Die positionierbaren Elemente heißen TITLEBOX, DRAWBOX, LINE, TEXT oder EPS. Alle Maße (Breite, Höhe) und X/Y-Koordinaten werden in typografischen Punkten angegeben.

Das komplexeste (und wohl am häufigsten verwendete) Element ist TITLEBOX. Es definiert ein Rechteck, das eine Umrandung in einer gewünschten Farbe haben kann, eine Hintergrundfarbe, und mit einem Text in einem auszuwählenden Font gefüllt werden kann. Hierbei stehen verschiedene Methoden der Textanordnung zur Verfügung: vertikal/horizontal zentriert, linksbündig, rechtsbündig etc.

Optionen werden immer mit einem Doppelpunkt eingeleitet.

Eine TITLEBOX kennt folgende Optionen:

WIDTH

Die Breite der TITLEBOX

BACKGROUND 

Hintergrundfarbe

FOREGROUND 

Vordergrundfarbe. Das ist hier der Rahmen.

COLOR 

Schriftfarbe

LINEWIDTH 

Die Dicke des Umrandungsstrichs. 0.0 = keine Umrandung.

USEFONT 

Der zu verwendende Font

LEFT | RIGHT | HCENTER 

Horizontale Ausrichtung des Textes

TOP | BOTTOM | VCENTER 

Vertikale Ausrichtung des Textes

Jede dieser Optionen hat eine eigene Syntax: Nach einer USEFONT-Option z.B. müssen Name und Größe eines gültigen Fonts stehen, nach dem Schlüsselwort LINEWIDTH muss zwingend eine Zahl stehen usw..

Findet die Software keine mit ':' eingeleiteten Optionen (mehr), werden nacheinander folgende Angaben erwartet: die Koordinaten der linken unteren Ecke, das Schlüsselwort TEXT, und dann der Text selbst.

Zur Angabe der Koordinaten: In PostScript und PDF gibt es ein Koordinatensystem, bei dem die linke untere Ecke die Koordinaten (0,0 ) hat. Soll beispielsweise die linke untere Ecke unserer TITLEBOX 50pt vom linken Rand und 550pt von der unteren Seitenkante entfernt sein, lautet die Angabe: 50 500.

Hinter dem Schlüsselwort TEXT steht der Text selbst, dieser wird anhand der Breite der TITLEBOX umgebrochen. Trennzeichen (Default: ~) werden berücksichtigt.

Alle Textelemente in einer TITLEBOX haben dieselbe Farbe und einen einheitlichen Font. Benötigt man hier mehr Kontrolle im Einzelnen, dann gibt es die Möglichkeit, den Kasten und die Text einzeln zu spezifizieren. Hierfür gibt es die Elemente DRAWBOX und TEXT.

Die Optionen zu DRAWBOX:

BACKGROUND

Hintergrundfarbe

FOREGROUND

Vordergrundfarbe. Das ist hier der Rahmen.

LINEWIDTH

Die Dicke des Umrandungsstrichs. 0.0 = keine Umrandung.

Die Position der DRAWBOX wird in den X/Y-Koordinaten der linken unteren und der rechten oberen Ecke angegeben.

Die Optionen zu TEXT:

COLOR/ FOREGROUND

Schriftfarbe (FOREGROUND wird hier als synonym akzeptiert.)

USEFONT

Der zu verwendende Font

Die Position der linken unteren Ecke des Textes wird als X/Y-Koordinaten angegeben.

Die Optionen zu LINE:

COLOR

Linienfarbe

LINEWIDTH

Die Dicke der Linie in typographischen Punkten

Die Koordinaten der Linie werden als Anfangs- und Endpunkt angegeben.

Die Optionen zu EPS:

Es wird der gültige Name einer Datei mit der EPS-Graphik erwartet, und anschließend die Koordinaten der linken unteren Ecke.
Es wird eine dritte Zahlenangabe erwartet: die Größe der Abbildung.


Anwendungsbeispiel

TITLEPAGE =

| TITLEBOX :WIDTH 470 :LEFT 10 :VCENTER :USEFONT "Helvetica-Bold" SIZE 42 
:BACKGROUND $AAFFDD :COLOR $FF0000 :FOREGROUND $000000 :LINEWIDTH 0.5 50 550

TEXT "Stickoxide und Kaufentscheidungen" 

| DRAWBOX :LINEWIDTH 0.5 :FOREGROUND $000000 :BACKGROUND $FFDDAA 100 300 500 200

| TEXT :USEFONT "Helvetica-Bold" SIZE 13 : COLOR $FF0000 110 277

"Bestimmnungsgründe des Konsums von Dieselfahrzeugen" 

| LINE :LINEWIDTH 2 :COLOR $FF0000 100 75 400 75

| TEXT :USEFONT Helvetica SIZE 12 :COLOR $0303AA 110 235

"Untersuchungsgebiet: Deutschland" 

| TEXT :USEFONT Helvetica SIZE 13 :COLOR $BB0303 110 215

"Methode: CATI (n=1002)" 

| EPS "220px-Exhaust.eps" 500 10 50

;

Titelseite mit TITLEPAGE

Titelseite mit TITLEPAGE