keyboard.h 3.71 KB
Newer Older
Jim Blandy's avatar
Jim Blandy committed
1
/* Declarations useful when processing input.
Jim Blandy's avatar
Jim Blandy committed
2
   Copyright (C) 1985, 1986, 1987, 1993 Free Software Foundation, Inc.
Jim Blandy's avatar
Jim Blandy committed
3 4 5 6 7

This file is part of GNU Emacs.

GNU Emacs is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
Jim Blandy's avatar
Jim Blandy committed
8
the Free Software Foundation; either version 2, or (at your option)
Jim Blandy's avatar
Jim Blandy committed
9 10 11 12 13 14 15 16 17 18 19 20 21 22
any later version.

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Emacs; see the file COPYING.  If not, write to
the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */

/* Total number of times read_char has returned.  */
extern int num_input_chars;

23 24 25
/* Total number of times read_char has returned, outside of macros.  */
extern int num_nonmacro_input_chars;

Jim Blandy's avatar
Jim Blandy committed
26 27 28 29 30 31 32
/* Nonzero means polling for input is temporarily suppresed.  */
extern int poll_suppress_count;

/* Keymap mapping ASCII function key sequences onto their preferred forms.
   Initialized by the terminal-specific lisp files.  */
extern Lisp_Object Vfunction_key_map;

33 34 35 36 37 38
/* Vector holding the key sequence that invoked the current command.
   It is reused for each command, and it may be longer than the current
   sequence; this_command_key_count indicates how many elements
   actually mean something.  */
extern Lisp_Object this_command_keys;
extern int this_command_key_count;
39

40 41 42 43 44 45
#ifdef MULTI_FRAME
/* The frame in which the last input event occurred, or Qmacro if the
   last event came from a macro.  We use this to determine when to
   generate switch-frame events.  This may be cleared by functions
   like Fselect_frame, to make sure that a switch-frame event is
   generated by the next character.  */
46
extern Lisp_Object internal_last_event_frame;
47 48
#endif

Jim Blandy's avatar
Jim Blandy committed
49 50 51 52 53

/* Macros for dealing with lispy events.  */

/* True iff EVENT has data fields describing it (i.e. a mouse click).  */
#define EVENT_HAS_PARAMETERS(event) \
54
  (XTYPE (event) == Lisp_Cons)
Jim Blandy's avatar
Jim Blandy committed
55

Jim Blandy's avatar
Jim Blandy committed
56 57
/* Extract the head from an event.
   This works on composite and simple events.  */
58 59 60
#define EVENT_HEAD(event) \
  (EVENT_HAS_PARAMETERS (event) ? XCONS (event)->car : (event))

Jim Blandy's avatar
Jim Blandy committed
61
/* Extract the starting and ending positions from a composite event.  */
62 63 64
#define EVENT_START(event) (XCONS (XCONS (event)->cdr)->car)
#define EVENT_END(event) (XCONS (XCONS (XCONS (event)->cdr)->cdr)->car)

Jim Blandy's avatar
Jim Blandy committed
65
/* Extract the fields of a position.  */
66 67 68 69 70
#define POSN_WINDOW(posn) (XCONS (posn)->car)
#define POSN_BUFFER_POSN(posn) (XCONS (XCONS (posn)->cdr)->car)
#define POSN_WINDOW_POSN(posn) (XCONS (XCONS (XCONS (posn)->cdr)->cdr)->car)
#define POSN_TIMESTAMP(posn) \
  (XCONS (XCONS (XCONS (XCONS (posn)->cdr)->cdr)->cdr)->car)
Jim Blandy's avatar
Jim Blandy committed
71 72

/* Some of the event heads.  */
73
extern Lisp_Object Qswitch_frame;
Jim Blandy's avatar
Jim Blandy committed
74 75

/* Properties on event heads.  */
76
extern Lisp_Object Qevent_kind, Qevent_symbol_elements;
Jim Blandy's avatar
Jim Blandy committed
77 78 79

/* Getting an unmodified version of an event head.  */
#define EVENT_HEAD_UNMODIFIED(event_head) \
80
  (Fcar (Fget ((event_head), Qevent_symbol_elements)))
Jim Blandy's avatar
Jim Blandy committed
81 82 83

/* The values of Qevent_kind properties.  */
extern Lisp_Object Qfunction_key, Qmouse_click, Qmouse_movement;
84
extern Lisp_Object Qscroll_bar_movement;
Jim Blandy's avatar
Jim Blandy committed
85 86 87 88 89 90

/* Getting the kind of an event head.  */
#define EVENT_HEAD_KIND(event_head) \
  (Fget ((event_head), Qevent_kind))

/* Symbols to use for non-text mouse positions.  */
Jim Blandy's avatar
Jim Blandy committed
91
extern Lisp_Object Qmode_line, Qvertical_line;
Jim Blandy's avatar
Jim Blandy committed
92

93 94 95 96
extern Lisp_Object get_keymap_1 ();
extern Lisp_Object Fkeymapp ();
extern Lisp_Object reorder_modifiers ();
extern Lisp_Object read_char ();
Jim Blandy's avatar
Jim Blandy committed
97 98 99
/* User-supplied string to translate input characters through.  */
extern Lisp_Object Vkeyboard_translate_table;