GETFONT( ) Function
Displays the Font dialog box and returns information about the font you choose.
GETFONT([cFontName [, nFontSize [, cFontStyle [, nFontCharSet]]]])
Parameters
cFontName
Specifies the name of the font initially selected in the Font dialog box. If the font you specify is not installed, the default font is selected initially.nFontSize
Specifies the font size selected initially in the Font dialog box. If the font size you specify is not supported, the default font size is selected initially. If you omit nFontSize or if nFontSize is less than or equal to zero, the font size selected defaults to 10 point.Note
The dialog box permits you to select sizes between 4 and 127, inclusive. You can specify other values for nFontSize when calling the GETFONT function; no error occurs. If you do so, however, the user must select a size within the designated range of values before clicking OK in the dialog box. Otherwise, the dialog box displays an alert and does not accept the value.
cFontStyle
Specifies the font style selected initially in the Font dialog box or to display only those fonts available on the selected printer. If the font style you specify is not supported, the default font style is selected initially.The following table lists the values available for cFontStyle.
cFontStyle
Description
B
Select Bold font style initially.
I
Select Italic font style initially.
BI
Select Bold Italic font style initially.
P
Display only those fonts available on the current default printer.
nFontCharSet
Specifies a value for the language script. The values you can specify differ depending on your version of Windows.Note
Omitting this value disables the script drop-down list in the dialog box.
The following table describes some example values for nFontCharSet.
nFontCharSet
Language script
0
Western
1
Default
2
Symbol
128
Japanese
161
Greek
162
Turkish
163
Vietnamese
177
Hebrew
178
Arabic
186
Baltic
204
Cyrillic
238
Central European
Note
If you specify 1 for nFontCharSet, the dialog box that GETFONT( ) opened displays the default language script on the operating system. GETFONT( ) never returns 1 because it returns the value for the language script selected in the GETFONT( ) dialog box.
For more information, see FontCharSet Property.
Return Value
Character. GETFONT( ) returns one of the following, depending on certain conditions:
A character string containing three types of font information with commas separating the items returned: font name, size and style. This behavior occurs when you choose one in the Font dialog box and you have not included the fourth optional argument when calling the GETFONT( ) function.
A character string containing four types of font information with commas separating the items returned: font name, size, style and language script. This behavior occurs if you include a value for the nFontCharSet parameter.
Note
In versions of Visual FoxPro previous to Visual FoxPro 9.0, if you included a value of 0 as the fourth argument to GETFONT(), you received the same return information as if you did not include the fourth argument at all. The script drop-down list was not enabled, and the return value contained only three types of font information. In Visual FoxPro 9.0, a value of 0 explicitly indicates the numeric value corresponding to Western script. The script drop-down list might also initially display Western if you specify 1 for this value, but only if Western is the default script for your regional settings.
- An empty string if you exit the Font dialog box by clicking Cancel, Close on the Control menu, or pressing the ESC key.
Remarks
Tip
You can abbreviate some Visual FoxPro commands and functions to four characters when conflicts with other commands and functions do not exist. In the case of GETFONT( ) and GETFILE( ), which both begin with the same four letters, precedence is given to GETFILE( ); therefore, issuing GETF( ) displays the Open dialog box.
Example
The following example illustrates different types of return values you can get from the GETFONT( ) function.
* Invoke the dialog with script drop-down list disabled:
? GETFONT("Arial",12,"B") && press OK in the dialog box
* return value is the string:
* "Arial,12,B"
* Enable the script drop-down list, Western script selected:
? GETFONT("Arial",12,"B",0) && press OK after selections
* sample return value is the string:
* "Verdana,16,N,161"
* Return from the dialog box without making a selection:
? GETFONT("Arial",12,"B") && press Cancel in the dialog box
* return value is an empty string
? GETFONT("Arial",12,"B",0) && press Cancel in the dialog box
* return value is still an empty string