Function: choosefont( )

Syntax

choosefont {<title> {,<font>}}

Type

string

Returns

Enables the operator to select a font name via an interactive "Font Select" window. When this function is invoked, a font selection popup dialog window is displayed and the user can display samples of fonts and choose one. The fonts displayed by this window are not Fire fonts but external "system" fonts available within the current windowing system. On Windows systems, only TrueType fonts are listed. Fire software fonts are not included in the list.

Parameters

<title>
A string value providing a title for the font selection dialog window. If this is omitted or an empty string value, the text Font Selection will be used. Note that this directive may be ignored on some systems (e.g. Windows).
<font>
A font value providing an initial default. Note this is a font identifier, not a font descriptive name.

Notes

The value returned by this function is the name of the chosen font, suitable for the subsequent definition of a Fire font. The font is selected by pressing the ’OK’ or ’Select’ button in the popup window.

Pressing the ’Cancel’ button will abort the operation and return an empty string.

The position of the dialog window is determined by the value of menu_position.

No action is done to the selected font. This is the responsibility of the caller. Typically a Fire font would be created from the result.

The system numeric identifier found is set by this function. It gets set to true on a successful font selection, or false on dialog cancel or error.

Example

string fname = choosefont
if (fname) {
    font myfont,fname,-sys
}