Anfang des Inhaltsbereichs

Boxen, Linien, Schattierungen: BOX, POSITION, SIZE  Dokument im Navigationsbaum lokalisieren

Mit den Kommandos BOX, POSITION und SIZE zum Zeichnen von Boxen, Linien und Schattierungen können innerhalb eines Formulars einzelne Fenster oder bestimmte Textpassagen innerhalb eines Fensters umrahmt bzw. schattiert ausgegeben werden.

Die SAP-Druckertreiber, die auf Seitendruckern basieren (HP-LaserJet-Treiber HPL2, PostScript-Treiber POST, Kyocera-Prescribe-Treiber PRES) setzen diese Kommandos bei der Ausgabe um. Alle anderen Zeilendrucker bzw. nicht im Standard unterstützten Seitendrucker ignorieren diese Kommandos. In der SAPscript-Druckansicht ist diese Druckausgabe anzeigbar.

Syntax:

  1. /: BOX [XPOS] [YPOS] [WIDTH] [HEIGHT] [FRAME] [INTENSITY]
  2. /: POSITION [XORIGIN] [YORIGIN] [WINDOW] [PAGE]
  3. /: SIZE [WIDTH] [HEIGHT] [WINDOW] [PAGE]

BOX-Kommando

Syntax:

/: BOX [XPOS] [YPOS] [WIDTH] [HEIGHT] [FRAME] [INTENSITY]

Effekt: Zeichnet an die Position eine Box in der angegebenen Größe.

Zusätze: XPOS, YPOS, WIDTH, HEIGHT und FRAME erfordern immer die Angabe eines Maßes und einer Maßeinheit. Der Zusatz INTENSITY erfordert die Angabe einer Prozentzahl zwischen 0 und 100.

  1. XPOS, YPOS: Linke obere Ecke der Box, bezogen auf die Werte aus dem POSITION-Kommando.
  2. Standard: Werte aus POSITION-Kommando.

    Es gilt also intern folgende Berechnungsvorschrift zur Ermittlung der absoluten Ausgabeposition einer Box auf der Seite:
    X(abs) = XORIGIN + XPOS
    Y(abs) = YORIGIN + YPOS

  3. WIDTH: Breite der Box, Standard: WIDTH-Wert aus SIZE-Kommando
  4. HEIGHT: Höhe der Box, Standard: HEIGHT-Wert aus SIZE-Kommando
  5. FRAME: Rahmendicke
  6. Standard: 0 (keine Rahmenlinie)

  7. INTENSITY: Schwärzungsgrad des Boxinhalts in %

Standard: 100 (schwarz ausgefüllt)

Maße: Dezimalmaße müssen als Literale (wie ABAP-Zahlkonstanten) in Hochkommata eingeschlossen sein. Als Dezimalzeichen ist der Punkt zu verwenden. Siehe auch die folgenden Beispiele.

Einheit: Zulässige Maßeinheiten sind:

Es gelten dabei folgende Umrechnungen:

Beispiel

/: BOX FRAME 10 TW

Zeichnet einen Rahmen um das aktuelle Fenster mit der Rahmendicke
10 TW (= 0.5 PT).

/: BOX INTENSITY 10

Schattiert den Fensterhintergrund mit einem Schwärzungsgrad (Grauwert) von
10 %.

/: BOX HEIGHT 0 TW FRAME 10 TW

Zeichnet eine waagerechte Linie am oberen Fensterrand über die gesamte Fensterbreite.

/: BOX WIDTH 0 TW FRAME 10 TW

Zeichnet eine senkrechte Linie am linken Fensterrand über die gesamte Fensterhöhe.

/: BOX WIDTH '17.5' CM HEIGHT 1 CM FRAME 10 TW INTENSITY 15
/: BOX WIDTH '17.5' CM HEIGHT '13.5' CM FRAME 10 TW
/: BOX XPOS '10.0' CM WIDTH 0 TW HEIGHT '13.5' CM FRAME 10 TW
/: BOX XPOS '13.5' CM WIDTH 0 TW HEIGHT '13.5' CM FRAME 10 TW

Zeichnet zwei Rechtecke und zwei Linien zum Aufbau einer dreispaltigen Tabelle mit hervorgehobener Überschriftszeile.

POSITION-Kommando

Syntax:

/: POSITION [XORIGIN] [YORIGIN] [WINDOW] [PAGE]

Effekt: Bestimmt den Ursprung des Koordinatensystems für die Parameter XPOS und YPOS aus dem BOX-Kommando. Beim Start des Fensters wird der POSITION-Wert auf den oberen linken Eckpunkt des Fensters gesetzt (Standardeinstellung).

Zusätze: Enthält ein Parameterwert kein Vorzeichen, so wird sein Wert als absoluter Wert betrachtet, d.h., die Werte sind bezogen auf den linken oberen Eckpunkt der Ausgabeseite. Enthält ein Parameterwert ein Vorzeichen, so wird der neue Wert dieses Parameters relativ zum alten Wert berechnet. Fehlt ein Parameter, so wird der aktuelle Wert dieses Parameters nicht verändert.

  1. XORIGIN, YORIGIN: Ursprung des Koordinatensystems
  2. WINDOW: Setzt die Werte für den linken und oberen Rand auf die Werte des aktuellen Fensters (Standardeinstellung)
  3. PAGE: Setzt die Werte für den linken und oberen Rand auf die Werte der aktuellen Ausgabeseite (XORIGIN = 0 cm, YORIGIN = 0 cm)

Beispiel

/: POSITION WINDOW

Setzt den Koordinatenursprung auf den linken oberen Fenstereckpunkt.

/: POSITION XORIGIN 2 CM YORIGIN '2.5 CM'

Setzt den Koordinatenursprung auf 2 cm gemessen vom linken Seitenrand und 2,5 cm gemessen vom oberen Seitenrand.

/: POSITION XORIGIN '-1.5' CM YORIGIN -1 CM

Verschiebt den linken oberen Koordinatenursprung um 1,5 cm nach links und 1 cm nach oben.

SIZE-Kommando

Syntax:

/: SIZE [WIDTH] [HEIGHT] [WINDOW] [PAGE]

Effekt: Bestimmt die Werte für die Parameter WIDTH und HEIGHT aus dem BOX-Kommando. Beim Start eines Fensters wird der SIZE-Wert auf die entsprechenden Werte dieses Fensters gesetzt (Standardeinstellung).

Zusätze: Fehlt bei dem Kommando ein Parameter, so wird der aktuelle Wert dieses Parameters nicht verändert. Enthält ein Parameterwert kein Vorzeichen, so wird sein Wert als absoluter Wert betrachtet. Enthält ein Parameterwert ein Vorzeichen, so wird der neue Wert dieses Parameters relativ zum alten Wert berechnet.

  1. WIDTH, HEIGHT: Abmessungen des Rechtecks bzw. der Linie.
  2. WINDOW: Setzt die Werte für Breite und Höhe auf die entsprechenden Werte des aktuellen Fensters (Standardeinstellung).
  3. PAGE: Setzt die Werte für Breite und Höhe auf die entsprechenden Werte der aktuellen Ausgabeseite.

Beispiel

/: SIZE WINDOW

Setzt WIDTH und HEIGHT auf die Fensterabmessungen

/: SIZE WIDTH '3.5' CM HEIGHT '7.6' CM

Setzt WIDTH auf 3,5 cm und HEIGHT auf 7,6 cm

/: POSITION WINDOW
/: POSITION XORIGIN -20 TW YORIGIN -20 TW
/: SIZE WIDTH +40 TW HEIGHT +40 TW
/: BOX FRAME 10 TW

Das aktuelle Fenster wird umrahmt. Der Rahmen ragt dabei über den Fensteranfang hinaus, um die ersten und letzten Textzeichen nicht zu überschreiben.