New Functions in the SAPscript Editor in Release 3.0

Description

Context-related insert mode

F5 (Insert) branches to the insert mode

A free text area (3 - 9 lines, depending on the SAPGUI size) is displayed at the current cursor position into which you can insert text. The text before and after the insert position still remains visible in this case. The end of the inserted line area is displayed by the system format '..' in the tag column.

By pressing ENTER (New paragraph), F6 (New line), F7 (Format), F8 (New page), the inserted line area is simply moved down on the screen. Thus, you still remain in the insert mode.

F5 (Exit) exits the insert mode. The text which stands at the '..' line format is appended to the inserted text. The following rule applies concerning a blank at the end: If you position the cursor directly behind the last character of the inserted text not including blanks, no blank is inserted. Otherwise, exactly one character is inserted as word separator.

F5 (Insert) and cursor positioned in the tag column inserts the free text area before the cursor row

Symbols

The list of possible program symbols for this text object or text ID (menu option: Include - Symbols - Program)

You can specify options for the processing type of the symbols via dialog boxes (menu option: Include - symbols - ... )

Raw line formats '(' and '/('

A raw line has the same effect as an extended line. (see also F1 help in the tag column: Double-click on hypertext chapter Raw line)
Furthermore, all characters which have a control function in the text line are of the editor ( <..> &..& ,, ) are displayed as (raw) characters and are not interpreted for the control.

Including different sessions (X, Y, Z session from the ABAP/4 line editor, general clipboard)

Menu option 'Include - Session - Clipboard (line editor)

Inserts the Cut & Paste - Clipboard contents or the ABAP/4 X, Y, Z session contents in the raw line format at the current cursor position.

Scrollbar

This only refers to the available text. That is, the blank lines at end of the text are appended automatically and do not influence the size of the scrollbar. Thus, if you pull down the scrollbar to the very end, blank lines are added to the text entry.

Possible entries pushbutton (F4) in tag column

F4 in the tag column displays a dialog box with the line and paragraph formats which can be used according to the assigned style or the assigned form.

Improved selection of character strings, paragraphs, lines, pages

In the normal change mode, menu command format - character (paragraph, line, page) marks the current word (paragraph, line, page).

The selected part is marked in the select mode (after pressing F2) as before.

Unchangeable header lines

The text structure is already submitted to the user when calling the editor by means of unchangeable header lines (for example, note: symptom, cause, solution or entire action log). He can insert, add or delete text between these headers. However, the headers themselves cannot be deleted.

In the program, the header lines are transferred by means of '>x' in the tag column of the line table of function module EDIT_TEXT (x here can be any character for differentiating between the individual headers).

New commands to paint frames, lines and shading in forms

Description

In SAPscript text commands to paint frames, lines, and shading have been implemented in 3.0A. You can set parameters to define the position, size, frame and shading. Within one form you can thus output individual windows or text sections within a window with frames or shading.

The SAP printer drivers based on page printers (HP Laserjet driver, Postscript driver, Kyocera-Prescribe driver) convert these commands during output. All other line printers or page printers not supported in the standard version ignore these commands.
This print output can be displayed in the SAPscript previewer (30A: UNIX-Motif , 30B: WINDOWS, WINDOWS-NT).

Defining frames in a form

The following new text commands are available:

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

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

Effect

Paints a box with the specified size at the specified position.

Additions

XPOS, YPOS, WIDTH, HEIGHT and FRAME always require that you enter a measurement/unit of measurement. The addition INTENSITY requires that you enter a percentage between 0 and 100.

XPOS, YPOS
Upper left corner of the box relative to the values from the POSITION command.
Default: Values from the POSITION command

Internally the following calculation rule applies to determine the absolute output position of a box on a page:
X(abs) = XORIGIN + XPOS
Y(abs) = YORIGIN + YPOS

WIDTH
Box width
Default: WIDTH value from SIZE command

HEIGHT
Box height
Default: HEIGHT value from SIZE command

FRAME
Frame width
Default: 0 (no frame)

INTENSITY
Density of shading for box content in %
Default: 100 (black; solid shading)

Measurements

Decimal measurements must be enclosed in inverted commas (like ABAP/4 numeric constants). The decimal point must be used. Examples:

Unit

Allowed units of measurement: TW (twip), PT (point), IN (inch), MM (millimeter), CM (centimeter), LN (line), CH (character). Conversion:
1 TW = 1/20 PT
1 PT = 1/72 IN
1 IN = 2.54 CM
1 CM = 10 MM
1 CH = character height from form header (CPI)
1 LN = line height from form header (LPI)

Examples

/: BOX FRAME 10 TW

Paints a frame around the current window (frame width 10 TW (= 0.5 PT)

/: BOX INTENSITY 10

Applies grey shading to the window background (density 10 %)

/: BOX HEIGHT 0 TW FRAME 10 TW

Paints a horizontal line at the upper margin over the complete box width

/: BOX WIDTH 0 TW FRAME 10 TW

Paints a vertical line at the left margin over the complete box width

/: 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

Paints a rectangle and two lines to build up a three-column table with emphasized heading

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

Effect

Determines the origin of the coordinate system for the parameters XPOS and YPOS from the BOX command. When a window is started,the POSITION value is set to the upper left corner of the box (default setting).

Additions

If a parameter value has no sign, it is considered as an absolute value, i.e., the values relate to the upper left corner of the output page. If a parameter value has a sign, the new parameter value is calculated relative to the old one. If a parameter is missing,the current parameter value remains unchanged.

XORIGIN, YORIGIN
Origin of the coordinate system

WINDOW
Sets the values for the left and upper margin to the values of the current window (default)

PAGE
Sets the values for the left and upper margin to the values of the current output page (XORIGIN = 0 cm, YORIGIN = 0 cm)

Examples

/: POSITION WINDOW

Sets the coordinate origin to the upper left corner of the window

/: POSITION XORIGIN 2 CM YORIGIN '2.5 CM'

Sets the coordinate origin to 2 cm starting from the left margin of the page and 2.5 CM starting from the upper margin

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

Moves the upper left coordinate origin 1,5cm to the left and 1cm up

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

Effect

Determines the values for the parameters WIDTH and HEIGHT from the BOX command. When a window is started, the SIZE value is set to the values for this window (default).

Additions

If a parameter is missing for the command, the current parameter value remains unchanged. If a parameter value does not have any sign, its value is considered to be an absolute value. If the parameter value contains a sign, the new value of this parameter is considered relative to the old value.

WIDTH, HEIGHT
Dimension of the rectangle or line

WINDOW
Sets the values for width and height to the values of the current window (default)

PAGE
Sets the values for the width and height to the values of the current output page

Examples

/: SIZE WINDOW

Sets WIDTH and HEIGHT to the window dimension

/: 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 applied to the current window. The frame goes beyond the window dimensions in order that the first and lasts text characters are not overwritten.

Changes to the interface

See description.

Changes in procedure

See description.