GetTextDisplaySize

int GetTextDisplaySize (char text[], char metaFont[], int *height, int *width);

Purpose

Returns the height and width of a string of text given the metafont you specify.

Parameters

Input
Name Type Description
text string Text string whose size is calculated.

Note   This function does not support multiline text strings. The function assumes that any special characters embedded in the string, such as tabs and line-feeds, appear as characters, subject to the character set used in the font.
metaFont string Metafont to use in calculating the display size of the text.

metaFont can be one of the National Instrument metafonts or a user-defined metafont saved by a previous CreateMetaFont function call.

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
height integer Height of the text in pixels.

You can pass NULL.
width integer Width of the text in pixels.

You can pass NULL.

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