util/fontsel.h

   1 /* $Id: fontsel.h,v 1.11 2004/11/09 21:58:45 yooden Exp $ */
   2 /*******************************************************************************
   3 *                                                                              *
   4 * fontsel.h -- Nirvana Editor Font Selector Dialog Header File                 *
   5 *                                                                              *
   6 * Copyright 2003 The NEdit Developers                                          *
   7 *                                                                              *
   8 * This is free software; you can redistribute it and/or modify it under the    *
   9 * terms of the GNU General Public License as published by the Free Software    *
  10 * Foundation; either version 2 of the License, or (at your option) any later   *
  11 * version. In addition, you may distribute versions of this program linked to  *
  12 * Motif or Open Motif. See README for details.                                 *
  13 *                                                                              *
  14 * This software is distributed in the hope that it will be useful, but WITHOUT *
  15 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or        *
  16 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for    *
  17 * more details.                                                                *
  18 *                                                                              *
  19 * You should have received a copy of the GNU General Public License along with *
  20 * software; if not, write to the Free Software Foundation, Inc., 59 Temple     *
  21 * Place, Suite 330, Boston, MA  02111-1307 USA                                 *
  22 *                                                                              *
  23 * Nirvana Text Editor                                                          *
  24 * July 31, 2001                                                                *
  25 *                                                                              *
  26 *******************************************************************************/
  27
  28 #ifndef NEDIT_FONTSEL_H_INCLUDED
  29 #define NEDIT_FONTSEL_H_INCLUDED
  30
  31 #include <X11/Intrinsic.h>
  32
  33 /*******************************************************************************
  34 *                                                                              *
  35 *     FontSel ()                                                               *
  36 *                                                                              *
  37 *                                                                              *
  38 *            Function to put up a modal font selection dialog box. The purpose *
  39 *            of this routine is to allow the user to interactively view sample *
  40 *            fonts and to choose a font for current use.                       *
  41 *                                                                              *
  42 *     Arguments:                                                               *
  43 *                                                                              *
  44 *            Widget     parent          - parent widget ID                     *
  45 *                                                                              *
  46 *            int        showPropFont    - ONLY_FIXED : shows only fixed fonts  *
  47 *                                                      doesn't show prop font  *
  48 *                                                      toggle button also.     *
  49 *                                         PREF_FIXED : can select either fixed *
  50 *                                                      or proportional fonts;  *
  51 *                                                      but starting option is  *
  52 *                                                      Fixed fonts.            *
  53 *                                         PREF_PROP  : can select either fixed *
  54 *                                                      or proportional fonts;  *
  55 *                                                      but starting option is  *
  56 *                                                      proportional fonts.     *
  57 *                                                                              *
  58 *           char *      currFont        - ASCII string that contains the name  *
  59 *                                         of the currently selected font.      *
  60 *                                                                              *
  61 *     Returns:                                                                 *
  62 *                                                                              *
  63 *           pointer to an ASCII character string that contains the name of     *
  64 *           the selected font (in X format for naming fonts); it is the users  *
  65 *           responsibility to free the space allocated to this string.         *
  66 *                                                                              *
  67 *     Comments:                                                                *
  68 *                                                                              *
  69 *           The calling function has to call the appropriate routines to set   *
  70 *           the current font to the one represented by the returned string.    *
  71 *                                                                              *
  72 *******************************************************************************/
  73
  74 /* constant values for controlling the proportional font toggle */
  75
  76 #define ONLY_FIXED      0
  77 #define PREF_FIXED      1
  78 #define PREF_PROP       2
  79
  80
  81 /* function prototype */
  82
  83 char    *FontSel(Widget parent, int showPropFont, const char *currFont,
  84         Pixel sampleFG, Pixel sampleBG);
  85
  86 #endif /* NEDIT_FONTSEL_H_INCLUDED */