GetFontTypefaceName

int GetFontTypefaceName (char *fontName, char **typefaceName);

Purpose

Returns the typeface name corresponding to the font.

Parameters

Input
Name Type Description
fontName char * The name of an existing font. The font can be one of the National Instrument fonts, a user-defined font saved by a previous CreateMetaFont function call, or a font, such as Courier New, supplied by the operating system.

Predefined fonts—Contain typeface information only and use typefaces native to the operating system. Examples of predefined fonts include VAL_MENU_FONT, VAL_DIALOG_FONT, VAL_EDITOR_FONT, and VAL_APP_FONT.

Predefined metafonts—Contain typeface information, point size, and text styles such as bold, underline, italic, and strikeout. These metafonts are used in the LabWindows/CVI environment. Examples of predefined metafonts include VAL_MENU_META_FONT, VAL_DIALOG_META_FONT, VAL_EDITOR_META_FONT, and VAL_APP_META_FONT.

LabWindows/CVI-supplied metafonts—Supplied with LabWindows/CVI and installed while LabWindows/CVI is running. These metafonts use typefaces that are not native to the operating systems. Examples of LabWindows/CVI-supplied metafonts are VAL_7SEG_META_FONT and VAL_SYSTEM_META_FONT.
Output
Name Type Description
typefaceName char * (passed by reference) The corresponding typeface name string.

You must pass a buffer large enough to hold the corresponding typeface name string, plus the terminating NUL byte. Use GetFontTypefaceNameLength to obtain the length, in bytes, of the string.

Return Value

Name Type Description
status integer Return value indicating whether the function was successful. A negative number indicates that an error occurred.

Code Error Message String
xx Success