overfont Parameter

Sets font overlay lines.

Scope: View

Syntax

query overfont.n 
set overfont.n [String] 

Options

n 
The line on the screen for which the fonts are to be set. A positive value is counted from the top of the view, while a negative value is counted from the bottom of the view. The value and sign used must be the same as in a previous set overlay command.
String 
A numeric string in which each digit identifies a font. Digits 1 through 9 can be used.

Description

The overfont.n parameter sets the fonts explicitly for the overlay that appears on line n of the view. The String parameter is a numeric string in which each digit sets the font for the corresponding position on the window. These digits (1 through 9) refer to fonts previously defined by the set font.n command. When the set overfont command is issued, the current definition of these fonts is saved and the definition is used when the overlay line is built on the screen. These fonts can be reset with the set font.x command without affecting the appearance of the overlay line, unless another set overfont command is issued.

Programs can set up overlay lines using the nine fonts without interference from other programs setting up overlay lines at different times. The set font.x command only modifies the color attributes specified. All attributes should be fully specified when you set the numeric fonts for use in an overlay line, because the appearance of the font depends set font.x commands. If String is omitted, the font set by font overlay is used. If String is shorter than the overlay lines, font overlay is used for the remaining positions.

Example

To set the fonts for the overlay that appears on the fifth line of the view, type:

set overfont.5 eeeeeeeeeeeeeeee 

API Return Codes

-2 
Option is not valid.

overlay Parameter
font Parameter