CreateMetaFontWithCharacterSet
int CreateMetaFontWithCharacterSet (char newMetaFontName[], char existingFontName[], int pointSize, int bold, int italics, int underlined, int strikeout, int angle, int characterSet);
Purpose
Creates a new metafont based on a predefined National Instruments font, an existing metafont, or a font supplied by the operating system. CreateMetaFontWithCharacterSet is similar to CreateMetaFontEx, except that CreateMetaFontWithCharacterSet provides the characterSet parameter.
You can use metafonts that you create with this function in any control or panel attribute that requires a font.
The metafonts you create with this function contain typeface and character set information, point size, text style, and orientation angle.
Parameters
| Input | ||||||||||||||||||||||||||||||||||||
| Name | Type | Description | ||||||||||||||||||||||||||||||||||
| newMetaFontName | char [] | Name to associate with the new metafont. | ||||||||||||||||||||||||||||||||||
| existingFontName | char [] | Name of the existing font on which to base the new metafont. 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, 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. |
||||||||||||||||||||||||||||||||||
| pointSize | int | Point size of the new metafont. The valid range is from 1 to 255. | ||||||||||||||||||||||||||||||||||
| bold | int | Specify a nonzero value or select yes in the function panel to create a metafont with bold text. Specify 0 or select no in the function panel otherwise. |
||||||||||||||||||||||||||||||||||
| italics | int | Specify a nonzero value or select yes in the function panel to create a metafont with italicized text. Specify 0 or select no in the function panel otherwise. |
||||||||||||||||||||||||||||||||||
| underlined | int | Specify a nonzero value or select yes in the function panel to create a metafont with underlined text. Specify 0 or select no in the function panel otherwise. |
||||||||||||||||||||||||||||||||||
| strikeout | int | Specify a nonzero value or select yes in the function panel to create a metafont with strikeout text. Specify 0 or select no in the function panel otherwise. |
||||||||||||||||||||||||||||||||||
| angle | int | The angle of rotation, in tenths of degrees, of the font. For example, if you want to rotate the text by 90°, specify 900. The valid range is from -32768 to 32767. The following user interface objects support rotated text:
|
||||||||||||||||||||||||||||||||||
| characterSet | int | The character set of the font.
You can select the following values:
|
||||||||||||||||||||||||||||||||||
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 9.0 and later