Boxes, Lines, Shading: BOX, POSITION, SIZE

Procedure
Use the BOX, POSITION, and SIZE commands for drawing boxes, lines, and shading to print particular windows within a
form or passages of text within a window in a frame or with shading.
The SAP printer drivers that are based on page-oriented printers (the HP LaserJet driver HPL2, the Postscript driver
POST, the Kyocera Prescribe driver PRES) employ these commands when printing. Line printers and page-oriented
printers not supported in the standard ignore these commands. You can view the resulting printer output in the
SAPscript print preview.
1.
/: BOX [XPOS] [YPOS] [WIDTH] [HEIGHT] [FRAME] [INTENSITY]

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

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

2.
3.

BOX Command
BOX Command

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

Effect: draws a box of the specified size at the specified position.
Additions: For each of XPOS, YPOS, WIDTH, HEIGHT, and FRAME, you must specify both a measurement and a unit of
measurement. Specify the INTENSITY parameter as a percentage between 0 and 100.
1.
XPOS, YPOS: Upper left corner of the box, relative to the values of the POSITION command.
Default: Values specified in the POSITION command.
The following calculation is performed internally to determine the absolute output position of a box on the page:
X(abs) = XORIGIN + XPOS Y(abs) = YORIGIN + YPOS
2.
WIDTH: Width of the box. Default: WIDTH value of the SIZE command.
3.
HEIGHT: Height of the box. Default: HEIGHT value of the SIZE command.
4.
FRAME: Thickness of frame.
Default: 0 (no frame).
5.
INTENSITY: Grayscale of box contents as % .
Default: 100 (full black)
Measurements: You must specify decimal measurements as literal values (like ABAP numeric constants) by enclosing
them in quotation marks. Use the period as the decimal point character. See also the examples listed below.
Unit: The following units of measurement may be used:

TW (twip)

PT (point)

IN (inch)

MM (millimeter)

CM (centimeter)

LN (line)

CH (character)

The following conversion factors apply:

1 TW = 1/20 PT
1 PT = 1/72 IN
1 IN = 2.54 CM
1 CM = 10 MM
1 CH = height of a character relative to the CPI specification in the form header
1 LN = height of a line relative to the LPI specification in the form header

Example
/: BOX FRAME 10 TW
Draws a frame around the current window with a frame thickness of 10 TW (= 0.5 PT).

/: BOX INTENSITY 10
Fills the window background with shading having a grayscale of 10%.

/: BOX HEIGHT 0 TW FRAME 10 TW

Draws a horizontal line across the complete top edge of the window.

/: BOX WIDTH 0 TW FRAME 10 TW

Draws a vertical line along the complete height of the left hand edge of the window.

/:
/:
/:
/:

BOX
BOX
BOX
BOX

WIDTH '17.5' CM HEIGHT

WIDTH '17.5' CM HEIGHT
XPOS '10.0' CM WIDTH 0
XPOS '13.5' CM WIDTH 0

1 CM FRAME 10 TW INTENSITY 15
'13.5' CM FRAME 10 TW
TW HEIGHT '13.5' CM FRAME 10 TW
TW HEIGHT '13.5' CM FRAME 10 TW

Draws two rectangles and two lines to construct a table of three columns with a highlighted heading.
POSITION Command

POSITION Command

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

Effect: Sets the origin for the coordinate system used by the XPOS and YPOS parameters of the BOX command. When
a window is first started, the POSITION value is set to refer to the upper left corner of the window (default setting).
Additions: If a parameter value does not have a leading sign, then its value is interpreted as an absolute value, in
other words, as a value that specifies an offset from the upper left corner of the output page. If a parameter value is
specified with a leading sign, then the new value of the parameter is calculated relative to the old value. If one of the
parameter specifications is missing, then no change is made to this parameter.
1.
XORIGIN, YORIGIN: Origin of the coordinate system.
2.
WINDOW: Sets the values for the left and upper edges to match those of the current window (default setting).
3.
PAGE: Sets the values for the left and upper edges to match those of the current output page (XORIGIN = 0
cm, YORIGIN = 0 cm).

Example
/: POSITION WINDOW
Sets the origin for the coordinate system to the upper left corner of the window.

/: POSITION XORIGIN 2 CM YORIGIN '2.5 CM'

Sets the origin for the coordinate system to a point 2 cm from the left edge and 2.5 cm from the upper edge of the
output page.

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

Shifts the origin for the left upper coordinate 1.5 cm to the left and 1 cm up.
SIZE Command
SIZE Command

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

Effect: Sets the values of the WIDTH and HEIGHT parameters used in the BOX command. When a window is first
started, the SIZE value is set to the same values as the window itself (default setting).
Additions: If one of the parameter specifications is missing, then no change is made to the current value of this
parameter. If a parameter value does not have a leading sign, then its value is interpreted as an absolute value. If a
parameter value is specified with a leading sign, then the new value of the parameter is calculated relative to the old
value.
1.
WIDTH, HEIGHT: Dimensions of the rectangle or line.
2.
WINDOW: Sets the values for the width and height to the values of the current window (default setting).
3.
PAGE: Sets the values for the width and height to the values of the current output page.

Example
/: SIZE WINDOW
Sets WIDTH and HEIGHT to the current window dimensions.

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

Sets WIDTH to 3.5 cm and HEIGHT to 7.6 cm.

/:
/:
/:
/:

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

A frame is added to the current window. The edges of the frame extend beyond the edges of the window itself, so as
to avoid obscuring the leading and trailing text characters.