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.

See also

CONTROL SET FONT, Dynamic Dialog Tools, DIALOG NEW, DIALOG SET COLOR, FONT END, FONT NEW, GRAPHIC SET FONT, XPRINT SET FONT