Putting text in a box

GDDM-PGF V2R1.3 OPS User's Guide

Putting text in a box

GDDM-PGF V2R1.3 OPS User's Guide
SC33-1776-00

Use the subcommand BOX to frame the text. Apart from the positional operands, it is identical to the primary BOX command (described in "Drawing boxes" in topic 2.5.10).

To make a simple frame, use:

text 'Words in a frame' 50 50% box

The box is drawn with the current attributes as described in "Line art" in topic 2.5.

The framing follows the outline of the character boxes of the text. However, you can adjust the size of the frame using one or two dimension values or scale factors with the BOX subcommand. The dimension values adjust the size in the direction of the text (normally horizontal); the scale factors adjust the size vertically. If you specify only one value, it applies to both directions.

You can specify an absolute box size using something like:

text 'A box' 30 30 box 40mm 20mm

You can also use a scale factor relative to the text size, using a unit of *. For example:

text 'Another box' 30 30 box 1.5*

creates a box 1.5 times as large as the text box in each direction. (The default size corresponds to scale factor 1.) See Figure 25 for illustrations.

__________________________________________________________________________________ | | | | | | | | |

| | | | | | | |__________________________________________________________________________________|

Figure 25. Text in simple boxes

You can omit * if the factor is less than the current text box. For example, if the current text height is 5, you can omit * for all scale factors below 5.

Note: You can refer to the current text height in the BOX subcommand, but, before doing so, specify any SIZE or HEIGHT subcommand. The TEXT command is scanned only once, from left to right, and any absolute box size is evaluated when it reaches BOX. Thus the following two commands may not give identical results:

text 'hello' 20 20 h 10, box 20 1.5t text 'hello' 20 20 box 20 1.5t, h 10

For more on the BOX command, see "Drawing boxes" in topic 2.5.10.

Notices | Terms of use | Support | Contact z/OS