Admin Production ni-theme
Current Publication

GetRealFontTypefaceNameLength

LabWindows/CVI

GetRealFontTypefaceNameLength

int GetRealFontTypefaceNameLength (char *fontName, int *typefaceNameLength);

Purpose

Returns the length, in bytes, of the string containing the name of the actual typeface used by the operating system.

Parameters

Input
Name Type Description
fontName char * The name of an existing font.The font can be a predefined font; a predefined NI metafont; a user-defined metafont saved by a previous call to functions such as CreateMetaFont and CreateMetaFontEx; 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. The predefined fonts are VAL_MENU_FONT, VAL_DIALOG_FONT, VAL_EDITOR_FONT, VAL_APP_FONT, and VAL_MESSAGE_BOX_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. The predefined metafonts are VAL_MENU_META_FONT, VAL_DIALOG_META_FONT, VAL_EDITOR_META_FONT, VAL_APP_META_FONT, and VAL_MESSAGE_BOX_META_FONT.

LabWindows/CVI-supplied metafonts—Use typefaces that are not native to the operating system. These metafonts are installed while LabWindows/CVI is running. The LabWindows/CVI-supplied metafonts are VAL_7SEG_META_FONT and VAL_SYSTEM_META_FONT.
Output
Name Type Description
typefaceNameLength int The length, in bytes, of the typeface name string corresponding to the font specified. The length does not include the terminating NUL byte.

Return Value

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

Additional Information

Library: User Interface Library

Include file: userint.h

LabWindows/CVI compatibility: LabWindows/CVI 2012 and later