util/fontsel.h

   1 /* $Id: fontsel.h,v 1.5 2001/10/21 15:13:07 tringali Exp $ */
   2 /*******************************************************************************
   3 *                                                                              *
   4 *     FontSel ()                                                               *
   5 *                                                                              *
   6 *                                                                              *
   7 *            Function to put up a modal font selection dialog box. The purpose *
   8 *            of this routine is to allow the user to interactively view sample *
   9 *            fonts and to choose a font for current use.                       *
  10 *                                                                              *
  11 *     Arguments:                                                               *
  12 *                                                                              *
  13 *            Widget     parent          - parent widget ID                     *
  14 *                                                                              *
  15 *            int        showPropFont    - ONLY_FIXED : shows only fixed fonts  *
  16 *                                                      doesn't show prop font  *
  17 *                                                      toggle button also.     *
  18 *                                         PREF_FIXED : can select either fixed *
  19 *                                                      or proportional fonts;  *
  20 *                                                      but starting option is  *
  21 *                                                      Fixed fonts.            *
  22 *                                         PREF_PROP  : can select either fixed *
  23 *                                                      or proportional fonts;  *
  24 *                                                      but starting option is  *
  25 *                                                      proportional fonts.     *
  26 *                                                                              *
  27 *           char *      currFont        - ASCII string that contains the name  *
  28 *                                         of the currently selected font.      *
  29 *                                                                              *
  30 *     Returns:                                                                 *
  31 *                                                                              *
  32 *           pointer to an ASCII character string that contains the name of     *
  33 *           the selected font (in X format for naming fonts); it is the users  *
  34 *           responsibility to free the space allocated to this string.         *
  35 *                                                                              *
  36 *     Comments:                                                                *
  37 *                                                                              *
  38 *           The calling function has to call the appropriate routines to set   *
  39 *           the current font to the one represented by the returned string.    *
  40 *                                                                              *
  41 *******************************************************************************/
  42
  43 /* constant values for controlling the proportional font toggle */
  44
  45 #define ONLY_FIXED      0
  46 #define PREF_FIXED      1
  47 #define PREF_PROP       2
  48
  49
  50 /* function prototype */
  51
  52 char    *FontSel(Widget parent, int showPropFont, const char *currFont);