Back|Forward

DCL:GRPH1:SLPACK: Layout Routines:Explanation of Main Subroutines

4.3.7 SLSTTL

1.

Function

Sets the text to write on the top or bottom margin of a level-1 frame.

2.

Call

CALL SLSTTL(CTTL,CSIDE,PX,PY,HT,NT)

3.

Explanation of Parameters

CTTL	(C((*))	The text. The following predefined variables exist, which are replaced by the corresponding text.
		'#PAGE'	:Page number. Takes up two character spaces in Arabic numbers.
		'#DATE'	:The date the program was executed. Displayed in YY/MM/DD format. (TY: year; MM: month; DD: Day)
		'#TIME'	:The time the program was executed. Displayed in HH:MM:SS format. (HH: hour; MM: minute; SS: second)
CSIDE	(C*)	The position of the text. Specify 'T'op (top margin) or 'B'ottom (bottom margin)
PX, PY	(R)	The position of the text in the margin specified by a floating-point value between -1.0 and +1.0.
		PX is
		-1.0	Left aligned
		1.0	:Centered
		+1.0	:Right aligned
		PYについては，
		-1.0	:Base aligned
		1.0	:Centered
		+1.0	:Top aligned
HT	(R)	The character height specified in units in RC.
NT	(I)	Specifies the order of text. (nth text)

4.

Notes

(a)

This routine only sets the text. The actual routine that writes the text is SLPTTL. The SLPTTL is called internally in SGFRM (See Section 2.4.2), so the user does not have to call SLPTTL directly.  Also, the SLPCNR draws corner marks in the 4 corners of the maximum frame at the same time. Unlike other routines in the SGPACK, the SLSTTL can be called after SGFRM. Therefore, different titles can be given to different pages. Corner marks will not be displayed when the internal variable 'LCORNER' handled by SGpGET/SGpSET is changed to .FALSE.. (The initial value is  .TRUE..). Also, the title is not displayed when 'LTITLE' is changed to .FALSE.. (The initial value is .TRUE..)

(b)

The maximum number of character strings that can be set is 5.

(c)

To nullify the NTth settings,

CALL SLDTTL(NT).