|
0
|
1 /* Events: printing them, converting them to and from characters.
|
|
|
2 Copyright (C) 1991, 1992, 1993, 1994 Free Software Foundation, Inc.
|
|
|
3 Copyright (C) 1994, 1995 Board of Trustees, University of Illinois.
|
|
|
4
|
|
|
5 This file is part of XEmacs.
|
|
|
6
|
|
|
7 XEmacs is free software; you can redistribute it and/or modify it
|
|
|
8 under the terms of the GNU General Public License as published by the
|
|
|
9 Free Software Foundation; either version 2, or (at your option) any
|
|
|
10 later version.
|
|
|
11
|
|
|
12 XEmacs is distributed in the hope that it will be useful, but WITHOUT
|
|
|
13 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
|
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
|
15 for more details.
|
|
|
16
|
|
|
17 You should have received a copy of the GNU General Public License
|
|
|
18 along with XEmacs; see the file COPYING. If not, write to
|
|
|
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
20 Boston, MA 02111-1307, USA. */
|
|
|
21
|
|
|
22 /* Synched up with: Not in FSF. */
|
|
|
23
|
|
|
24 /* This file has been Mule-ized. */
|
|
|
25
|
|
|
26 #include <config.h>
|
|
|
27 #include "lisp.h"
|
|
|
28 #include "buffer.h"
|
|
|
29 #include "console.h"
|
|
|
30 #include "console-tty.h" /* for stuff in character_to_event */
|
|
|
31 #include "device.h"
|
|
|
32 #include "console-x.h" /* for x_event_name prototype */
|
|
|
33 #include "extents.h" /* Just for the EXTENTP abort check... */
|
|
|
34 #include "events.h"
|
|
|
35 #include "frame.h"
|
|
|
36 #include "glyphs.h"
|
|
|
37 #include "keymap.h" /* for key_desc_list_to_event() */
|
|
|
38 #include "redisplay.h"
|
|
|
39 #include "window.h"
|
|
|
40
|
|
100
|
41 #ifdef WINDOWSNT
|
|
|
42 /* Hmm, under unix we want X modifiers, under NT we want X modifiers if
|
|
|
43 we are running X and Windows modifiers otherwise.
|
|
|
44 gak. This is a kludge until we support multiple native GUIs!
|
|
|
45 */
|
|
|
46 #undef MOD_ALT
|
|
|
47 #undef MOD_CONTROL
|
|
|
48 #undef MOD_SHIFT
|
|
|
49 #endif
|
|
|
50
|
|
|
51 #include <events-mod.h>
|
|
|
52
|
|
0
|
53 /* Where old events go when they are explicitly deallocated.
|
|
|
54 The event chain here is cut loose before GC, so these will be freed
|
|
|
55 eventually.
|
|
|
56 */
|
|
|
57 static Lisp_Object Vevent_resource;
|
|
|
58
|
|
|
59 Lisp_Object Qeventp;
|
|
|
60 Lisp_Object Qevent_live_p;
|
|
|
61 Lisp_Object Qkey_press_event_p;
|
|
|
62 Lisp_Object Qbutton_event_p;
|
|
|
63 Lisp_Object Qmouse_event_p;
|
|
|
64 Lisp_Object Qprocess_event_p;
|
|
|
65
|
|
149
|
66 Lisp_Object Qkey_press, Qbutton_press, Qbutton_release, Qmisc_user, Qempty;
|
|
0
|
67 Lisp_Object Qascii_character;
|
|
|
68
|
|
|
69 /* #### Ad-hoc hack. Should be part of define_lrecord_implementation */
|
|
|
70 void
|
|
|
71 clear_event_resource (void)
|
|
|
72 {
|
|
|
73 Vevent_resource = Qnil;
|
|
|
74 }
|
|
|
75
|
|
|
76 static Lisp_Object mark_event (Lisp_Object, void (*) (Lisp_Object));
|
|
|
77 static void print_event (Lisp_Object, Lisp_Object, int);
|
|
|
78 static int event_equal (Lisp_Object, Lisp_Object, int);
|
|
|
79 static unsigned long event_hash (Lisp_Object obj, int depth);
|
|
|
80 DEFINE_BASIC_LRECORD_IMPLEMENTATION ("event", event,
|
|
|
81 mark_event, print_event, 0, event_equal,
|
|
|
82 event_hash, struct Lisp_Event);
|
|
|
83
|
|
|
84 /* Make sure we lose quickly if we try to use this event */
|
|
|
85 static void
|
|
|
86 deinitialize_event (Lisp_Object ev)
|
|
|
87 {
|
|
|
88 int i;
|
|
|
89 struct Lisp_Event *event = XEVENT (ev);
|
|
|
90
|
|
|
91 for (i = 0; i < ((sizeof (struct Lisp_Event)) / sizeof (int)); i++)
|
|
|
92 ((int *) event) [i] = 0xdeadbeef;
|
|
|
93 event->event_type = dead_event;
|
|
|
94 event->channel = Qnil;
|
|
|
95 set_lheader_implementation (&(event->lheader), lrecord_event);
|
|
|
96 XSET_EVENT_NEXT (ev, Qnil);
|
|
|
97 }
|
|
|
98
|
|
|
99 /* Set everything to zero or nil so that it's predictable. */
|
|
|
100 void
|
|
|
101 zero_event (struct Lisp_Event *e)
|
|
|
102 {
|
|
|
103 memset (e, 0, sizeof (*e));
|
|
|
104 set_lheader_implementation (&(e->lheader), lrecord_event);
|
|
|
105 e->event_type = empty_event;
|
|
|
106 e->next = Qnil;
|
|
|
107 e->channel = Qnil;
|
|
|
108 }
|
|
|
109
|
|
|
110 static Lisp_Object
|
|
|
111 mark_event (Lisp_Object obj, void (*markobj) (Lisp_Object))
|
|
|
112 {
|
|
|
113 struct Lisp_Event *event = XEVENT (obj);
|
|
|
114
|
|
|
115 switch (event->event_type)
|
|
|
116 {
|
|
|
117 case key_press_event:
|
|
|
118 ((markobj) (event->event.key.keysym));
|
|
|
119 break;
|
|
|
120 case process_event:
|
|
|
121 ((markobj) (event->event.process.process));
|
|
|
122 break;
|
|
|
123 case timeout_event:
|
|
|
124 ((markobj) (event->event.timeout.function));
|
|
|
125 ((markobj) (event->event.timeout.object));
|
|
|
126 break;
|
|
|
127 case eval_event:
|
|
|
128 case misc_user_event:
|
|
|
129 ((markobj) (event->event.eval.function));
|
|
|
130 ((markobj) (event->event.eval.object));
|
|
|
131 break;
|
|
|
132 case magic_eval_event:
|
|
|
133 ((markobj) (event->event.magic_eval.object));
|
|
|
134 break;
|
|
|
135 case button_press_event:
|
|
|
136 case button_release_event:
|
|
|
137 case pointer_motion_event:
|
|
|
138 case magic_event:
|
|
|
139 case empty_event:
|
|
|
140 case dead_event:
|
|
|
141 break;
|
|
|
142 default:
|
|
|
143 abort ();
|
|
|
144 }
|
|
|
145 ((markobj) (event->channel));
|
|
|
146 return event->next;
|
|
|
147 }
|
|
|
148
|
|
|
149 static void
|
|
|
150 print_event_1 (CONST char *str, Lisp_Object obj, Lisp_Object printcharfun)
|
|
|
151 {
|
|
|
152 char buf[255];
|
|
|
153 write_c_string (str, printcharfun);
|
|
|
154 format_event_object (buf, XEVENT (obj), 0);
|
|
|
155 write_c_string (buf, printcharfun);
|
|
|
156 }
|
|
|
157
|
|
|
158 static void
|
|
|
159 print_event (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag)
|
|
|
160 {
|
|
|
161 if (print_readably)
|
|
|
162 error ("printing unreadable object #<event>");
|
|
|
163
|
|
|
164 switch (XEVENT (obj)->event_type)
|
|
|
165 {
|
|
|
166 case key_press_event:
|
|
|
167 print_event_1 ("#<keypress-event ", obj, printcharfun);
|
|
|
168 break;
|
|
|
169 case button_press_event:
|
|
|
170 print_event_1 ("#<buttondown-event ", obj, printcharfun);
|
|
|
171 break;
|
|
|
172 case button_release_event:
|
|
|
173 print_event_1 ("#<buttonup-event ", obj, printcharfun);
|
|
|
174 break;
|
|
|
175 case magic_event:
|
|
|
176 case magic_eval_event:
|
|
|
177 print_event_1 ("#<magic-event ", obj, printcharfun);
|
|
|
178 break;
|
|
|
179 case pointer_motion_event:
|
|
|
180 {
|
|
|
181 char buf[100];
|
|
|
182 sprintf (buf, "#<motion-event %d, %d",
|
|
|
183 XEVENT (obj)->event.motion.x, XEVENT (obj)->event.motion.y);
|
|
|
184 write_c_string (buf, printcharfun);
|
|
|
185 break;
|
|
|
186 }
|
|
|
187 case process_event:
|
|
|
188 write_c_string ("#<process-event ", printcharfun);
|
|
|
189 print_internal (XEVENT (obj)->event.process.process, printcharfun, 1);
|
|
|
190 break;
|
|
|
191 case timeout_event:
|
|
|
192 write_c_string ("#<timeout-event ", printcharfun);
|
|
|
193 print_internal (XEVENT (obj)->event.timeout.object, printcharfun, 1);
|
|
|
194 break;
|
|
|
195 case empty_event:
|
|
|
196 write_c_string ("#<empty-event", printcharfun);
|
|
|
197 break;
|
|
|
198 case misc_user_event:
|
|
|
199 case eval_event:
|
|
|
200 write_c_string ("#<", printcharfun);
|
|
|
201 if (XEVENT (obj)->event_type == misc_user_event)
|
|
|
202 write_c_string ("misc-user", printcharfun);
|
|
|
203 else
|
|
|
204 write_c_string ("eval", printcharfun);
|
|
|
205 write_c_string ("-event (", printcharfun);
|
|
|
206 print_internal (XEVENT (obj)->event.eval.function, printcharfun, 1);
|
|
|
207 write_c_string (" ", printcharfun);
|
|
|
208 print_internal (XEVENT (obj)->event.eval.object, printcharfun, 1);
|
|
|
209 write_c_string (")", printcharfun);
|
|
|
210 break;
|
|
|
211 case dead_event:
|
|
|
212 write_c_string ("#<DEALLOCATED-EVENT", printcharfun);
|
|
|
213 break;
|
|
|
214 default:
|
|
|
215 write_c_string ("#<UNKNOWN-EVENT-TYPE", printcharfun);
|
|
|
216 break;
|
|
|
217 }
|
|
|
218 write_c_string (">", printcharfun);
|
|
|
219 }
|
|
|
220
|
|
|
221 static int
|
|
|
222 event_equal (Lisp_Object o1, Lisp_Object o2, int depth)
|
|
|
223 {
|
|
|
224 struct Lisp_Event *e1 = XEVENT (o1);
|
|
|
225 struct Lisp_Event *e2 = XEVENT (o2);
|
|
|
226
|
|
|
227 if (e1->event_type != e2->event_type) return 0;
|
|
|
228 if (!EQ (e1->channel, e2->channel)) return 0;
|
|
|
229 /* if (e1->timestamp != e2->timestamp) return 0; */
|
|
|
230 switch (e1->event_type)
|
|
|
231 {
|
|
|
232 case process_event:
|
|
149
|
233 return EQ (e1->event.process.process, e2->event.process.process);
|
|
0
|
234
|
|
|
235 case timeout_event:
|
|
149
|
236 return (!NILP (Fequal (e1->event.timeout.function,
|
|
|
237 e2->event.timeout.function)) &&
|
|
|
238 !NILP (Fequal (e1->event.timeout.object,
|
|
|
239 e2->event.timeout.object)));
|
|
0
|
240
|
|
|
241 case key_press_event:
|
|
149
|
242 return (EQ (e1->event.key.keysym, e2->event.key.keysym) &&
|
|
|
243 (e1->event.key.modifiers == e2->event.key.modifiers));
|
|
0
|
244
|
|
|
245 case button_press_event:
|
|
|
246 case button_release_event:
|
|
149
|
247 return (e1->event.button.button == e2->event.button.button &&
|
|
|
248 e1->event.button.modifiers == e2->event.button.modifiers);
|
|
0
|
249
|
|
|
250 case pointer_motion_event:
|
|
149
|
251 return (e1->event.motion.x == e2->event.motion.x &&
|
|
|
252 e1->event.motion.y == e2->event.motion.y);
|
|
0
|
253
|
|
|
254 case misc_user_event:
|
|
|
255 case eval_event:
|
|
149
|
256 return (!NILP (Fequal (e1->event.eval.function,
|
|
|
257 e2->event.eval.function)) &&
|
|
|
258 !NILP (Fequal (e1->event.eval.object,
|
|
|
259 e2->event.eval.object)));
|
|
0
|
260
|
|
|
261 case magic_eval_event:
|
|
149
|
262 return (e1->event.magic_eval.internal_function ==
|
|
|
263 e2->event.magic_eval.internal_function &&
|
|
|
264 !NILP (Fequal (e1->event.magic_eval.object,
|
|
|
265 e2->event.magic_eval.object)));
|
|
0
|
266
|
|
|
267 case magic_event:
|
|
|
268 {
|
|
|
269 Lisp_Object console;
|
|
|
270
|
|
|
271 console = CDFW_CONSOLE (e1->channel);
|
|
|
272
|
|
|
273 #ifdef HAVE_X_WINDOWS
|
|
|
274 /* XEvent is actually a union which means that we can't just use == */
|
|
|
275 if (CONSOLE_X_P (XCONSOLE (console)))
|
|
149
|
276 return !memcmp ((XEvent *) &e1->event.magic.underlying_x_event,
|
|
0
|
277 (XEvent *) &e2->event.magic.underlying_x_event,
|
|
149
|
278 sizeof (e1->event.magic.underlying_x_event));
|
|
0
|
279 #endif
|
|
149
|
280 #ifdef HAVE_TTY
|
|
|
281 if (CONSOLE_TTY_P (XCONSOLE (console)))
|
|
0
|
282 return (e1->event.magic.underlying_tty_event ==
|
|
|
283 e2->event.magic.underlying_tty_event);
|
|
149
|
284 #endif
|
|
|
285 return 1;
|
|
0
|
286 }
|
|
|
287
|
|
|
288 case empty_event: /* Empty and deallocated events are equal. */
|
|
|
289 case dead_event:
|
|
|
290 return 1;
|
|
|
291
|
|
|
292 default:
|
|
|
293 abort ();
|
|
|
294 return 0; /* not reached; warning suppression */
|
|
|
295 }
|
|
|
296 }
|
|
|
297
|
|
|
298 static unsigned long
|
|
|
299 event_hash (Lisp_Object obj, int depth)
|
|
|
300 {
|
|
|
301 struct Lisp_Event *e = XEVENT (obj);
|
|
|
302 unsigned long hash;
|
|
|
303
|
|
|
304 hash = HASH2 (e->event_type, LISP_HASH (e->channel));
|
|
|
305 switch (e->event_type)
|
|
|
306 {
|
|
|
307 case process_event:
|
|
|
308 return HASH2 (hash, LISP_HASH (e->event.process.process));
|
|
|
309
|
|
|
310 case timeout_event:
|
|
|
311 return HASH3 (hash, internal_hash (e->event.timeout.function, depth + 1),
|
|
|
312 internal_hash (e->event.timeout.object, depth + 1));
|
|
|
313
|
|
|
314 case key_press_event:
|
|
|
315 return HASH3 (hash, LISP_HASH (e->event.key.keysym),
|
|
|
316 e->event.key.modifiers);
|
|
|
317
|
|
|
318 case button_press_event:
|
|
|
319 case button_release_event:
|
|
|
320 return HASH3 (hash, e->event.button.button, e->event.button.modifiers);
|
|
|
321
|
|
|
322 case pointer_motion_event:
|
|
|
323 return HASH3 (hash, e->event.motion.x, e->event.motion.y);
|
|
|
324
|
|
|
325 case misc_user_event:
|
|
|
326 case eval_event:
|
|
|
327 return HASH3 (hash, internal_hash (e->event.eval.function, depth + 1),
|
|
|
328 internal_hash (e->event.eval.object, depth + 1));
|
|
|
329
|
|
|
330 case magic_eval_event:
|
|
|
331 return HASH3 (hash,
|
|
|
332 (unsigned long) e->event.magic_eval.internal_function,
|
|
|
333 internal_hash (e->event.magic_eval.object, depth + 1));
|
|
|
334
|
|
|
335 case magic_event:
|
|
|
336 {
|
|
|
337 Lisp_Object console = CDFW_CONSOLE (EVENT_CHANNEL (e));
|
|
|
338 #ifdef HAVE_X_WINDOWS
|
|
|
339 if (CONSOLE_X_P (XCONSOLE (console)))
|
|
|
340 return
|
|
|
341 HASH2 (hash,
|
|
|
342 memory_hash (&e->event.magic.underlying_x_event,
|
|
|
343 sizeof (e->event.magic.underlying_x_event)));
|
|
|
344 #endif
|
|
|
345 return
|
|
|
346 HASH2 (hash,
|
|
|
347 memory_hash (&e->event.magic.underlying_tty_event,
|
|
|
348 sizeof (e->event.magic.underlying_tty_event)));
|
|
|
349 }
|
|
|
350
|
|
|
351 case empty_event:
|
|
|
352 case dead_event:
|
|
|
353 return hash;
|
|
|
354
|
|
|
355 default:
|
|
|
356 abort ();
|
|
|
357 }
|
|
|
358
|
|
|
359 return 0;
|
|
|
360 }
|
|
|
361
|
|
|
362
|
|
|
363 /* #### This should accept a type and props (as returned by
|
|
|
364 event-properties) to allow creation of any type of event.
|
|
|
365 This is useful, for example, in Lisp code that might want
|
|
|
366 to determine if, for a given button-down event, what the
|
|
|
367 binding for the corresponding button-up event is. */
|
|
|
368
|
|
20
|
369 DEFUN ("make-event", Fmake_event, 0, 0, 0, /*
|
|
0
|
370 Create a new empty event.
|
|
|
371 WARNING, the event object returned may be a reused one; see the function
|
|
|
372 `deallocate-event'.
|
|
20
|
373 */
|
|
|
374 ())
|
|
0
|
375 {
|
|
|
376 Lisp_Object event;
|
|
|
377
|
|
|
378 if (!NILP (Vevent_resource))
|
|
|
379 {
|
|
|
380 event = Vevent_resource;
|
|
|
381 Vevent_resource = XEVENT_NEXT (event);
|
|
|
382 }
|
|
|
383 else
|
|
|
384 {
|
|
|
385 event = allocate_event ();
|
|
|
386 }
|
|
|
387 zero_event (XEVENT (event));
|
|
|
388 return event;
|
|
|
389 }
|
|
|
390
|
|
20
|
391 DEFUN ("deallocate-event", Fdeallocate_event, 1, 1, 0, /*
|
|
0
|
392 Allow the given event structure to be reused.
|
|
|
393 You MUST NOT use this event object after calling this function with it.
|
|
|
394 You will lose. It is not necessary to call this function, as event
|
|
|
395 objects are garbage-collected like all other objects; however, it may
|
|
|
396 be more efficient to explicitly deallocate events when you are sure
|
|
2
|
397 that it is safe to do so.
|
|
20
|
398 */
|
|
|
399 (event))
|
|
0
|
400 {
|
|
|
401 CHECK_EVENT (event);
|
|
|
402
|
|
|
403 if (XEVENT_TYPE (event) == dead_event)
|
|
|
404 error ("this event is already deallocated!");
|
|
|
405
|
|
|
406 assert (XEVENT_TYPE (event) <= last_event_type);
|
|
|
407
|
|
|
408 #if 0
|
|
|
409 {
|
|
|
410 int i;
|
|
|
411 extern Lisp_Object Vlast_command_event;
|
|
|
412 extern Lisp_Object Vlast_input_event, Vunread_command_event;
|
|
|
413 extern Lisp_Object Vthis_command_keys, Vrecent_keys_ring;
|
|
|
414
|
|
|
415 if (EQ (event, Vlast_command_event))
|
|
|
416 abort ();
|
|
|
417 if (EQ (event, Vlast_input_event))
|
|
|
418 abort ();
|
|
|
419 if (EQ (event, Vunread_command_event))
|
|
|
420 abort ();
|
|
|
421 for (i = 0; i < XVECTOR (Vthis_command_keys)->size; i++)
|
|
|
422 if (EQ (event, vector_data (XVECTOR (Vthis_command_keys)) [i]))
|
|
|
423 abort ();
|
|
153
|
424 if (!NILP (Vrecent_keys_ring))
|
|
|
425 {
|
|
|
426 for (i = 0; i < XVECTOR (Vrecent_keys_ring)->size; i++)
|
|
|
427 if (EQ (event, vector_data (XVECTOR (Vrecent_keys_ring)) [i]))
|
|
|
428 abort ();
|
|
|
429 }
|
|
0
|
430 }
|
|
|
431 #endif /* 0 */
|
|
|
432
|
|
|
433 assert (!EQ (event, Vevent_resource));
|
|
|
434 deinitialize_event (event);
|
|
|
435 #ifndef ALLOC_NO_POOLS
|
|
|
436 XSET_EVENT_NEXT (event, Vevent_resource);
|
|
|
437 Vevent_resource = event;
|
|
|
438 #endif
|
|
|
439 return Qnil;
|
|
|
440 }
|
|
|
441
|
|
20
|
442 DEFUN ("copy-event", Fcopy_event, 1, 2, 0, /*
|
|
0
|
443 Make a copy of the given event object.
|
|
|
444 If a second argument is given, the first event is copied into the second
|
|
|
445 and the second is returned. If the second argument is not supplied (or
|
|
|
446 is nil) then a new event will be made as with `allocate-event.' See also
|
|
|
447 the function `deallocate-event'.
|
|
20
|
448 */
|
|
|
449 (event1, event2))
|
|
0
|
450 {
|
|
|
451 CHECK_LIVE_EVENT (event1);
|
|
|
452 if (NILP (event2))
|
|
|
453 event2 = Fmake_event ();
|
|
|
454 else CHECK_LIVE_EVENT (event2);
|
|
|
455 if (EQ (event1, event2))
|
|
|
456 return signal_simple_continuable_error_2
|
|
|
457 ("copy-event called with `eq' events", event1, event2);
|
|
|
458
|
|
|
459 assert (XEVENT_TYPE (event1) <= last_event_type);
|
|
|
460 assert (XEVENT_TYPE (event2) <= last_event_type);
|
|
|
461
|
|
|
462 {
|
|
|
463 Lisp_Object save_next = XEVENT_NEXT (event2);
|
|
|
464
|
|
|
465 *XEVENT (event2) = *XEVENT (event1);
|
|
|
466 XSET_EVENT_NEXT (event2, save_next);
|
|
|
467 return (event2);
|
|
|
468 }
|
|
|
469 }
|
|
|
470
|
|
|
471
|
|
|
472
|
|
|
473 /* Given a chain of events (or possibly nil), deallocate them all. */
|
|
|
474
|
|
|
475 void
|
|
|
476 deallocate_event_chain (Lisp_Object event_chain)
|
|
|
477 {
|
|
|
478 while (!NILP (event_chain))
|
|
|
479 {
|
|
|
480 Lisp_Object next = XEVENT_NEXT (event_chain);
|
|
|
481 Fdeallocate_event (event_chain);
|
|
|
482 event_chain = next;
|
|
|
483 }
|
|
|
484 }
|
|
|
485
|
|
|
486 /* Return the last event in a chain.
|
|
|
487 NOTE: You cannot pass nil as a value here! The routine will
|
|
|
488 abort if you do. */
|
|
|
489
|
|
|
490 Lisp_Object
|
|
|
491 event_chain_tail (Lisp_Object event_chain)
|
|
|
492 {
|
|
|
493 while (1)
|
|
|
494 {
|
|
|
495 Lisp_Object next = XEVENT_NEXT (event_chain);
|
|
|
496 if (NILP (next))
|
|
|
497 return event_chain;
|
|
|
498 event_chain = next;
|
|
|
499 }
|
|
|
500 }
|
|
|
501
|
|
|
502 /* Enqueue a single event onto the end of a chain of events.
|
|
|
503 HEAD points to the first event in the chain, TAIL to the last event.
|
|
|
504 If the chain is empty, both values should be nil. */
|
|
|
505
|
|
|
506 void
|
|
|
507 enqueue_event (Lisp_Object event, Lisp_Object *head, Lisp_Object *tail)
|
|
|
508 {
|
|
|
509 assert (NILP (XEVENT_NEXT (event)));
|
|
|
510 assert (!EQ (*tail, event));
|
|
|
511
|
|
|
512 if (!NILP (*tail))
|
|
|
513 XSET_EVENT_NEXT (*tail, event);
|
|
|
514 else
|
|
|
515 *head = event;
|
|
|
516 *tail = event;
|
|
|
517
|
|
|
518 assert (!EQ (event, XEVENT_NEXT (event)));
|
|
|
519 }
|
|
|
520
|
|
|
521 /* Remove an event off the head of a chain of events and return it.
|
|
|
522 HEAD points to the first event in the chain, TAIL to the last event. */
|
|
|
523
|
|
|
524 Lisp_Object
|
|
|
525 dequeue_event (Lisp_Object *head, Lisp_Object *tail)
|
|
|
526 {
|
|
|
527 Lisp_Object event;
|
|
|
528
|
|
|
529 event = *head;
|
|
|
530 *head = XEVENT_NEXT (event);
|
|
|
531 XSET_EVENT_NEXT (event, Qnil);
|
|
|
532 if (NILP (*head))
|
|
|
533 *tail = Qnil;
|
|
|
534 return event;
|
|
|
535 }
|
|
|
536
|
|
|
537 /* Enqueue a chain of events (or possibly nil) onto the end of another
|
|
|
538 chain of events. HEAD points to the first event in the chain being
|
|
|
539 queued onto, TAIL to the last event. If the chain is empty, both values
|
|
|
540 should be nil. */
|
|
|
541
|
|
|
542 void
|
|
|
543 enqueue_event_chain (Lisp_Object event_chain, Lisp_Object *head,
|
|
|
544 Lisp_Object *tail)
|
|
|
545 {
|
|
|
546 if (NILP (event_chain))
|
|
|
547 return;
|
|
|
548
|
|
|
549 if (NILP (*head))
|
|
|
550 {
|
|
|
551 *head = event_chain;
|
|
|
552 *tail = event_chain;
|
|
|
553 }
|
|
|
554 else
|
|
|
555 {
|
|
|
556 XSET_EVENT_NEXT (*tail, event_chain);
|
|
|
557 *tail = event_chain_tail (event_chain);
|
|
|
558 }
|
|
|
559 }
|
|
|
560
|
|
|
561 /* Return the number of events (possibly 0) on an event chain. */
|
|
|
562
|
|
|
563 int
|
|
|
564 event_chain_count (Lisp_Object event_chain)
|
|
|
565 {
|
|
|
566 Lisp_Object event;
|
|
|
567 int n = 0;
|
|
|
568
|
|
|
569 EVENT_CHAIN_LOOP (event, event_chain)
|
|
|
570 n++;
|
|
|
571
|
|
|
572 return n;
|
|
|
573 }
|
|
|
574
|
|
|
575 /* Find the event before EVENT in an event chain. This aborts
|
|
|
576 if the event is not in the chain. */
|
|
|
577
|
|
|
578 Lisp_Object
|
|
|
579 event_chain_find_previous (Lisp_Object event_chain, Lisp_Object event)
|
|
|
580 {
|
|
|
581 Lisp_Object previous = Qnil;
|
|
|
582
|
|
|
583 while (!NILP (event_chain))
|
|
|
584 {
|
|
|
585 if (EQ (event_chain, event))
|
|
|
586 return previous;
|
|
|
587 previous = event_chain;
|
|
|
588 event_chain = XEVENT_NEXT (event_chain);
|
|
|
589 }
|
|
|
590
|
|
|
591 abort ();
|
|
|
592 return Qnil;
|
|
|
593 }
|
|
|
594
|
|
|
595 Lisp_Object
|
|
|
596 event_chain_nth (Lisp_Object event_chain, int n)
|
|
|
597 {
|
|
|
598 Lisp_Object event;
|
|
|
599 EVENT_CHAIN_LOOP (event, event_chain)
|
|
|
600 {
|
|
|
601 if (!n)
|
|
|
602 return event;
|
|
|
603 n--;
|
|
|
604 }
|
|
|
605 return Qnil;
|
|
|
606 }
|
|
|
607
|
|
|
608 Lisp_Object
|
|
|
609 copy_event_chain (Lisp_Object event_chain)
|
|
|
610 {
|
|
|
611 Lisp_Object new_chain = Qnil;
|
|
|
612 Lisp_Object new_chain_tail = Qnil;
|
|
|
613 Lisp_Object event;
|
|
|
614
|
|
|
615 EVENT_CHAIN_LOOP (event, event_chain)
|
|
|
616 {
|
|
|
617 Lisp_Object copy = Fcopy_event (event, Qnil);
|
|
|
618 enqueue_event (copy, &new_chain, &new_chain_tail);
|
|
|
619 }
|
|
|
620
|
|
|
621 return new_chain;
|
|
|
622 }
|
|
|
623
|
|
|
624
|
|
|
625
|
|
|
626 Lisp_Object QKbackspace, QKtab, QKlinefeed, QKreturn, QKescape,
|
|
|
627 QKspace, QKdelete;
|
|
|
628
|
|
|
629 int
|
|
|
630 command_event_p (Lisp_Object event)
|
|
|
631 {
|
|
|
632 switch (XEVENT_TYPE (event))
|
|
|
633 {
|
|
|
634 case key_press_event:
|
|
|
635 case button_press_event:
|
|
|
636 case button_release_event:
|
|
|
637 case misc_user_event:
|
|
|
638 return (1);
|
|
|
639 default:
|
|
|
640 return (0);
|
|
|
641 }
|
|
|
642 }
|
|
|
643
|
|
|
644
|
|
|
645 void
|
|
|
646 character_to_event (Emchar c, struct Lisp_Event *event, struct console *con,
|
|
|
647 int use_console_meta_flag)
|
|
|
648 {
|
|
|
649 Lisp_Object k = Qnil;
|
|
|
650 unsigned int m = 0;
|
|
|
651 if (event->event_type == dead_event)
|
|
|
652 error ("character-to-event called with a deallocated event!");
|
|
|
653
|
|
70
|
654 #ifndef MULE
|
|
0
|
655 c &= 255;
|
|
70
|
656 #endif
|
|
0
|
657 if (c > 127 && c <= 255)
|
|
|
658 {
|
|
|
659 int meta_flag = 1;
|
|
|
660 if (use_console_meta_flag && CONSOLE_TTY_P (con))
|
|
|
661 meta_flag = TTY_FLAGS (con).meta_key;
|
|
|
662 switch (meta_flag)
|
|
|
663 {
|
|
|
664 case 0: /* ignore top bit; it's parity */
|
|
|
665 c -= 128;
|
|
|
666 break;
|
|
|
667 case 1: /* top bit is meta */
|
|
|
668 c -= 128;
|
|
|
669 m = MOD_META;
|
|
|
670 break;
|
|
|
671 default: /* this is a real character */
|
|
|
672 break;
|
|
|
673 }
|
|
|
674 }
|
|
|
675 if (c < ' ') c += '@', m |= MOD_CONTROL;
|
|
|
676 if (m & MOD_CONTROL)
|
|
|
677 {
|
|
|
678 switch (c)
|
|
|
679 {
|
|
|
680 case 'I': k = QKtab; m &= ~MOD_CONTROL; break;
|
|
|
681 case 'J': k = QKlinefeed; m &= ~MOD_CONTROL; break;
|
|
|
682 case 'M': k = QKreturn; m &= ~MOD_CONTROL; break;
|
|
|
683 case '[': k = QKescape; m &= ~MOD_CONTROL; break;
|
|
|
684 # if 0
|
|
|
685 /* This is probably too controversial... */
|
|
|
686 case 'H': k = QKbackspace; m &= ~MOD_CONTROL; break;
|
|
|
687 # endif
|
|
|
688 }
|
|
|
689 if (c >= 'A' && c <= 'Z') c -= 'A'-'a';
|
|
|
690 }
|
|
|
691 else if (c == 127)
|
|
|
692 k = QKdelete;
|
|
|
693 else if (c == ' ')
|
|
|
694 k = QKspace;
|
|
|
695
|
|
2
|
696 event->event_type = key_press_event;
|
|
|
697 event->timestamp = 0; /* #### */
|
|
|
698 event->channel = make_console (con);
|
|
|
699 event->event.key.keysym = (!NILP (k) ? k : make_char (c));
|
|
|
700 event->event.key.modifiers = m;
|
|
0
|
701 }
|
|
|
702
|
|
|
703
|
|
|
704 /* This variable controls what character name -> character code mapping
|
|
|
705 we are using. Window-system-specific code sets this to some symbol,
|
|
|
706 and we use that symbol as the plist key to convert keysyms into 8-bit
|
|
|
707 codes. In this way one can have several character sets predefined and
|
|
|
708 switch them by changing this.
|
|
|
709 */
|
|
|
710 Lisp_Object Vcharacter_set_property;
|
|
|
711
|
|
|
712 Emchar
|
|
|
713 event_to_character (struct Lisp_Event *event,
|
|
|
714 int allow_extra_modifiers,
|
|
|
715 int allow_meta,
|
|
|
716 int allow_non_ascii)
|
|
|
717 {
|
|
|
718 Emchar c = 0;
|
|
|
719 Lisp_Object code;
|
|
|
720
|
|
|
721 if (event->event_type != key_press_event)
|
|
|
722 {
|
|
|
723 if (event->event_type == dead_event) abort ();
|
|
|
724 return -1;
|
|
|
725 }
|
|
|
726 if (!allow_extra_modifiers &&
|
|
|
727 event->event.key.modifiers & (MOD_SUPER|MOD_HYPER|MOD_ALT))
|
|
|
728 return -1;
|
|
|
729 if (CHAR_OR_CHAR_INTP (event->event.key.keysym))
|
|
|
730 c = XCHAR_OR_CHAR_INT (event->event.key.keysym);
|
|
|
731 else if (!SYMBOLP (event->event.key.keysym))
|
|
|
732 abort ();
|
|
|
733 else if (allow_non_ascii && !NILP (Vcharacter_set_property)
|
|
|
734 /* Allow window-system-specific extensibility of
|
|
|
735 keysym->code mapping */
|
|
|
736 && CHAR_OR_CHAR_INTP (code = Fget (event->event.key.keysym,
|
|
|
737 Vcharacter_set_property,
|
|
|
738 Qnil)))
|
|
|
739 c = XCHAR_OR_CHAR_INT (code);
|
|
|
740 else if (CHAR_OR_CHAR_INTP (code = Fget (event->event.key.keysym,
|
|
|
741 Qascii_character, Qnil)))
|
|
|
742 c = XCHAR_OR_CHAR_INT (code);
|
|
|
743 else
|
|
|
744 return -1;
|
|
|
745
|
|
|
746 if (event->event.key.modifiers & MOD_CONTROL)
|
|
|
747 {
|
|
|
748 if (c >= 'a' && c <= 'z')
|
|
|
749 c -= ('a' - 'A');
|
|
|
750 else
|
|
|
751 /* reject Control-Shift- keys */
|
|
|
752 if (c >= 'A' && c <= 'Z' && !allow_extra_modifiers)
|
|
|
753 return -1;
|
|
|
754
|
|
|
755 if (c >= '@' && c <= '_')
|
|
|
756 c -= '@';
|
|
|
757 else if (c == ' ') /* C-space and C-@ are the same. */
|
|
|
758 c = 0;
|
|
|
759 else
|
|
|
760 /* reject keys that can't take Control- modifiers */
|
|
|
761 if (! allow_extra_modifiers) return -1;
|
|
|
762 }
|
|
|
763
|
|
|
764 if (event->event.key.modifiers & MOD_META)
|
|
|
765 {
|
|
|
766 if (! allow_meta) return -1;
|
|
|
767 if (c & 0200) return -1; /* don't allow M-oslash (overlap) */
|
|
70
|
768 #ifdef MULE
|
|
|
769 if (c >= 256) return -1;
|
|
|
770 #endif
|
|
0
|
771 c |= 0200;
|
|
|
772 }
|
|
|
773 return c;
|
|
|
774 }
|
|
|
775
|
|
20
|
776 DEFUN ("event-to-character", Fevent_to_character, 1, 4, 0, /*
|
|
0
|
777 Return the closest ASCII approximation to the given event object.
|
|
|
778 If the event isn't a keypress, this returns nil.
|
|
|
779 If the ALLOW-EXTRA-MODIFIERS argument is non-nil, then this is lenient in
|
|
|
780 its translation; it will ignore modifier keys other than control and meta,
|
|
|
781 and will ignore the shift modifier on those characters which have no
|
|
|
782 shifted ASCII equivalent (Control-Shift-A for example, will be mapped to
|
|
|
783 the same ASCII code as Control-A).
|
|
|
784 If the ALLOW-META argument is non-nil, then the Meta modifier will be
|
|
|
785 represented by turning on the high bit of the byte returned; otherwise, nil
|
|
|
786 will be returned for events containing the Meta modifier.
|
|
|
787 If the ALLOW-NON-ASCII argument is non-nil, then characters which are
|
|
|
788 present in the prevailing character set (see the `character-set-property'
|
|
|
789 variable) will be returned as their code in that character set, instead of
|
|
|
790 the return value being restricted to ASCII.
|
|
|
791 Note that specifying both ALLOW-META and ALLOW-NON-ASCII is ambiguous, as
|
|
|
792 both use the high bit; `M-x' and `oslash' will be indistinguishable.
|
|
20
|
793 */
|
|
70
|
794 (event, allow_extra_modifiers, allow_meta, allow_non_ascii))
|
|
0
|
795 {
|
|
|
796 Emchar c;
|
|
|
797 CHECK_LIVE_EVENT (event);
|
|
|
798 c = event_to_character (XEVENT (event),
|
|
|
799 !NILP (allow_extra_modifiers),
|
|
|
800 !NILP (allow_meta),
|
|
|
801 !NILP (allow_non_ascii));
|
|
|
802 return (c < 0 ? Qnil : make_char (c));
|
|
|
803 }
|
|
|
804
|
|
20
|
805 DEFUN ("character-to-event", Fcharacter_to_event, 1, 4, 0, /*
|
|
2
|
806 Converts a keystroke specifier into an event structure, replete with
|
|
0
|
807 bucky bits. The keystroke is the first argument, and the event to fill
|
|
|
808 in is the second. This function contains knowledge about what the codes
|
|
|
809 ``mean'' -- for example, the number 9 is converted to the character ``Tab'',
|
|
|
810 not the distinct character ``Control-I''.
|
|
|
811
|
|
|
812 Note that CH (the keystroke specifier) can be an integer, a character,
|
|
2
|
813 a symbol such as 'clear, or a list such as '(control backspace).
|
|
0
|
814
|
|
2
|
815 If the optional second argument is an event, it is modified;
|
|
|
816 otherwise, a new event object is created.
|
|
0
|
817
|
|
2
|
818 Optional third arg CONSOLE is the console to store in the event, and
|
|
|
819 defaults to the selected console.
|
|
0
|
820
|
|
|
821 If CH is an integer or character, the high bit may be interpreted as the
|
|
2
|
822 meta key. (This is done for backward compatibility in lots of places.)
|
|
|
823 If USE-CONSOLE-META-FLAG is nil, this will always be the case. If
|
|
|
824 USE-CONSOLE-META-FLAG is non-nil, the `meta' flag for CONSOLE affects
|
|
|
825 whether the high bit is interpreted as a meta key. (See `set-input-mode'.)
|
|
|
826 If you don't want this silly meta interpretation done, you should pass
|
|
|
827 in a list containing the character.
|
|
0
|
828
|
|
|
829 Beware that character-to-event and event-to-character are not strictly
|
|
2
|
830 inverse functions, since events contain much more information than the
|
|
|
831 ASCII character set can encode.
|
|
20
|
832 */
|
|
|
833 (ch, event, console, use_console_meta_flag))
|
|
0
|
834 {
|
|
|
835 struct console *con = decode_console (console);
|
|
|
836 if (NILP (event))
|
|
|
837 event = Fmake_event ();
|
|
|
838 else
|
|
|
839 CHECK_LIVE_EVENT (event);
|
|
|
840 if (CONSP (ch) || SYMBOLP (ch))
|
|
|
841 key_desc_list_to_event (ch, event, 1);
|
|
|
842 else
|
|
|
843 {
|
|
|
844 CHECK_CHAR_COERCE_INT (ch);
|
|
|
845 character_to_event (XCHAR (ch), XEVENT (event), con,
|
|
|
846 !NILP (use_console_meta_flag));
|
|
|
847 }
|
|
|
848 return event;
|
|
|
849 }
|
|
|
850
|
|
|
851 void
|
|
|
852 nth_of_key_sequence_as_event (Lisp_Object seq, int n, Lisp_Object event)
|
|
|
853 {
|
|
|
854 assert (STRINGP (seq) || VECTORP (seq));
|
|
|
855 assert (n < XINT (Flength (seq)));
|
|
|
856
|
|
|
857 if (STRINGP (seq))
|
|
|
858 {
|
|
|
859 Emchar ch = string_char (XSTRING (seq), n);
|
|
|
860 Fcharacter_to_event (make_char (ch), event, Qnil, Qnil);
|
|
|
861 }
|
|
|
862 else
|
|
|
863 {
|
|
|
864 Lisp_Object keystroke = vector_data (XVECTOR (seq))[n];
|
|
|
865 if (EVENTP (keystroke))
|
|
|
866 Fcopy_event (keystroke, event);
|
|
|
867 else
|
|
|
868 Fcharacter_to_event (keystroke, event, Qnil, Qnil);
|
|
|
869 }
|
|
|
870 }
|
|
|
871
|
|
|
872 Lisp_Object
|
|
|
873 key_sequence_to_event_chain (Lisp_Object seq)
|
|
|
874 {
|
|
|
875 int len = XINT (Flength (seq));
|
|
|
876 int i;
|
|
|
877 Lisp_Object head = Qnil, tail = Qnil;
|
|
|
878
|
|
|
879 for (i = 0; i < len; i++)
|
|
|
880 {
|
|
|
881 Lisp_Object event = Fmake_event ();
|
|
|
882 nth_of_key_sequence_as_event (seq, i, event);
|
|
|
883 enqueue_event (event, &head, &tail);
|
|
|
884 }
|
|
|
885
|
|
|
886 return head;
|
|
|
887 }
|
|
|
888
|
|
|
889 void
|
|
|
890 format_event_object (char *buf, struct Lisp_Event *event, int brief)
|
|
|
891 {
|
|
|
892 int mouse_p = 0;
|
|
|
893 int mod = 0;
|
|
|
894 Lisp_Object key;
|
|
|
895
|
|
|
896 switch (event->event_type)
|
|
|
897 {
|
|
|
898 case key_press_event:
|
|
|
899 {
|
|
|
900 mod = event->event.key.modifiers;
|
|
|
901 key = event->event.key.keysym;
|
|
|
902 /* Hack. */
|
|
|
903 if (! brief && CHARP (key) &&
|
|
|
904 mod & (MOD_CONTROL | MOD_META | MOD_SUPER | MOD_HYPER))
|
|
|
905 {
|
|
|
906 int k = XCHAR (key);
|
|
|
907 if (k >= 'a' && k <= 'z')
|
|
|
908 key = make_char (k - ('a' - 'A'));
|
|
|
909 else if (k >= 'A' && k <= 'Z')
|
|
|
910 mod |= MOD_SHIFT;
|
|
|
911 }
|
|
|
912 break;
|
|
|
913 }
|
|
|
914 case button_release_event:
|
|
|
915 mouse_p++;
|
|
|
916 /* Fall through */
|
|
|
917 case button_press_event:
|
|
|
918 {
|
|
|
919 mouse_p++;
|
|
|
920 mod = event->event.button.modifiers;
|
|
|
921 key = make_char (event->event.button.button + '0');
|
|
|
922 break;
|
|
|
923 }
|
|
|
924 case magic_event:
|
|
|
925 {
|
|
|
926 CONST char *name = 0;
|
|
|
927 Lisp_Object console = CDFW_CONSOLE (EVENT_CHANNEL (event));
|
|
|
928
|
|
|
929 #ifdef HAVE_X_WINDOWS
|
|
|
930 if (CONSOLE_X_P (XCONSOLE (console)))
|
|
|
931 name =
|
|
|
932 x_event_name (event->event.magic.underlying_x_event.xany.type);
|
|
|
933 #endif
|
|
|
934 if (name) strcpy (buf, name);
|
|
|
935 else strcpy (buf, "???");
|
|
|
936 return;
|
|
|
937 }
|
|
|
938 case magic_eval_event: strcpy (buf, "magic-eval"); return;
|
|
|
939 case pointer_motion_event: strcpy (buf, "motion"); return;
|
|
|
940 case misc_user_event: strcpy (buf, "misc-user"); return;
|
|
|
941 case eval_event: strcpy (buf, "eval"); return;
|
|
|
942 case process_event: strcpy (buf, "process");return;
|
|
|
943 case timeout_event: strcpy (buf, "timeout");return;
|
|
149
|
944 case empty_event: strcpy (buf, "empty"); return;
|
|
0
|
945 case dead_event: strcpy (buf, "DEAD-EVENT"); return;
|
|
|
946 default:
|
|
|
947 abort ();
|
|
|
948 }
|
|
|
949 #define modprint1(x) { strcpy (buf, (x)); buf += sizeof (x)-1; }
|
|
|
950 #define modprint(x,y) { if (brief) modprint1 (y) else modprint1 (x) }
|
|
|
951 if (mod & MOD_CONTROL) modprint ("control-", "C-");
|
|
|
952 if (mod & MOD_META) modprint ("meta-", "M-");
|
|
|
953 if (mod & MOD_SUPER) modprint ("super-", "S-");
|
|
|
954 if (mod & MOD_HYPER) modprint ("hyper-", "H-");
|
|
|
955 if (mod & MOD_ALT) modprint ("alt-", "A-");
|
|
|
956 if (mod & MOD_SHIFT) modprint ("shift-", "Sh-");
|
|
|
957 if (mouse_p)
|
|
|
958 {
|
|
|
959 modprint1 ("button");
|
|
|
960 --mouse_p;
|
|
|
961 }
|
|
|
962 #undef modprint
|
|
|
963 #undef modprint1
|
|
|
964
|
|
|
965 if (CHARP (key))
|
|
|
966 {
|
|
|
967 buf += set_charptr_emchar ((Bufbyte *) buf, XCHAR (key));
|
|
|
968 *buf = 0;
|
|
|
969 }
|
|
|
970 else if (SYMBOLP (key))
|
|
|
971 {
|
|
|
972 CONST char *str = 0;
|
|
|
973 if (brief)
|
|
|
974 {
|
|
|
975 if (EQ (key, QKlinefeed)) str = "LFD";
|
|
|
976 else if (EQ (key, QKtab)) str = "TAB";
|
|
|
977 else if (EQ (key, QKreturn)) str = "RET";
|
|
|
978 else if (EQ (key, QKescape)) str = "ESC";
|
|
|
979 else if (EQ (key, QKdelete)) str = "DEL";
|
|
|
980 else if (EQ (key, QKspace)) str = "SPC";
|
|
|
981 else if (EQ (key, QKbackspace)) str = "BS";
|
|
|
982 }
|
|
|
983 if (str)
|
|
|
984 {
|
|
|
985 int i = strlen (str);
|
|
|
986 memcpy (buf, str, i+1);
|
|
|
987 str += i;
|
|
|
988 }
|
|
|
989 else
|
|
|
990 {
|
|
|
991 memcpy (buf, string_data (XSYMBOL (key)->name),
|
|
|
992 string_length (XSYMBOL (key)->name) + 1);
|
|
|
993 str += string_length (XSYMBOL (key)->name);
|
|
|
994 }
|
|
|
995 }
|
|
|
996 else
|
|
|
997 abort ();
|
|
|
998 if (mouse_p)
|
|
|
999 strncpy (buf, "up", 4);
|
|
|
1000 }
|
|
|
1001
|
|
20
|
1002 DEFUN ("eventp", Feventp, 1, 1, 0, /*
|
|
0
|
1003 True if OBJECT is an event object.
|
|
20
|
1004 */
|
|
|
1005 (object))
|
|
0
|
1006 {
|
|
149
|
1007 return EVENTP (object) ? Qt : Qnil;
|
|
0
|
1008 }
|
|
|
1009
|
|
20
|
1010 DEFUN ("event-live-p", Fevent_live_p, 1, 1, 0, /*
|
|
0
|
1011 True if OBJECT is an event object that has not been deallocated.
|
|
20
|
1012 */
|
|
|
1013 (object))
|
|
0
|
1014 {
|
|
149
|
1015 return EVENTP (object) && XEVENT (object)->event_type != dead_event ?
|
|
|
1016 Qt : Qnil;
|
|
0
|
1017 }
|
|
|
1018
|
|
|
1019 #if 0 /* debugging functions */
|
|
|
1020
|
|
149
|
1021 xxDEFUN ("event-next", Fevent_next, 1, 1, 0, /*
|
|
0
|
1022 Return the event object's `next' event, or nil if it has none.
|
|
|
1023 The `next-event' field is changed by calling `set-next-event'.
|
|
149
|
1024 */
|
|
|
1025 (event))
|
|
0
|
1026 {
|
|
|
1027 struct Lisp_Event *e;
|
|
|
1028 CHECK_LIVE_EVENT (event);
|
|
|
1029
|
|
|
1030 return XEVENT_NEXT (event);
|
|
|
1031 }
|
|
|
1032
|
|
149
|
1033 xxDEFUN ("set-event-next", Fset_event_next, 2, 2, 0, /*
|
|
0
|
1034 Set the `next event' of EVENT to NEXT-EVENT.
|
|
|
1035 NEXT-EVENT must be an event object or nil.
|
|
149
|
1036 */
|
|
|
1037 (event, next_event))
|
|
0
|
1038 {
|
|
|
1039 Lisp_Object ev;
|
|
|
1040
|
|
|
1041 CHECK_LIVE_EVENT (event);
|
|
|
1042 if (NILP (next_event))
|
|
|
1043 {
|
|
|
1044 XSET_EVENT_NEXT (event, Qnil);
|
|
|
1045 return (Qnil);
|
|
|
1046 }
|
|
|
1047
|
|
|
1048 CHECK_LIVE_EVENT (next_event);
|
|
|
1049
|
|
|
1050 EVENT_CHAIN_LOOP (ev, XEVENT_NEXT (event))
|
|
|
1051 {
|
|
|
1052 QUIT;
|
|
|
1053 if (EQ (ev, event))
|
|
|
1054 signal_error (Qerror,
|
|
|
1055 list3 (build_string ("Cyclic event-next"),
|
|
|
1056 event,
|
|
|
1057 next_event));
|
|
|
1058 }
|
|
|
1059 XSET_EVENT_NEXT (event, next_event);
|
|
149
|
1060 return next_event;
|
|
0
|
1061 }
|
|
|
1062
|
|
|
1063 #endif /* 0 */
|
|
|
1064
|
|
20
|
1065 DEFUN ("event-type", Fevent_type, 1, 1, 0, /*
|
|
0
|
1066 Return the type of EVENT.
|
|
|
1067 This will be a symbol; one of
|
|
|
1068
|
|
|
1069 key-press A key was pressed.
|
|
|
1070 button-press A mouse button was pressed.
|
|
|
1071 button-release A mouse button was released.
|
|
|
1072 misc-user Some other user action happened; typically, this is
|
|
|
1073 a menu selection or scrollbar action.
|
|
|
1074 motion The mouse moved.
|
|
|
1075 process Input is available from a subprocess.
|
|
|
1076 timeout A timeout has expired.
|
|
|
1077 eval This causes a specified action to occur when dispatched.
|
|
|
1078 magic Some window-system-specific event has occurred.
|
|
122
|
1079 empty The event has been allocated but not assigned.
|
|
|
1080
|
|
20
|
1081 */
|
|
|
1082 (event))
|
|
0
|
1083 {
|
|
|
1084 CHECK_LIVE_EVENT (event);
|
|
|
1085 switch (XEVENT (event)->event_type)
|
|
|
1086 {
|
|
149
|
1087 case key_press_event: return Qkey_press;
|
|
|
1088 case button_press_event: return Qbutton_press;
|
|
|
1089 case button_release_event: return Qbutton_release;
|
|
|
1090 case misc_user_event: return Qmisc_user;
|
|
|
1091 case pointer_motion_event: return Qmotion;
|
|
|
1092 case process_event: return Qprocess;
|
|
|
1093 case timeout_event: return Qtimeout;
|
|
|
1094 case eval_event: return Qeval;
|
|
0
|
1095 case magic_event:
|
|
|
1096 case magic_eval_event:
|
|
|
1097 return Qmagic;
|
|
|
1098
|
|
122
|
1099 case empty_event:
|
|
|
1100 return Qempty;
|
|
|
1101
|
|
0
|
1102 default:
|
|
|
1103 abort ();
|
|
|
1104 return Qnil;
|
|
|
1105 }
|
|
|
1106 }
|
|
|
1107
|
|
20
|
1108 DEFUN ("event-timestamp", Fevent_timestamp, 1, 1, 0, /*
|
|
149
|
1109 Return the timestamp of the event object EVENT.
|
|
20
|
1110 */
|
|
|
1111 (event))
|
|
0
|
1112 {
|
|
|
1113 CHECK_LIVE_EVENT (event);
|
|
|
1114 /* This junk is so that timestamps don't get to be negative, but contain
|
|
|
1115 as many bits as this particular emacs will allow.
|
|
|
1116 */
|
|
|
1117 return make_int (((1L << (VALBITS - 1)) - 1) &
|
|
|
1118 XEVENT (event)->timestamp);
|
|
|
1119 }
|
|
|
1120
|
|
|
1121 #define CHECK_EVENT_TYPE(e,t1,sym) \
|
|
|
1122 { CHECK_LIVE_EVENT (e); \
|
|
|
1123 if (XEVENT(e)->event_type != (t1)) \
|
|
|
1124 e = wrong_type_argument ((sym),(e)); \
|
|
|
1125 }
|
|
|
1126
|
|
|
1127 #define CHECK_EVENT_TYPE2(e,t1,t2,sym) \
|
|
|
1128 { CHECK_LIVE_EVENT (e); \
|
|
|
1129 if (XEVENT(e)->event_type != (t1) && XEVENT(e)->event_type != (t2)) \
|
|
|
1130 e = wrong_type_argument ((sym),(e)); \
|
|
|
1131 }
|
|
|
1132
|
|
20
|
1133 DEFUN ("event-key", Fevent_key, 1, 1, 0, /*
|
|
149
|
1134 Return the Keysym of the key-press event EVENT.
|
|
|
1135 This will be a character if the event is associated with one, else a symbol.
|
|
20
|
1136 */
|
|
|
1137 (event))
|
|
0
|
1138 {
|
|
|
1139 CHECK_EVENT_TYPE (event, key_press_event, Qkey_press_event_p);
|
|
149
|
1140 return XEVENT (event)->event.key.keysym;
|
|
0
|
1141 }
|
|
|
1142
|
|
20
|
1143 DEFUN ("event-button", Fevent_button, 1, 1, 0, /*
|
|
149
|
1144 Return the button-number of the given button-press or button-release event.
|
|
20
|
1145 */
|
|
|
1146 (event))
|
|
0
|
1147 {
|
|
|
1148 CHECK_EVENT_TYPE2 (event, button_press_event, button_release_event,
|
|
|
1149 Qbutton_event_p);
|
|
|
1150 #ifdef HAVE_WINDOW_SYSTEM
|
|
|
1151 return make_int (XEVENT (event)->event.button.button);
|
|
|
1152 #else /* !HAVE_WINDOW_SYSTEM */
|
|
|
1153 return Qzero;
|
|
|
1154 #endif /* !HAVE_WINDOW_SYSTEM */
|
|
|
1155 }
|
|
|
1156
|
|
20
|
1157 DEFUN ("event-modifier-bits", Fevent_modifier_bits, 1, 1, 0, /*
|
|
0
|
1158 Return a number representing the modifier keys which were down
|
|
|
1159 when the given mouse or keyboard event was produced. See also the function
|
|
|
1160 event-modifiers.
|
|
20
|
1161 */
|
|
|
1162 (event))
|
|
0
|
1163 {
|
|
|
1164 again:
|
|
|
1165 CHECK_LIVE_EVENT (event);
|
|
|
1166 if (XEVENT (event)->event_type == key_press_event)
|
|
|
1167 return make_int (XEVENT (event)->event.key.modifiers);
|
|
|
1168 else if (XEVENT (event)->event_type == button_press_event ||
|
|
|
1169 XEVENT (event)->event_type == button_release_event)
|
|
|
1170 return make_int (XEVENT (event)->event.button.modifiers);
|
|
|
1171 else if (XEVENT (event)->event_type == pointer_motion_event)
|
|
|
1172 return make_int (XEVENT (event)->event.motion.modifiers);
|
|
|
1173 else
|
|
|
1174 {
|
|
|
1175 event = wrong_type_argument (intern ("key-or-mouse-event-p"), event);
|
|
|
1176 goto again;
|
|
|
1177 }
|
|
|
1178 }
|
|
|
1179
|
|
20
|
1180 DEFUN ("event-modifiers", Fevent_modifiers, 1, 1, 0, /*
|
|
0
|
1181 Return a list of symbols, the names of the modifier keys
|
|
|
1182 which were down when the given mouse or keyboard event was produced.
|
|
|
1183 See also the function event-modifier-bits.
|
|
20
|
1184 */
|
|
|
1185 (event))
|
|
0
|
1186 {
|
|
|
1187 int mod = XINT (Fevent_modifier_bits (event));
|
|
|
1188 Lisp_Object result = Qnil;
|
|
|
1189 if (mod & MOD_SHIFT) result = Fcons (Qshift, result);
|
|
|
1190 if (mod & MOD_ALT) result = Fcons (Qalt, result);
|
|
|
1191 if (mod & MOD_HYPER) result = Fcons (Qhyper, result);
|
|
|
1192 if (mod & MOD_SUPER) result = Fcons (Qsuper, result);
|
|
|
1193 if (mod & MOD_META) result = Fcons (Qmeta, result);
|
|
|
1194 if (mod & MOD_CONTROL) result = Fcons (Qcontrol, result);
|
|
|
1195 return result;
|
|
|
1196 }
|
|
|
1197
|
|
|
1198 static int
|
|
|
1199 event_x_y_pixel_internal (Lisp_Object event, int *x, int *y, int relative)
|
|
|
1200 {
|
|
|
1201 struct window *w;
|
|
|
1202 struct frame *f;
|
|
|
1203
|
|
|
1204 if (XEVENT (event)->event_type == pointer_motion_event)
|
|
|
1205 {
|
|
|
1206 *x = XEVENT (event)->event.motion.x;
|
|
|
1207 *y = XEVENT (event)->event.motion.y;
|
|
|
1208 }
|
|
|
1209 else if (XEVENT (event)->event_type == button_press_event ||
|
|
|
1210 XEVENT (event)->event_type == button_release_event)
|
|
|
1211 {
|
|
|
1212 *x = XEVENT (event)->event.button.x;
|
|
|
1213 *y = XEVENT (event)->event.button.y;
|
|
|
1214 }
|
|
|
1215 else
|
|
|
1216 return 0;
|
|
|
1217
|
|
|
1218 f = XFRAME (EVENT_CHANNEL (XEVENT (event)));
|
|
|
1219
|
|
|
1220 if (relative)
|
|
|
1221 {
|
|
|
1222 w = find_window_by_pixel_pos (*x, *y, f->root_window);
|
|
|
1223
|
|
|
1224 if (!w)
|
|
|
1225 return 1; /* #### What should really happen here. */
|
|
|
1226
|
|
|
1227 *x -= w->pixel_left;
|
|
|
1228 *y -= w->pixel_top;
|
|
|
1229 }
|
|
|
1230 else
|
|
|
1231 {
|
|
|
1232 *y -= FRAME_REAL_TOP_TOOLBAR_HEIGHT (f);
|
|
|
1233 *x -= FRAME_REAL_LEFT_TOOLBAR_WIDTH (f);
|
|
|
1234 }
|
|
|
1235
|
|
|
1236 return 1;
|
|
|
1237 }
|
|
|
1238
|
|
20
|
1239 DEFUN ("event-window-x-pixel", Fevent_window_x_pixel, 1, 1, 0, /*
|
|
149
|
1240 Return the X position in pixels of mouse event EVENT.
|
|
0
|
1241 The value returned is relative to the window the event occurred in.
|
|
149
|
1242 This will signal an error if the event is not a mouse event.
|
|
|
1243 See also `mouse-event-p' and `event-x-pixel'.
|
|
20
|
1244 */
|
|
|
1245 (event))
|
|
0
|
1246 {
|
|
|
1247 int x, y;
|
|
|
1248
|
|
|
1249 CHECK_LIVE_EVENT (event);
|
|
|
1250
|
|
|
1251 if (!event_x_y_pixel_internal (event, &x, &y, 1))
|
|
|
1252 return wrong_type_argument (Qmouse_event_p, event);
|
|
|
1253 else
|
|
|
1254 return make_int (x);
|
|
|
1255 }
|
|
|
1256
|
|
20
|
1257 DEFUN ("event-window-y-pixel", Fevent_window_y_pixel, 1, 1, 0, /*
|
|
149
|
1258 Return the Y position in pixels of mouse event EVENT.
|
|
0
|
1259 The value returned is relative to the window the event occurred in.
|
|
149
|
1260 This will signal an error if the event is not a mouse event.
|
|
|
1261 See also `mouse-event-p' and `event-y-pixel'.
|
|
20
|
1262 */
|
|
|
1263 (event))
|
|
0
|
1264 {
|
|
|
1265 int x, y;
|
|
|
1266
|
|
|
1267 CHECK_LIVE_EVENT (event);
|
|
|
1268
|
|
|
1269 if (!event_x_y_pixel_internal (event, &x, &y, 1))
|
|
|
1270 return wrong_type_argument (Qmouse_event_p, event);
|
|
|
1271 else
|
|
|
1272 return make_int (y);
|
|
|
1273 }
|
|
|
1274
|
|
20
|
1275 DEFUN ("event-x-pixel", Fevent_x_pixel, 1, 1, 0, /*
|
|
149
|
1276 Return the X position in pixels of mouse event EVENT.
|
|
0
|
1277 The value returned is relative to the frame the event occurred in.
|
|
149
|
1278 This will signal an error if the event is not a mouse event.
|
|
|
1279 See also `mouse-event-p' and `event-window-x-pixel'.
|
|
20
|
1280 */
|
|
|
1281 (event))
|
|
0
|
1282 {
|
|
|
1283 int x, y;
|
|
|
1284
|
|
|
1285 CHECK_LIVE_EVENT (event);
|
|
|
1286
|
|
|
1287 if (!event_x_y_pixel_internal (event, &x, &y, 0))
|
|
|
1288 return wrong_type_argument (Qmouse_event_p, event);
|
|
|
1289 else
|
|
|
1290 return make_int (x);
|
|
|
1291 }
|
|
|
1292
|
|
20
|
1293 DEFUN ("event-y-pixel", Fevent_y_pixel, 1, 1, 0, /*
|
|
149
|
1294 Return the Y position in pixels of mouse event EVENT.
|
|
0
|
1295 The value returned is relative to the frame the event occurred in.
|
|
149
|
1296 This will signal an error if the event is not a mouse event.
|
|
|
1297 See also `mouse-event-p' `event-window-y-pixel'.
|
|
20
|
1298 */
|
|
|
1299 (event))
|
|
0
|
1300 {
|
|
|
1301 int x, y;
|
|
|
1302
|
|
|
1303 CHECK_LIVE_EVENT (event);
|
|
|
1304
|
|
|
1305 if (!event_x_y_pixel_internal (event, &x, &y, 0))
|
|
|
1306 return wrong_type_argument (Qmouse_event_p, event);
|
|
|
1307 else
|
|
|
1308 return make_int (y);
|
|
|
1309 }
|
|
|
1310
|
|
|
1311 /* Given an event, return a value:
|
|
|
1312
|
|
|
1313 OVER_TOOLBAR: over one of the 4 frame toolbars
|
|
|
1314 OVER_MODELINE: over a modeline
|
|
|
1315 OVER_BORDER: over an internal border
|
|
|
1316 OVER_NOTHING: over the text area, but not over text
|
|
|
1317 OVER_OUTSIDE: outside of the frame border
|
|
|
1318 OVER_TEXT: over text in the text area
|
|
|
1319
|
|
|
1320 and return:
|
|
|
1321
|
|
|
1322 The X char position in CHAR_X, if not a null pointer.
|
|
|
1323 The Y char position in CHAR_Y, if not a null pointer.
|
|
|
1324 (These last two values are relative to the window the event is over.)
|
|
|
1325 The window it's over in W, if not a null pointer.
|
|
|
1326 The buffer position it's over in BUFP, if not a null pointer.
|
|
|
1327 The closest buffer position in CLOSEST, if not a null pointer.
|
|
|
1328
|
|
|
1329 OBJ_X, OBJ_Y, OBJ1, and OBJ2 are as in pixel_to_glyph_translation().
|
|
|
1330 */
|
|
|
1331
|
|
|
1332 static int
|
|
|
1333 event_pixel_translation (Lisp_Object event, int *char_x, int *char_y,
|
|
|
1334 int *obj_x, int *obj_y,
|
|
|
1335 struct window **w, Bufpos *bufp, Bufpos *closest,
|
|
|
1336 Charcount *modeline_closest,
|
|
|
1337 Lisp_Object *obj1, Lisp_Object *obj2)
|
|
|
1338 {
|
|
|
1339 int pix_x = 0;
|
|
|
1340 int pix_y = 0;
|
|
|
1341 int result;
|
|
|
1342 Lisp_Object frame;
|
|
|
1343
|
|
|
1344 int ret_x, ret_y, ret_obj_x, ret_obj_y;
|
|
|
1345 struct window *ret_w;
|
|
|
1346 Bufpos ret_bufp, ret_closest;
|
|
|
1347 Charcount ret_modeline_closest;
|
|
|
1348 Lisp_Object ret_obj1, ret_obj2;
|
|
|
1349
|
|
|
1350 CHECK_LIVE_EVENT (event);
|
|
|
1351 if (XEVENT (event)->event_type == pointer_motion_event)
|
|
|
1352 {
|
|
|
1353 pix_x = XEVENT (event)->event.motion.x;
|
|
|
1354 pix_y = XEVENT (event)->event.motion.y;
|
|
|
1355 frame = XEVENT (event)->channel;
|
|
|
1356 }
|
|
|
1357 else if (XEVENT (event)->event_type == button_press_event ||
|
|
|
1358 XEVENT (event)->event_type == button_release_event)
|
|
|
1359 {
|
|
|
1360 pix_x = XEVENT (event)->event.button.x;
|
|
|
1361 pix_y = XEVENT (event)->event.button.y;
|
|
|
1362 frame = XEVENT (event)->channel;
|
|
|
1363 }
|
|
|
1364 else
|
|
|
1365 wrong_type_argument (Qmouse_event_p, event);
|
|
|
1366
|
|
|
1367 result = pixel_to_glyph_translation (XFRAME (frame), pix_x, pix_y,
|
|
|
1368 &ret_x, &ret_y, &ret_obj_x, &ret_obj_y,
|
|
|
1369 &ret_w, &ret_bufp, &ret_closest,
|
|
|
1370 &ret_modeline_closest,
|
|
|
1371 &ret_obj1, &ret_obj2);
|
|
|
1372
|
|
|
1373 if (result == OVER_NOTHING || result == OVER_OUTSIDE)
|
|
|
1374 ret_bufp = 0;
|
|
|
1375 else if (ret_w && NILP (ret_w->buffer))
|
|
|
1376 /* Why does this happen? (Does it still happen?)
|
|
|
1377 I guess the window has gotten reused as a non-leaf... */
|
|
|
1378 ret_w = 0;
|
|
|
1379
|
|
|
1380 /* #### pixel_to_glyph_translation() sometimes returns garbage...
|
|
|
1381 The word has type Lisp_Record (presumably meaning `extent') but the
|
|
|
1382 pointer points to random memory, often filled with 0, sometimes not.
|
|
|
1383 */
|
|
|
1384 /* #### Chuck, do we still need this crap? */
|
|
|
1385 if (!NILP (ret_obj1) && !(GLYPHP (ret_obj1)
|
|
|
1386 #ifdef HAVE_TOOLBARS
|
|
|
1387 || TOOLBAR_BUTTONP (ret_obj1)
|
|
|
1388 #endif
|
|
|
1389 ))
|
|
|
1390 abort ();
|
|
|
1391 if (!NILP (ret_obj2) && !(EXTENTP (ret_obj2)
|
|
|
1392 || CONSP (ret_obj2)))
|
|
|
1393 abort ();
|
|
|
1394
|
|
|
1395 if (char_x)
|
|
|
1396 *char_x = ret_x;
|
|
|
1397 if (char_y)
|
|
|
1398 *char_y = ret_y;
|
|
|
1399 if (obj_x)
|
|
|
1400 *obj_x = ret_obj_x;
|
|
|
1401 if (obj_y)
|
|
|
1402 *obj_y = ret_obj_y;
|
|
|
1403 if (w)
|
|
|
1404 *w = ret_w;
|
|
|
1405 if (bufp)
|
|
|
1406 *bufp = ret_bufp;
|
|
|
1407 if (closest)
|
|
|
1408 *closest = ret_closest;
|
|
|
1409 if (modeline_closest)
|
|
|
1410 *modeline_closest = ret_modeline_closest;
|
|
|
1411 if (obj1)
|
|
|
1412 *obj1 = ret_obj1;
|
|
|
1413 if (obj2)
|
|
|
1414 *obj2 = ret_obj2;
|
|
|
1415
|
|
|
1416 return result;
|
|
|
1417 }
|
|
|
1418
|
|
20
|
1419 DEFUN ("event-over-text-area-p", Fevent_over_text_area_p, 1, 1, 0, /*
|
|
149
|
1420 Return t if the mouse event EVENT occurred over the text area of a window.
|
|
0
|
1421 The modeline is not considered to be part of the text area.
|
|
20
|
1422 */
|
|
|
1423 (event))
|
|
0
|
1424 {
|
|
|
1425 int result = event_pixel_translation (event, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0);
|
|
|
1426
|
|
149
|
1427 return result == OVER_TEXT || result == OVER_NOTHING ? Qt : Qnil;
|
|
0
|
1428 }
|
|
|
1429
|
|
20
|
1430 DEFUN ("event-over-modeline-p", Fevent_over_modeline_p, 1, 1, 0, /*
|
|
149
|
1431 Return t if the mouse event EVENT occurred over the modeline of a window.
|
|
20
|
1432 */
|
|
|
1433 (event))
|
|
0
|
1434 {
|
|
|
1435 int result = event_pixel_translation (event, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0);
|
|
|
1436
|
|
149
|
1437 return result == OVER_MODELINE ? Qt : Qnil;
|
|
0
|
1438 }
|
|
|
1439
|
|
20
|
1440 DEFUN ("event-over-border-p", Fevent_over_border_p, 1, 1, 0, /*
|
|
149
|
1441 Return t if the mouse event EVENT occurred over an internal border.
|
|
20
|
1442 */
|
|
|
1443 (event))
|
|
0
|
1444 {
|
|
|
1445 int result = event_pixel_translation (event, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0);
|
|
|
1446
|
|
149
|
1447 return result == OVER_BORDER ? Qt : Qnil;
|
|
0
|
1448 }
|
|
|
1449
|
|
20
|
1450 DEFUN ("event-over-toolbar-p", Fevent_over_toolbar_p, 1, 1, 0, /*
|
|
149
|
1451 Return t if the mouse event EVENT occurred over a toolbar.
|
|
20
|
1452 */
|
|
|
1453 (event))
|
|
0
|
1454 {
|
|
|
1455 int result = event_pixel_translation (event, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0);
|
|
|
1456
|
|
149
|
1457 return result == OVER_TOOLBAR ? Qt : Qnil;
|
|
0
|
1458 }
|
|
|
1459
|
|
|
1460 struct console *
|
|
|
1461 event_console_or_selected (Lisp_Object event)
|
|
|
1462 {
|
|
|
1463 Lisp_Object channel = EVENT_CHANNEL (XEVENT (event));
|
|
|
1464 Lisp_Object console = CDFW_CONSOLE (channel);
|
|
|
1465
|
|
|
1466 if (NILP (console))
|
|
|
1467 console = Vselected_console;
|
|
|
1468
|
|
|
1469 return XCONSOLE (console);
|
|
|
1470 }
|
|
|
1471
|
|
20
|
1472 DEFUN ("event-channel", Fevent_channel, 1, 1, 0, /*
|
|
149
|
1473 Return the channel that the event EVENT occurred on.
|
|
0
|
1474 This will be a frame, device, console, or nil for some types
|
|
|
1475 of events (e.g. eval events).
|
|
20
|
1476 */
|
|
|
1477 (event))
|
|
0
|
1478 {
|
|
|
1479 CHECK_LIVE_EVENT (event);
|
|
|
1480 return EVENT_CHANNEL (XEVENT (event));
|
|
|
1481 }
|
|
|
1482
|
|
20
|
1483 DEFUN ("event-window", Fevent_window, 1, 1, 0, /*
|
|
149
|
1484 Return the window over which mouse event EVENT occurred.
|
|
0
|
1485 This may be nil if the event occurred in the border or over a toolbar.
|
|
149
|
1486 The modeline is considered to be within the window it describes.
|
|
20
|
1487 */
|
|
|
1488 (event))
|
|
0
|
1489 {
|
|
|
1490 struct window *w;
|
|
|
1491
|
|
|
1492 event_pixel_translation (event, 0, 0, 0, 0, &w, 0, 0, 0, 0, 0);
|
|
|
1493
|
|
|
1494 if (!w)
|
|
|
1495 return Qnil;
|
|
|
1496 else
|
|
|
1497 {
|
|
149
|
1498 Lisp_Object window;
|
|
|
1499
|
|
0
|
1500 XSETWINDOW (window, w);
|
|
|
1501 return window;
|
|
|
1502 }
|
|
|
1503 }
|
|
|
1504
|
|
20
|
1505 DEFUN ("event-point", Fevent_point, 1, 1, 0, /*
|
|
149
|
1506 Return the character position of the mouse event EVENT.
|
|
0
|
1507 If the event did not occur over a window, or did not occur over text,
|
|
149
|
1508 then this returns nil. Otherwise, it returns a position in the buffer
|
|
0
|
1509 visible in the event's window.
|
|
20
|
1510 */
|
|
|
1511 (event))
|
|
0
|
1512 {
|
|
|
1513 Bufpos bufp;
|
|
|
1514 struct window *w;
|
|
|
1515
|
|
|
1516 event_pixel_translation (event, 0, 0, 0, 0, &w, &bufp, 0, 0, 0, 0);
|
|
|
1517
|
|
149
|
1518 return w && bufp ? make_int (bufp) : Qnil;
|
|
0
|
1519 }
|
|
|
1520
|
|
20
|
1521 DEFUN ("event-closest-point", Fevent_closest_point, 1, 1, 0, /*
|
|
149
|
1522 Return the character position closest to the mouse event EVENT.
|
|
0
|
1523 If the event did not occur over a window or over text, return the
|
|
|
1524 closest point to the location of the event. If the Y pixel position
|
|
|
1525 overlaps a window and the X pixel position is to the left of that
|
|
|
1526 window, the closest point is the beginning of the line containing the
|
|
|
1527 Y position. If the Y pixel position overlaps a window and the X pixel
|
|
|
1528 position is to the right of that window, the closest point is the end
|
|
|
1529 of the line containing the Y position. If the Y pixel position is
|
|
149
|
1530 above a window, return 0. If it is below the last character in a window,
|
|
|
1531 return the value of (window-end).
|
|
20
|
1532 */
|
|
|
1533 (event))
|
|
0
|
1534 {
|
|
|
1535 Bufpos bufp;
|
|
|
1536
|
|
|
1537 event_pixel_translation (event, 0, 0, 0, 0, 0, 0, &bufp, 0, 0, 0);
|
|
|
1538
|
|
149
|
1539 return bufp ? make_int (bufp) : Qnil;
|
|
0
|
1540 }
|
|
|
1541
|
|
20
|
1542 DEFUN ("event-x", Fevent_x, 1, 1, 0, /*
|
|
149
|
1543 Return the X position of the mouse event EVENT in characters.
|
|
0
|
1544 This is relative to the window the event occurred over.
|
|
20
|
1545 */
|
|
|
1546 (event))
|
|
0
|
1547 {
|
|
|
1548 int char_x;
|
|
|
1549
|
|
|
1550 event_pixel_translation (event, &char_x, 0, 0, 0, 0, 0, 0, 0, 0, 0);
|
|
|
1551
|
|
|
1552 return make_int (char_x);
|
|
|
1553 }
|
|
|
1554
|
|
20
|
1555 DEFUN ("event-y", Fevent_y, 1, 1, 0, /*
|
|
149
|
1556 Return the Y position of the mouse event EVENT in characters.
|
|
0
|
1557 This is relative to the window the event occurred over.
|
|
20
|
1558 */
|
|
|
1559 (event))
|
|
0
|
1560 {
|
|
|
1561 int char_y;
|
|
|
1562
|
|
|
1563 event_pixel_translation (event, 0, &char_y, 0, 0, 0, 0, 0, 0, 0, 0);
|
|
|
1564
|
|
|
1565 return make_int (char_y);
|
|
|
1566 }
|
|
|
1567
|
|
20
|
1568 DEFUN ("event-modeline-position", Fevent_modeline_position, 1, 1, 0, /*
|
|
0
|
1569 Return the character position in the modeline that EVENT occurred over.
|
|
|
1570 EVENT should be a mouse event. If EVENT did not occur over a modeline,
|
|
|
1571 nil is returned. You can determine the actual character that the
|
|
|
1572 event occurred over by looking in `generated-modeline-string' at the
|
|
|
1573 returned character position. Note that `generated-modeline-string'
|
|
|
1574 is buffer-local, and you must use EVENT's buffer when retrieving
|
|
|
1575 `generated-modeline-string' in order to get accurate results.
|
|
20
|
1576 */
|
|
|
1577 (event))
|
|
0
|
1578 {
|
|
|
1579 Charcount mbufp;
|
|
|
1580
|
|
|
1581 event_pixel_translation (event, 0, 0, 0, 0, 0, 0, 0, &mbufp, 0, 0);
|
|
|
1582
|
|
149
|
1583 return mbufp < 0 ? Qnil : make_int (mbufp);
|
|
0
|
1584 }
|
|
|
1585
|
|
20
|
1586 DEFUN ("event-glyph", Fevent_glyph, 1, 1, 0, /*
|
|
149
|
1587 Return the glyph that the mouse event EVENT occurred over, or nil.
|
|
20
|
1588 */
|
|
|
1589 (event))
|
|
0
|
1590 {
|
|
|
1591 Lisp_Object glyph;
|
|
|
1592 struct window *w;
|
|
|
1593
|
|
|
1594 event_pixel_translation (event, 0, 0, 0, 0, &w, 0, 0, 0, &glyph, 0);
|
|
|
1595
|
|
149
|
1596 return w && GLYPHP (glyph) ? glyph : Qnil;
|
|
0
|
1597 }
|
|
|
1598
|
|
20
|
1599 DEFUN ("event-glyph-extent", Fevent_glyph_extent, 1, 1, 0, /*
|
|
149
|
1600 Return the extent of the glyph that the mouse event EVENT occurred over.
|
|
0
|
1601 If the event did not occur over a glyph, nil is returned.
|
|
20
|
1602 */
|
|
|
1603 (event))
|
|
0
|
1604 {
|
|
|
1605 Lisp_Object extent;
|
|
|
1606 struct window *w;
|
|
|
1607
|
|
|
1608 event_pixel_translation (event, 0, 0, 0, 0, &w, 0, 0, 0, 0, &extent);
|
|
|
1609
|
|
149
|
1610 return w && EXTENTP (extent) ? extent : Qnil;
|
|
0
|
1611 }
|
|
|
1612
|
|
20
|
1613 DEFUN ("event-glyph-x-pixel", Fevent_glyph_x_pixel, 1, 1, 0, /*
|
|
0
|
1614 Return the X pixel position of EVENT relative to the glyph it occurred over.
|
|
|
1615 EVENT should be a mouse event. If the event did not occur over a glyph,
|
|
|
1616 nil is returned.
|
|
20
|
1617 */
|
|
|
1618 (event))
|
|
0
|
1619 {
|
|
|
1620 Lisp_Object extent;
|
|
|
1621 struct window *w;
|
|
|
1622 int obj_x;
|
|
|
1623
|
|
|
1624 event_pixel_translation (event, 0, 0, &obj_x, 0, &w, 0, 0, 0, 0, &extent);
|
|
|
1625
|
|
149
|
1626 return w && EXTENTP (extent) ? make_int (obj_x) : Qnil;
|
|
0
|
1627 }
|
|
|
1628
|
|
20
|
1629 DEFUN ("event-glyph-y-pixel", Fevent_glyph_y_pixel, 1, 1, 0, /*
|
|
0
|
1630 Return the Y pixel position of EVENT relative to the glyph it occurred over.
|
|
|
1631 EVENT should be a mouse event. If the event did not occur over a glyph,
|
|
|
1632 nil is returned.
|
|
20
|
1633 */
|
|
|
1634 (event))
|
|
0
|
1635 {
|
|
|
1636 Lisp_Object extent;
|
|
|
1637 struct window *w;
|
|
|
1638 int obj_y;
|
|
|
1639
|
|
|
1640 event_pixel_translation (event, 0, 0, 0, &obj_y, &w, 0, 0, 0, 0, &extent);
|
|
|
1641
|
|
149
|
1642 return w && EXTENTP (extent) ? make_int (obj_y) : Qnil;
|
|
0
|
1643 }
|
|
|
1644
|
|
20
|
1645 DEFUN ("event-toolbar-button", Fevent_toolbar_button, 1, 1, 0, /*
|
|
149
|
1646 Return the toolbar button that the mouse event EVENT occurred over.
|
|
|
1647 If the event did not occur over a toolbar button, nil is returned.
|
|
20
|
1648 */
|
|
|
1649 (event))
|
|
0
|
1650 {
|
|
|
1651 #ifdef HAVE_TOOLBARS
|
|
|
1652 Lisp_Object button;
|
|
|
1653
|
|
149
|
1654 int result = event_pixel_translation (event, 0, 0, 0, 0, 0, 0, 0, 0, &button, 0);
|
|
0
|
1655
|
|
149
|
1656 return result == OVER_TOOLBAR && TOOLBAR_BUTTONP (button) ? button : Qnil;
|
|
|
1657 #else
|
|
0
|
1658 return Qnil;
|
|
|
1659 #endif
|
|
|
1660 }
|
|
|
1661
|
|
20
|
1662 DEFUN ("event-process", Fevent_process, 1, 1, 0, /*
|
|
0
|
1663 Return the process of the given process-output event.
|
|
20
|
1664 */
|
|
|
1665 (event))
|
|
0
|
1666 {
|
|
|
1667 CHECK_EVENT_TYPE (event, process_event, Qprocess_event_p);
|
|
149
|
1668 return XEVENT (event)->event.process.process;
|
|
0
|
1669 }
|
|
|
1670
|
|
20
|
1671 DEFUN ("event-function", Fevent_function, 1, 1, 0, /*
|
|
0
|
1672 Return the callback function of EVENT.
|
|
|
1673 EVENT should be a timeout, misc-user, or eval event.
|
|
20
|
1674 */
|
|
|
1675 (event))
|
|
0
|
1676 {
|
|
|
1677 CHECK_LIVE_EVENT (event);
|
|
|
1678 switch (XEVENT (event)->event_type)
|
|
|
1679 {
|
|
|
1680 case timeout_event:
|
|
|
1681 return (XEVENT (event)->event.timeout.function);
|
|
|
1682 case misc_user_event:
|
|
|
1683 case eval_event:
|
|
|
1684 return (XEVENT (event)->event.eval.function);
|
|
|
1685 default:
|
|
|
1686 return wrong_type_argument (intern ("timeout-or-eval-event-p"), event);
|
|
|
1687 }
|
|
|
1688 }
|
|
|
1689
|
|
20
|
1690 DEFUN ("event-object", Fevent_object, 1, 1, 0, /*
|
|
0
|
1691 Return the callback function argument of EVENT.
|
|
|
1692 EVENT should be a timeout, misc-user, or eval event.
|
|
20
|
1693 */
|
|
|
1694 (event))
|
|
0
|
1695 {
|
|
|
1696 again:
|
|
|
1697 CHECK_LIVE_EVENT (event);
|
|
|
1698 switch (XEVENT (event)->event_type)
|
|
|
1699 {
|
|
|
1700 case timeout_event:
|
|
|
1701 return (XEVENT (event)->event.timeout.object);
|
|
|
1702 case misc_user_event:
|
|
|
1703 case eval_event:
|
|
|
1704 return (XEVENT (event)->event.eval.object);
|
|
|
1705 default:
|
|
|
1706 event = wrong_type_argument (intern ("timeout-or-eval-event-p"), event);
|
|
|
1707 goto again;
|
|
|
1708 }
|
|
|
1709 }
|
|
|
1710
|
|
20
|
1711 DEFUN ("event-properties", Fevent_properties, 1, 1, 0, /*
|
|
0
|
1712 Return a list of all of the properties of EVENT.
|
|
|
1713 This is in the form of a property list (alternating keyword/value pairs).
|
|
20
|
1714 */
|
|
|
1715 (event))
|
|
0
|
1716 {
|
|
|
1717 Lisp_Object props = Qnil;
|
|
|
1718 struct Lisp_Event *e;
|
|
|
1719 struct gcpro gcpro1;
|
|
|
1720
|
|
|
1721 CHECK_LIVE_EVENT (event);
|
|
|
1722 e = XEVENT (event);
|
|
|
1723 GCPRO1 (props);
|
|
|
1724
|
|
|
1725 props = Fcons (Qtimestamp, Fcons (Fevent_timestamp (event), props));
|
|
|
1726
|
|
|
1727 switch (e->event_type)
|
|
|
1728 {
|
|
|
1729 case process_event:
|
|
|
1730 props = Fcons (Qprocess, Fcons (e->event.process.process, props));
|
|
|
1731 break;
|
|
|
1732
|
|
|
1733 case timeout_event:
|
|
|
1734 props = Fcons (Qobject, Fcons (Fevent_object (event), props));
|
|
|
1735 props = Fcons (Qfunction, Fcons (Fevent_function (event), props));
|
|
|
1736 props = Fcons (Qid, Fcons (make_int (e->event.timeout.id_number),
|
|
|
1737 props));
|
|
|
1738 break;
|
|
|
1739
|
|
|
1740 case key_press_event:
|
|
|
1741 props = Fcons (Qmodifiers, Fcons (Fevent_modifiers (event), props));
|
|
|
1742 props = Fcons (Qkey, Fcons (Fevent_key (event), props));
|
|
|
1743 break;
|
|
|
1744
|
|
|
1745 case button_press_event:
|
|
|
1746 case button_release_event:
|
|
|
1747 props = Fcons (Qy, Fcons (Fevent_y_pixel (event), props));
|
|
|
1748 props = Fcons (Qx, Fcons (Fevent_x_pixel (event), props));
|
|
|
1749 props = Fcons (Qmodifiers, Fcons (Fevent_modifiers (event), props));
|
|
|
1750 props = Fcons (Qbutton, Fcons (Fevent_button (event), props));
|
|
|
1751 break;
|
|
|
1752
|
|
|
1753 case pointer_motion_event:
|
|
|
1754 props = Fcons (Qmodifiers, Fcons (Fevent_modifiers (event), props));
|
|
|
1755 props = Fcons (Qy, Fcons (Fevent_y_pixel (event), props));
|
|
|
1756 props = Fcons (Qx, Fcons (Fevent_x_pixel (event), props));
|
|
|
1757 break;
|
|
|
1758
|
|
|
1759 case misc_user_event:
|
|
|
1760 case eval_event:
|
|
|
1761 props = Fcons (Qobject, Fcons (Fevent_object (event), props));
|
|
|
1762 props = Fcons (Qfunction, Fcons (Fevent_function (event), props));
|
|
|
1763 break;
|
|
|
1764
|
|
|
1765 case magic_eval_event:
|
|
|
1766 case magic_event:
|
|
149
|
1767 break;
|
|
|
1768
|
|
122
|
1769 case empty_event:
|
|
149
|
1770 RETURN_UNGCPRO (Qnil);
|
|
0
|
1771 break;
|
|
|
1772
|
|
|
1773 default:
|
|
|
1774 abort ();
|
|
|
1775 break; /* not reached; warning suppression */
|
|
|
1776 }
|
|
|
1777
|
|
|
1778 props = Fcons (Qchannel, Fcons (Fevent_channel (event), props));
|
|
|
1779 UNGCPRO;
|
|
|
1780
|
|
|
1781 return props;
|
|
|
1782 }
|
|
|
1783
|
|
|
1784
|
|
|
1785 /************************************************************************/
|
|
|
1786 /* initialization */
|
|
|
1787 /************************************************************************/
|
|
|
1788
|
|
|
1789 void
|
|
|
1790 syms_of_events (void)
|
|
|
1791 {
|
|
20
|
1792 DEFSUBR (Fcharacter_to_event);
|
|
|
1793 DEFSUBR (Fevent_to_character);
|
|
0
|
1794
|
|
20
|
1795 DEFSUBR (Fmake_event);
|
|
|
1796 DEFSUBR (Fdeallocate_event);
|
|
|
1797 DEFSUBR (Fcopy_event);
|
|
|
1798 DEFSUBR (Feventp);
|
|
|
1799 DEFSUBR (Fevent_live_p);
|
|
|
1800 DEFSUBR (Fevent_type);
|
|
|
1801 DEFSUBR (Fevent_properties);
|
|
0
|
1802
|
|
20
|
1803 DEFSUBR (Fevent_timestamp);
|
|
|
1804 DEFSUBR (Fevent_key);
|
|
|
1805 DEFSUBR (Fevent_button);
|
|
|
1806 DEFSUBR (Fevent_modifier_bits);
|
|
|
1807 DEFSUBR (Fevent_modifiers);
|
|
|
1808 DEFSUBR (Fevent_x_pixel);
|
|
|
1809 DEFSUBR (Fevent_y_pixel);
|
|
|
1810 DEFSUBR (Fevent_window_x_pixel);
|
|
|
1811 DEFSUBR (Fevent_window_y_pixel);
|
|
|
1812 DEFSUBR (Fevent_over_text_area_p);
|
|
|
1813 DEFSUBR (Fevent_over_modeline_p);
|
|
|
1814 DEFSUBR (Fevent_over_border_p);
|
|
|
1815 DEFSUBR (Fevent_over_toolbar_p);
|
|
|
1816 DEFSUBR (Fevent_channel);
|
|
|
1817 DEFSUBR (Fevent_window);
|
|
|
1818 DEFSUBR (Fevent_point);
|
|
|
1819 DEFSUBR (Fevent_closest_point);
|
|
|
1820 DEFSUBR (Fevent_x);
|
|
|
1821 DEFSUBR (Fevent_y);
|
|
|
1822 DEFSUBR (Fevent_modeline_position);
|
|
|
1823 DEFSUBR (Fevent_glyph);
|
|
|
1824 DEFSUBR (Fevent_glyph_extent);
|
|
|
1825 DEFSUBR (Fevent_glyph_x_pixel);
|
|
|
1826 DEFSUBR (Fevent_glyph_y_pixel);
|
|
|
1827 DEFSUBR (Fevent_toolbar_button);
|
|
|
1828 DEFSUBR (Fevent_process);
|
|
|
1829 DEFSUBR (Fevent_function);
|
|
|
1830 DEFSUBR (Fevent_object);
|
|
0
|
1831
|
|
|
1832 defsymbol (&Qeventp, "eventp");
|
|
|
1833 defsymbol (&Qevent_live_p, "event-live-p");
|
|
|
1834 defsymbol (&Qkey_press_event_p, "key-press-event-p");
|
|
|
1835 defsymbol (&Qbutton_event_p, "button-event-p");
|
|
|
1836 defsymbol (&Qmouse_event_p, "mouse-event-p");
|
|
|
1837 defsymbol (&Qprocess_event_p, "process-event-p");
|
|
|
1838 defsymbol (&Qkey_press, "key-press");
|
|
|
1839 defsymbol (&Qbutton_press, "button-press");
|
|
|
1840 defsymbol (&Qbutton_release, "button-release");
|
|
|
1841 defsymbol (&Qmisc_user, "misc-user");
|
|
149
|
1842 defsymbol (&Qempty, "empty");
|
|
0
|
1843 defsymbol (&Qascii_character, "ascii-character");
|
|
|
1844 }
|
|
|
1845
|
|
|
1846 void
|
|
|
1847 vars_of_events (void)
|
|
|
1848 {
|
|
|
1849 DEFVAR_LISP ("character-set-property", &Vcharacter_set_property /*
|
|
|
1850 A symbol used to look up the 8-bit character of a keysym.
|
|
|
1851 To convert a keysym symbol to an 8-bit code, as when that key is
|
|
|
1852 bound to self-insert-command, we will look up the property that this
|
|
|
1853 variable names on the property list of the keysym-symbol. The window-
|
|
|
1854 system-specific code will set up appropriate properties and set this
|
|
|
1855 variable.
|
|
|
1856 */ );
|
|
|
1857 Vcharacter_set_property = Qnil;
|
|
|
1858
|
|
|
1859 Vevent_resource = Qnil;
|
|
|
1860
|
|
|
1861 QKbackspace = KEYSYM ("backspace");
|
|
|
1862 QKtab = KEYSYM ("tab");
|
|
|
1863 QKlinefeed = KEYSYM ("linefeed");
|
|
|
1864 QKreturn = KEYSYM ("return");
|
|
|
1865 QKescape = KEYSYM ("escape");
|
|
|
1866 QKspace = KEYSYM ("space");
|
|
|
1867 QKdelete = KEYSYM ("delete");
|
|
|
1868
|
|
|
1869 staticpro (&QKbackspace);
|
|
|
1870 staticpro (&QKtab);
|
|
|
1871 staticpro (&QKlinefeed);
|
|
|
1872 staticpro (&QKreturn);
|
|
|
1873 staticpro (&QKescape);
|
|
|
1874 staticpro (&QKspace);
|
|
|
1875 staticpro (&QKdelete);
|
|
|
1876 }
|
