GetMetaFontInfo

int GetMetaFontInfo (const char metaFontName[], char typeFace[], int *bold, int *underline, int *strikeOut, int *italic, int *size);

Purpose

This function returns the typeface, size, and font style of the specified meta font.

CVI includes several predefined meta fonts. You can create additional meta fonts by calling the CreateMetaFont function in the User Interface Library. See the function panel for CreateMetaFont for more information on meta fonts.

Note  This function assumes that the metafont name passed is a valid metafont. You can use the IsMetaFont function to determine if a particular font name belongs to a meta font.

Parameters

Input
Name Type Description
metaFontName const char [] Meta Font can be one of the National Instrument meta fonts or a user–defined meta font saved by a previous CreateMetaFont function call.

The following are National Instruments meta fonts:

Platform Independent Meta Fonts: Meta fonts contain typeface information, point size, and text styles such as bold, underline, italic, and strikeout.

VAL_MENU_META_FONT
VAL_DIALOG_META_FONT
VAL_EDITOR_META_FONT
VAL_APP_META_FONT

LW/CVI Supplied Meta Fonts: Meta fonts that are supplied with LabWindows/CVI and installed on both PC and Sun systems while LabWindows/CVI is running.

VAL_7SEG_META_FONT
VAL_SYSTEM_META_FONT
Output
Name Type Description
typeFace char [] The typeface name for the specified metafont is copied into this buffer. The buffer should be at least 256 character long to hold all possible typeface names.

You may pass 0 (NULL) for this parameter if you do not need this information.
bold integer * Returns whether the specified meta font has the bold font style attribute set.

You may pass 0 (NULL) for this parameter if you do not need this information.
underline integer * Returns whether the specified meta font has the underline font style attribute set.

You may pass 0 (NULL) for this parameter if you do not need this information.
strikeOut integer * Returns whether the specified meta font has the strikeout font style attribute set.

You may pass 0 (NULL) for this parameter if you do not need this information.
italic integer * Returns whether the specified meta font has the italic font style attribute set.

You may pass 0 (NULL) for this parameter if you do not need this information.
size integer * Returns the point size of the specified meta font.

You may pass 0 (NULL) for this parameter if you do not need this information.

Return Value

Name Type Description
status integer Returns zero if the function was succesful, or a negative error code if the function failed.

The possible negative error codes are:

–1 to –999 A User Interface Library error code. (Constants are available in userint.h.)

A description of any of these error codes can be obtained using the GetGeneralErrorString function in the toolbox.fp instrument driver.