DIALOG FONT statement

Purpose

Specify the default DDT font information.

Syntax

DIALOG FONT [DEFAULT] fontname$ [,points&, style&, charset&]

fontname$

Name of the font.

points&

Size of the font, in points.

style&

Font style attribute.

0	Normal
2	Italic

charset&

CharSet identifier.

0	ANSI CharSet
1	Default CharSet
2	Symbol CharSet
77	Mac CharSet
128	Shiftjis CharSet
129	Hangeul CharSet
130	Johab CharSet
136	Chinese CharSet
161	Greek CharSet
162	Turkish CharSet
177	Hebrew CharSet
178	Arabic CharSet
186	Baltic CharSet
204	Russian CharSet
222	Thai CharSet
238	East Europe CharSet
255	OEM CharSet

Remarks

The DIALOG FONT statement specifies the font which will be used for all subsequent dialogs created with DIALOG NEW, until another DIALOG FONT statement is executed. When a DIALOG NEW statement is executed, the selected default font is associated with it, and its child controls, for the lifetime of the dialog.

We recommend that the optional descriptor word DEFAULT be included, to aid in documenting your source code. The word DEFAULT may become mandatory in future versions of PowerBASIC.

If the requested font is not available on the computer, Windows will search for a substitute font, which is as similar as possible.

You may use the value zero (0) for any of the numeric parameters to designate that the compiler should use the default for that item. If parameter(s) are missing, the compiler substitutes the default value for all remaining parameters.

If no DIALOG FONT DEFAULT statement is executed, the default font is MS Sans Serif, 8 point, with no style attributes.

When specifying a font, care should be exercised to use a standard font that is available in all versions of Windows, such as "Arial", "Courier", "Times New Roman", "MS Sans Serif", etc. Specifying a font name that is not available forces Windows to substitute a font that may not be visually appealing, and may also alter the relative size of the dialog.

DIALOG FONT is module-specific. That is, a DIALOG FONT statement only affects subsequent dialogs created by code in the same EXE or DLL as the DIALOG FONT statement appears. For example, a DIALOG FONT statement in a DLL, will not affect dialogs created in the calling EXE or other DLLs loaded by the EXE. The DIALOG FONT statement is thread -safe.