FONT Statement

Syntax:

  FONT font-id  [load-option] [mem-option] [codepage]  filename

The FONT statement defines a font resource for an application. A font resource, typically created by using the OS/2 Font Editor, is a bit map defining the shape of the individual characters in a character set. The FONT statement copies the font resource from the file specified in the filename field and adds it to the other resources of the application. A font resource can be loaded from the executable file when needed by using the GpiLoadFonts function.

You can provide any number of FONT statements in a resource script file, but each statement must specify a unique font-id value.

font-id

Specifies the font-resource identifier. This value must be an unsigned integer in the range of 1 through 65535, or a simple expression that evaluates to a value in these ranges. Character strings cannot be used as resource identifiers for this statement.
load-option
Specifies when the system loads the resource from the executable file into memory. This value must be one of the following: PRELOAD
System loads the resource when the application starts.
LOADONCALL
System loads the resource when the application calls the GpiLoadFonts function. This is the default option.
mem-option
Specifies how the system manages the resource when it is i memory. This value must be one or more of the following: FIXED
System keeps the resource at a fixed memory location.
MOVEABLE
System moves the resource as necessary to compact memory.
DISCARDABLE
System discards the resource if it is no longer needed. The default setting is MOVEABLE and DISCARDABLE.
codepage
Specifies a code page value. For a list of valid code pages see CODEPAGE Statement.
filename
Specifies the name of the file containing the font resource. If the file is not in the current directory, filename must be preceded by a full path.

Example

This example defines a font whose font identifier is 5. The font resource is copied from the file cmroman.fon.

FONT 5 cmroman.fon

---

[Back: ENTRYFIELD Statement]
[Next: FRAME Statement]