int FontSelectPopup (char title[], char sampleText[], int monospacedFontsOnly, char typefaceName[], int *bold, int *underline, int *strikeOut,int *italic, int *justification, int *textColor, int *fontSize,int minimumFontSize, int maximumFontSize,int showDefaultButton, int allowMetaFonts);
Opens a dialog box that allows the user to specify font settings.
If the user cancels out of the dialog box or an error occurs, the function does not modify any of the Input/Output parameters.
Input | ||||
Name | Type | Description | ||
title | string | Title of the dialog box. | ||
sampleText | string | Sample text to display in the font select pop-up dialog box as demonstration of how the settings affect the appearance of text. | ||
monospacedFontsOnly | integer | If nonzero, the user can select only monospaced, fixed width, fonts. If zero, the user can select any font. |
||
minimumFontSize | integer | Minimum value allowed in the Font Size control. | ||
maximumFontSize | integer | Maximum value allowed in the Font Size control. | ||
showDefaultButton | integer | If zero, the Default button is hidden. If nonzero, the Default button appears. When the user presses the Default button, the controls on the pop-up dialog box are set to the values you specified in your most recent call to SetFontPopupDefaults. |
||
allowMetaFonts | integer | If zero, the National Instruments-supplied metafonts are not listed in the
typeface selection ring. If nonzero, the metafonts are listed. |
||
Output | ||||
Name | Type | Description | ||
typefaceName | string | On input, this buffer contains the typeface name, for example, "Courier," that initially appears in the selection ring. On output, this buffer contains the typeface name the user selects. The buffer must be at least 256 bytes long. Pass 0 to hide the typeface selection ring and prevent the user from changing the typeface. |
||
bold | integer | On input, the value that initially appears in the Bold checkbox. On output, the final value in the Bold checkbox. Pass 0 to hide the Bold checkbox. |
||
underline | integer | On input, the value that initially appears in the Underline checkbox. On output, the final value in the Underline checkbox. Pass 0 to hide the Underline checkbox. |
||
strikeOut | integer | On input, the value that initially appears in the StrikeOut checkbox. On output, the final value in the StrikeOut checkbox. Pass 0 to hide the StrikeOut checkbox. |
||
italic | integer | On input, the value that initially appears in the Italic checkbox. On output, the final value in the Italic checkbox. Pass 0 to hide the Italic checkbox. |
||
justification | integer | On input, the value that initially appears in the Justification ring control. On output, the final value in the Justification ring control. The valid values of justification are as follows: VAL_LEFT_JUSTIFIED VAL_RIGHT_JUSTIFIED VAL_CENTER_JUSTIFIED
Pass 0 to hide the Justification ring control. |
||
textColor | integer | On input, the value that initially appears in the Text Color control. On output, the final value in the Text Color control. textColor is a 4-byte RGB value. An RGB value is an integer in the hexadecimal format 0x00RRGGBB, where RR, GG, and BB are the respective red, green, and blue components of the color value. Pass 0 to hide the Text Color control. |
||
fontSize | integer | On input, the value that initially appears in the Font Size control. On output, the final value in the Font Size control. Specify fontSize in units of points. Pass 0 to hide the Font Size control. |
Name | Type | Description | ||||
selectionStatus | integer | The selection status or error codes generated during the function call.
Negative values indicate that an error occurred. |