util/fontsel.h

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