contrib/dialog/dlg_keys.h

   1 /*
   2  *  $Id: dlg_keys.h,v 1.32 2012/12/21 21:54:30 tom Exp $
   3  *
   4  *  dlg_keys.h -- runtime binding support for dialog
   5  *
   6  *  Copyright 2005-2011,2012 Thomas E.  Dickey
   7  *
   8  *  This program is free software; you can redistribute it and/or modify
   9  *  it under the terms of the GNU Lesser General Public License, version 2.1
  10  *  as published by the Free Software Foundation.
  11  *
  12  *  This program is distributed in the hope that it will be useful, but
  13  *  WITHOUT ANY WARRANTY; without even the implied warranty of
  14  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  *  Lesser General Public License for more details.
  16  *
  17  *  You should have received a copy of the GNU Lesser General Public
  18  *  License along with this program; if not, write to
  19  *      Free Software Foundation, Inc.
  20  *      51 Franklin St., Fifth Floor
  21  *      Boston, MA 02110, USA.
  22  */
  23
  24 #ifndef DLG_KEYS_H_included
  25 #define DLG_KEYS_H_included 1
  26 /* *INDENT-OFF* */
  27
  28 #include <dialog.h>
  29
  30 #ifdef USE_WIDE_CURSES
  31 #include <wctype.h>
  32 #define dlg_toupper(ch) towupper((wint_t)ch)
  33 #define dlg_isupper(ch) iswupper((wint_t)ch)
  34 #else
  35 #define dlg_toupper(ch) (((ch) > 0 && (ch) <= 255) ? toupper(ch) : (ch))
  36 #define dlg_isupper(ch) (isalpha(ch) && isupper(ch))
  37 #endif
  38
  39 #ifdef __cplusplus
  40 extern "C" {
  41 #endif
  42
  43 typedef struct {
  44     int is_function_key;
  45     int curses_key;
  46     int dialog_key;
  47 } DLG_KEYS_BINDING;
  48
  49 #define DLG_KEYS_DATA(dialog, curses)  { (curses) >= KEY_MIN, curses, dialog }
  50
  51 #define END_KEYS_BINDING { -1, 0, 0 }
  52
  53 /*
  54  * Define dialog's internal function-keys past the range used by curses.
  55  */
  56 typedef enum {
  57     DLGK_MIN = KEY_MAX + 1,
  58     /* predefined buttons */
  59     DLGK_OK,
  60     DLGK_CANCEL,
  61     DLGK_EXTRA,
  62     DLGK_HELP,
  63     DLGK_ESC,
  64     /* moving from screen to screen (pages) */
  65     DLGK_PAGE_FIRST,
  66     DLGK_PAGE_LAST,
  67     DLGK_PAGE_NEXT,
  68     DLGK_PAGE_PREV,
  69     /* moving within a list */
  70     DLGK_ITEM_FIRST,
  71     DLGK_ITEM_LAST,
  72     DLGK_ITEM_NEXT,
  73     DLGK_ITEM_PREV,
  74     /* moving from field to field (or buttons) */
  75     DLGK_FIELD_FIRST,
  76     DLGK_FIELD_LAST,
  77     DLGK_FIELD_NEXT,
  78     DLGK_FIELD_PREV,
  79     /* moving from form-field to form-field (or buttons) */
  80     DLGK_FORM_FIRST,
  81     DLGK_FORM_LAST,
  82     DLGK_FORM_NEXT,
  83     DLGK_FORM_PREV,
  84     /* moving within a grid */
  85     DLGK_GRID_UP,
  86     DLGK_GRID_DOWN,
  87     DLGK_GRID_LEFT,
  88     DLGK_GRID_RIGHT,
  89     /* delete */
  90     DLGK_DELETE_LEFT,
  91     DLGK_DELETE_RIGHT,
  92     DLGK_DELETE_ALL,
  93     /* special */
  94     DLGK_ENTER,
  95     DLGK_BEGIN,
  96     DLGK_FINAL,
  97     DLGK_SELECT,
  98     DLGK_HELPFILE,
  99     DLGK_TRACE
 100 } DLG_KEYS_ENUM;
 101
 102 #define is_DLGK_MOUSE(code)     ((code) >= M_EVENT)
 103 #define DLGK_MOUSE(code)        ((code) + M_EVENT)
 104
 105 #define HELPKEY_BINDINGS \
 106         DLG_KEYS_DATA( DLGK_HELPFILE,      CHR_HELP ), \
 107         DLG_KEYS_DATA( DLGK_HELPFILE,      KEY_F(1) ), \
 108         DLG_KEYS_DATA( DLGK_HELPFILE,      KEY_HELP )
 109
 110 #define ENTERKEY_BINDINGS \
 111         DLG_KEYS_DATA( DLGK_ENTER,         '\n' ), \
 112         DLG_KEYS_DATA( DLGK_ENTER,         '\r' ), \
 113         DLG_KEYS_DATA( DLGK_ENTER,         KEY_ENTER )
 114
 115 /* ^U == 21 */
 116 #define INPUTSTR_BINDINGS \
 117         DLG_KEYS_DATA( DLGK_BEGIN,         KEY_HOME ), \
 118         DLG_KEYS_DATA( DLGK_DELETE_ALL,    CHR_KILL ), \
 119         DLG_KEYS_DATA( DLGK_DELETE_LEFT,   CHR_BACKSPACE ), \
 120         DLG_KEYS_DATA( DLGK_DELETE_LEFT,   KEY_BACKSPACE ), \
 121         DLG_KEYS_DATA( DLGK_DELETE_RIGHT,  CHR_DELETE ), \
 122         DLG_KEYS_DATA( DLGK_DELETE_RIGHT,  KEY_DC ), \
 123         DLG_KEYS_DATA( DLGK_FINAL,         KEY_END ), \
 124         DLG_KEYS_DATA( DLGK_GRID_LEFT,     KEY_LEFT ), \
 125         DLG_KEYS_DATA( DLGK_GRID_RIGHT,    KEY_RIGHT )
 126
 127 #define SCROLL_FKEY_BINDINGS \
 128         DLG_KEYS_DATA( DLGK_GRID_DOWN,  KEY_DOWN ), \
 129         DLG_KEYS_DATA( DLGK_GRID_UP,    KEY_UP ), \
 130         DLG_KEYS_DATA( DLGK_PAGE_FIRST, KEY_HOME ), \
 131         DLG_KEYS_DATA( DLGK_PAGE_LAST,  KEY_END ), \
 132         DLG_KEYS_DATA( DLGK_PAGE_NEXT,  KEY_NPAGE ), \
 133         DLG_KEYS_DATA( DLGK_PAGE_PREV,  KEY_PPAGE )
 134
 135 #define SCROLLKEY_BINDINGS \
 136         SCROLL_FKEY_BINDINGS, \
 137         DLG_KEYS_DATA( DLGK_GRID_DOWN,  'J' ), \
 138         DLG_KEYS_DATA( DLGK_GRID_DOWN,  'j' ), \
 139         DLG_KEYS_DATA( DLGK_GRID_UP,    'K' ), \
 140         DLG_KEYS_DATA( DLGK_GRID_UP,    'k' ), \
 141         DLG_KEYS_DATA( DLGK_PAGE_FIRST, 'g' ), \
 142         DLG_KEYS_DATA( DLGK_PAGE_LAST,  'G' ), \
 143         DLG_KEYS_DATA( DLGK_PAGE_NEXT,  'F' ), \
 144         DLG_KEYS_DATA( DLGK_PAGE_NEXT,  'f' ), \
 145         DLG_KEYS_DATA( DLGK_PAGE_PREV,  'B' ), \
 146         DLG_KEYS_DATA( DLGK_PAGE_PREV,  'b' )
 147
 148 #define TRAVERSE_BINDINGS \
 149         DLG_KEYS_DATA( DLGK_ENTER,      ' ' ), \
 150         DLG_KEYS_DATA( DLGK_FIELD_NEXT, KEY_DOWN ), \
 151         DLG_KEYS_DATA( DLGK_FIELD_NEXT, KEY_RIGHT ), \
 152         DLG_KEYS_DATA( DLGK_FIELD_NEXT, TAB ), \
 153         DLG_KEYS_DATA( DLGK_FIELD_PREV, KEY_UP ), \
 154         DLG_KEYS_DATA( DLGK_FIELD_PREV, KEY_BTAB ), \
 155         DLG_KEYS_DATA( DLGK_FIELD_PREV, KEY_LEFT )
 156
 157 extern int dlg_lookup_key(WINDOW * /*win*/, int /*curses_key*/, int * /*dialog_key*/);
 158 extern int dlg_result_key(int /*dialog_key*/, int /*fkey*/, int * /*resultp*/);
 159 extern void dlg_register_buttons(WINDOW * /*win*/, const char * /*name*/, const char ** /*buttons*/);
 160 extern void dlg_register_window(WINDOW * /*win*/, const char * /*name*/, DLG_KEYS_BINDING * /*binding*/);
 161 extern void dlg_unregister_window(WINDOW * /*win*/);
 162
 163 #ifdef HAVE_RC_FILE
 164 extern int dlg_parse_bindkey(char * /*params*/);
 165 extern void dlg_dump_keys(FILE * /*fp*/);
 166 extern void dlg_dump_window_keys(FILE * /*fp*/, WINDOW * /*win*/);
 167 #endif
 168
 169 #ifdef __cplusplus
 170 }
 171 #endif
 172 /* *INDENT-ON* */
 173
 174 #endif /* DLG_KEYS_H_included */