The fields of WFONT-DATA are used as follows:
| WFONT-DEVICE | This item identifies the device that a font is associated with. When a font is associated with a particular device, it should not be used on another device, because these results are undefined. Under Windows, fonts can be shared between devices, but the size is incorrect, because Windows fonts are internally stored with their sizes represented in pixels/device-units instead of points. For example, using a screen font that is 15 pixels high on a laser printer (with 300 or 600 dpi) produces tiny letters. All settings of WFONT-DEVICE are machine-dependent except for the following: |
| WFDEVICE-CONSOLE | This setting (default value "NULL") associates the font with the user's screen. |
| WFDEVICE-WIN-PRINTER | This setting (default value "1") is meaningful only under Windows systems. It associates the font with the currently selected printer for the Windows spooler. If you are using WIN$PRINTER, this item must be set to "true" before you call W$FONT. |
| WFONT-NAME | This item holds the face name of the font. This name is case-sensitive and may contain internal spaces. When asking for a font, you must match its name exactly. If this item is set to spaces, then any font is allowed to match. Under Windows, some common True Type font names are "Courier New", "Times New Roman", and "Arial". |
| WFONT-SIZE | This item holds the size, in points, of the font's characters. A value of zero allows for any size font. In that case, the size chosen by the system may or may not be useful. If you are not certain which size to choose, start with "10" and adjust from there. |
| WFONT-BOLD | When this item is set to TRUE, the font is a boldface font. |
| WFONT-ITALIC | When this item is set to TRUE, the font is italic. Note that under Windows, most controls have difficulty displaying italic fonts correctly. |
| WFONT-UNDERLINE | When this item is set to TRUE, the font is underlined. |
| WFONT-CHAR-SET | This item defines the character set to use. A font's character set includes the internal representations used for each character. The possible settings are as follows: |
| WFCHARSET-DONT-CARE | This allows for any character set. When returned by a call to WFONT-DESCRIBE-FONT, it indicates that the font's character set is unknown or does not correspond to one of the following settings. When requesting a specific font, use this setting only if you are certain that the face name you are requesting uses the character set you want. This may be necessary when you are asking for a font that uses a character set other than any of the following (as might be true for some oriental character sets). |
| WFCHARSET-DEFAULT | This setting corresponds to a host-dependent default character set. This is the character set most commonly used by the host system. Under Windows, this is the ANSI character set. If you are not certain which setting of WFONT-CHAR-SET to use, use this one. |
| WFCHARSET-WIN-OEM | This setting is meaningful only under Windows. It corresponds to the host hardware's "OEM" character set. For IBM-style PCs, this is the traditional MS-DOS character set. This is the same character set used by the built-in font "TRADITIONAL-FONT". |
| WFCHARSET-WIN-name | The following settings are meaningful only in a Windows environment. They correspond to various character sets supported by
Windows fonts (where name is the supported font name from the list below). You may select the character set directly in the
"script" portion of the font chooser dialog box. Note that most fonts only support a subset of these character sets.
|
| WFONT-STRIKEOUT | When this item is set to TRUE, the font is struck-out (i.e., has a line running horizontally through the middle of the characters). |
| WFONT-FIXED-PITCH | When this item is set to TRUE, the font is fixed-pitch. This means that each character in the font is the same width. |
| WFONT-FAMILY | This item describes the look of the font in very general terms. It is used to aid in selecting a font when WFONT-NAME is not specified or not found. No font is ever rejected because it does not match the requested family. Usually this field can be set to WFFAMILY-DONT-CARE, but specifying other choices can be useful when you don't know what fonts are on a system and you want to find one close to a specific font. Some graphical systems do not have the concept of font families. On these systems, the value of this field is ignored. The possible values of WFONT-FAMILY are: |
| WFFAMILY-DONT-CARE | This setting allows for any font family. When set by WFONT-DESCRIBE-FONT, it indicates that the font family is unknown or does not match any of the following possibilities. |
| WFFAMILY-MODERN | This setting indicates a font with a constant stroke width. These fonts are typically fixed-pitch, but need not be. Example fonts are "Courier" and "Elite". |
| WFFAMILY-ROMAN | This setting indicates a font with variable stroke width and serifs. Example fonts include "Times Roman" and "New Century Schoolbook". |
| WFFAMILY-SWISS | This setting indicates a font with variable stroke width and no serifs. Example fonts include "Helvetica" and "MS Sans Serif". |
| WFFAMILY-SCRIPT | This setting indicates a font designed to look like handwriting. Example fonts are "Script" and "Comic Sans MS". |
| WFFAMILY-DECORATIVE | This setting indicates a font for decorative or novelty purposes. "Old English" is an example of such a font. |
| WFONT-ANGLE | This item holds a value specifying the angle at which the font will print. The value can range from the default of "0", which
is the normal horizontal orientation, to "360", which is the same as "0". For example, to print at a 45-degree angle, set
WFONT-ANGLE to "45". To print upside down, set it to "180". Any font supported by the destination printer can be loaded with
this setting. This feature works only when printing a font, not when displaying a font on screen.
Note: You should use the WINPRINT-SET-CURSOR operation of W$PRINTER to set the position of the cursor prior to making a WRITE statement
using this feature.
|
| WFONT-CHOOSE-FLAGS | This item modifies the behavior of WFONT-CHOOSE-FONT based on the following settings. You can set any combination of these by adding together the corresponding values (all contained in "fonts.def"): |
| WFCHOOSE-FIXED-ONLY | This setting allows the user to select only a fixed-pitch font. Otherwise, any font can be chosen. |
| WFCHOOSE-INITIALIZE | This setting causes the various fields of the dialog box to be initialized based on the values contained in WFONT-FACE-DATA. Otherwise, the fields will have no initial value. |
| WFCHOOSE-EFFECTS-OK | This setting causes the special-effects section of the dialog box to appear. This section allows the user to select the following traits: underline, strike-out, and color. If it's not set, then this section does not appear in the dialog box. |
| WFCHOOSE-ANSI-ONLY | As Windows has evolved, the fonts listing in the W$FONT dialog no longer contains only ANSI fonts. While UNICODE fonts may
be used with ACUCOBOL-GT, using them relies on translation back and forth between locales, a process the COBOL programmer
has no means of influencing. For COBOL programmers who want to let their users have the liberty of selecting fonts, it is
therefore beneficial to limit the fonts to ANSI fonts only.
This setting allows the user to select only ANSI fonts. Otherwise any font can be chosen. This flag can be used in combination with any other flag value. Note that this flag is for use with the WFONT-CHOOSE-FONT operation only. Default value is off. Programmers must make an active choice, e.g. turn this flag on, to get the functionality. Prior to the call to W$FONT set the flag: MOVE WFCHOOSE-ANSI-ONLY TO WFONT-CHOOSE-FLAGS CALL "W$FONT" USING WFONT-CHOOSE-FONT, NULL, WFONT-DATA If you have used one of the other flags for WFONT-CHOOSE-FLAGS, you can combine it with this new setting by adding instead of moving: ADD WFCHOOSE-ANSI-ONLY TO WFONT-CHOOSE-FLAGS |
| WFONT-CHOOSE-MIN-SIZE | This item, when set to a positive value, specifies the minimum font size (in points) that the user can choose. |
| WFONT-CHOOSE-MAX-SIZE | This item, when set to a positive value, specifies the maximum font size (in points) that the user can choose. When it's set to zero, no maximum is established. |
| WFONT-CHOOSE-RED | This item is used only when the WFCHOOSE-EFFECTS-OK flag is set. It returns the red component of the color chosen. This is a number in the range of "0" to "255". See the W$PALETTE Routine for ways to use this value. On systems that do not support palettes, this value is always zero. |
| WFONT-CHOOSE-GREEN | This item is similar to WFONT-CHOOSE-RED, except it returns the green component of the color. |
| WFONT-CHOOSE-BLUE | This item is similar to WFONT-CHOOSE-RED, except it returns the blue component of the color. |
| WFONT-CHOOSE-COLOR-NUM | This item is used only when the WFCHOOSE-EFFECTS-OK flag is set. It returns the ACUCOBOL-GT color number (in the range of "1" to "16") if the color chosen by the user corresponds to a color in the current window's palette. If it does not, then this value is set to zero. Non-zero values can be used directly in the COLOR phrase of a screen item to get the correct color. |