GetTrueTypeFontFileInfo

InstallShield 2022 » InstallScript Language Reference

The GetTrueTypeFontFileInfo function returns in svResult information about the TrueType font file that is specified by szTrueTypeFontFile.

Syntax

GetTrueTypeFontFileInfo ( szTrueTypeFontFile, nInfo, nLanguage, svResult );

Parameters

GetTrueTypeFontFileInfo Parameters

Parameter

Description

szTrueTypeFontFile

Specifies the fully qualified file name of the TrueType font file from which you want information. Note that non-TrueType files such as .fon and .fot files are not supported by this function, nor are TrueType collection files (.ttc files) supported.

nInfo

Specifies the information to be returned in svResult. Pass one of the following constants in this parameter:

• TTFONTFILEINFO_FONTTITLE—Specifies the font’s title.
• name ID—You can use a name ID to get font information.

nLanguage

Specifies the language of the string to be returned in svResult. Pass a predefined language constant, numeric language ID, the system variable SELECTED_LANGUAGE, or 0 (zero)—which has the same effect as passing SELECTED_LANGUAGE—in this parameter. Note that not all information for a particular font may be available in all languages.

svResult

Returns the font information that you specified in nInfo. An ANSI (non-Unicode) string is returned even if the data in the file is stored in a Unicode format.

Return Values

GetTrueTypeFontFileInfo Return Values

Return Value

Description

>= ISERR_SUCCESS

Indicates that the function successfully retrieved the requested information.

< ISERR_SUCCESS

Indicates that the function was unable to retrieve the requested information.