Commit | Line | Data |
---|---|---|
80856e74 JB |
1 | /* Hooks by which low level terminal operations |
2 | can be made to call other routines. | |
3a22ee35 | 3 | Copyright (C) 1985, 1986, 1993, 1994 Free Software Foundation, Inc. |
80856e74 JB |
4 | |
5 | This file is part of GNU Emacs. | |
6 | ||
7 | GNU Emacs is free software; you can redistribute it and/or modify | |
8 | it under the terms of the GNU General Public License as published by | |
ffd56f97 | 9 | the Free Software Foundation; either version 2, or (at your option) |
80856e74 JB |
10 | any later version. |
11 | ||
12 | GNU Emacs is distributed in the hope that it will be useful, | |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | GNU General Public License for more details. | |
16 | ||
17 | You should have received a copy of the GNU General Public License | |
18 | along with GNU Emacs; see the file COPYING. If not, write to | |
3b7ad313 EN |
19 | the Free Software Foundation, Inc., 59 Temple Place - Suite 330, |
20 | Boston, MA 02111-1307, USA. */ | |
80856e74 | 21 | |
ec3f896c JB |
22 | \f |
23 | /* Miscellanea. */ | |
24 | ||
6820433e GM |
25 | struct glyph; |
26 | struct frame; | |
27 | ||
ec3f896c JB |
28 | /* If nonzero, send all terminal output characters to this stream also. */ |
29 | extern FILE *termscript; | |
30 | ||
ec5d8db7 AS |
31 | /* Only use prototypes when lisp.h has been included. */ |
32 | #ifndef P_ | |
33 | #define P_(X) () | |
34 | #endif | |
ec3f896c JB |
35 | \f |
36 | /* Text display hooks. */ | |
80856e74 | 37 | |
6820433e | 38 | extern void (*cursor_to_hook) P_ ((int vpos, int hpos)); |
ec5d8db7 | 39 | extern void (*raw_cursor_to_hook) P_ ((int, int)); |
80856e74 | 40 | |
ec5d8db7 AS |
41 | extern void (*clear_to_end_hook) P_ ((void)); |
42 | extern void (*clear_frame_hook) P_ ((void)); | |
43 | extern void (*clear_end_of_line_hook) P_ ((int)); | |
80856e74 | 44 | |
ec5d8db7 | 45 | extern void (*ins_del_lines_hook) P_ ((int, int)); |
80856e74 | 46 | |
6820433e | 47 | extern void (*change_line_highlight_hook) P_ ((int, int, int, int)); |
ec5d8db7 | 48 | extern void (*reassert_line_highlight_hook) P_ ((int, int)); |
80856e74 | 49 | |
6820433e GM |
50 | extern void (*insert_glyphs_hook) P_ ((struct glyph *s, int n)); |
51 | extern void (*write_glyphs_hook) P_ ((struct glyph *s, int n)); | |
ec5d8db7 | 52 | extern void (*delete_glyphs_hook) P_ ((int)); |
80856e74 | 53 | |
ec5d8db7 | 54 | extern void (*ring_bell_hook) P_ ((void)); |
80856e74 | 55 | |
ec5d8db7 AS |
56 | extern void (*reset_terminal_modes_hook) P_ ((void)); |
57 | extern void (*set_terminal_modes_hook) P_ ((void)); | |
58 | extern void (*update_begin_hook) P_ ((struct frame *)); | |
59 | extern void (*update_end_hook) P_ ((struct frame *)); | |
60 | extern void (*set_terminal_window_hook) P_ ((int)); | |
80856e74 | 61 | |
ec3f896c JB |
62 | |
63 | \f | |
64 | /* Multi-frame and mouse support hooks. */ | |
80856e74 | 65 | |
a3c87d4e JB |
66 | enum scroll_bar_part { |
67 | scroll_bar_above_handle, | |
68 | scroll_bar_handle, | |
33d5f42a RS |
69 | scroll_bar_below_handle, |
70 | scroll_bar_up_arrow, | |
6820433e GM |
71 | scroll_bar_down_arrow, |
72 | scroll_bar_to_top, | |
73 | scroll_bar_to_bottom, | |
57207f1e SM |
74 | scroll_bar_end_scroll, |
75 | scroll_bar_move_ratio | |
20a558dc JB |
76 | }; |
77 | ||
78 | /* Return the current position of the mouse. | |
ec3f896c JB |
79 | |
80 | Set *f to the frame the mouse is in, or zero if the mouse is in no | |
81 | Emacs frame. If it is set to zero, all the other arguments are | |
82 | garbage. | |
83 | ||
a3c87d4e JB |
84 | If the motion started in a scroll bar, set *bar_window to the |
85 | scroll bar's window, *part to the part the mouse is currently over, | |
86 | *x to the position of the mouse along the scroll bar, and *y to the | |
87 | overall length of the scroll bar. | |
ec3f896c JB |
88 | |
89 | Otherwise, set *bar_window to Qnil, and *x and *y to the column and | |
90 | row of the character cell the mouse is over. | |
91 | ||
92 | Set *time to the time the mouse was at the returned position. | |
93 | ||
94 | This should clear mouse_moved until the next motion | |
95 | event arrives. */ | |
ec5d8db7 | 96 | extern void (*mouse_position_hook) P_ ((struct frame **f, int, |
ec3f896c | 97 | Lisp_Object *bar_window, |
a3c87d4e | 98 | enum scroll_bar_part *part, |
265a9e55 JB |
99 | Lisp_Object *x, |
100 | Lisp_Object *y, | |
ec5d8db7 | 101 | unsigned long *time)); |
265a9e55 JB |
102 | |
103 | /* The window system handling code should set this if the mouse has | |
104 | moved since the last call to the mouse_position_hook. Calling that | |
105 | hook should clear this. */ | |
106 | extern int mouse_moved; | |
80856e74 | 107 | |
0137dbf7 | 108 | /* When a frame's focus redirection is changed, this hook tells the |
0f79a4ae | 109 | window system code to re-decide where to put the highlight. Under |
265a9e55 | 110 | X, this means that Emacs lies about where the focus is. */ |
ec5d8db7 | 111 | extern void (*frame_rehighlight_hook) P_ ((struct frame *)); |
62c07cc7 | 112 | |
dbc4e1c1 JB |
113 | /* If we're displaying frames using a window system that can stack |
114 | frames on top of each other, this hook allows you to bring a frame | |
115 | to the front, or bury it behind all the other windows. If this | |
116 | hook is zero, that means the device we're displaying on doesn't | |
117 | support overlapping frames, so there's no need to raise or lower | |
118 | anything. | |
119 | ||
120 | If RAISE is non-zero, F is brought to the front, before all other | |
121 | windows. If RAISE is zero, F is sent to the back, behind all other | |
122 | windows. */ | |
ec5d8db7 | 123 | extern void (*frame_raise_lower_hook) P_ ((struct frame *f, int raise)); |
ec3f896c JB |
124 | |
125 | \f | |
a3c87d4e | 126 | /* Scroll bar hooks. */ |
ec3f896c | 127 | |
a3c87d4e | 128 | /* The representation of scroll bars is determined by the code which |
ec3f896c JB |
129 | implements them, except for one thing: they must be represented by |
130 | lisp objects. This allows us to place references to them in | |
131 | Lisp_Windows without worrying about those references becoming | |
a3c87d4e | 132 | dangling references when the scroll bar is destroyed. |
ec3f896c JB |
133 | |
134 | The window-system-independent portion of Emacs just refers to | |
a3c87d4e | 135 | scroll bars via their windows, and never looks inside the scroll bar |
ec3f896c | 136 | representation; it always uses hook functions to do all the |
a3c87d4e | 137 | scroll bar manipulation it needs. |
ec3f896c | 138 | |
a3c87d4e JB |
139 | The `vertical_scroll_bar' field of a Lisp_Window refers to that |
140 | window's scroll bar, or is nil if the window doesn't have a | |
141 | scroll bar. | |
ec3f896c | 142 | |
a3c87d4e JB |
143 | The `scroll_bars' and `condemned_scroll_bars' fields of a Lisp_Frame |
144 | are free for use by the scroll bar implementation in any way it sees | |
ec3f896c JB |
145 | fit. They are marked by the garbage collector. */ |
146 | ||
147 | ||
a3c87d4e | 148 | /* Set the vertical scroll bar for WINDOW to have its upper left corner |
ec3f896c JB |
149 | at (TOP, LEFT), and be LENGTH rows high. Set its handle to |
150 | indicate that we are displaying PORTION characters out of a total | |
151 | of WHOLE characters, starting at POSITION. If WINDOW doesn't yet | |
a3c87d4e JB |
152 | have a scroll bar, create one for it. */ |
153 | extern void (*set_vertical_scroll_bar_hook) | |
ec5d8db7 AS |
154 | P_ ((struct window *window, |
155 | int portion, int whole, int position)); | |
20a558dc JB |
156 | |
157 | ||
158 | /* The following three hooks are used when we're doing a thorough | |
a3c87d4e | 159 | redisplay of the frame. We don't explicitly know which scroll bars |
20a558dc JB |
160 | are going to be deleted, because keeping track of when windows go |
161 | away is a real pain - can you say set-window-configuration? | |
162 | Instead, we just assert at the beginning of redisplay that *all* | |
a3c87d4e | 163 | scroll bars are to be removed, and then save scroll bars from the |
b72e4ca8 | 164 | fiery pit when we actually redisplay their window. */ |
20a558dc | 165 | |
a3c87d4e JB |
166 | /* Arrange for all scroll bars on FRAME to be removed at the next call |
167 | to `*judge_scroll_bars_hook'. A scroll bar may be spared if | |
168 | `*redeem_scroll_bar_hook' is applied to its window before the judgement. | |
ec3f896c JB |
169 | |
170 | This should be applied to each frame each time its window tree is | |
a3c87d4e JB |
171 | redisplayed, even if it is not displaying scroll bars at the moment; |
172 | if the HAS_SCROLL_BARS flag has just been turned off, only calling | |
173 | this and the judge_scroll_bars_hook will get rid of them. | |
20a558dc | 174 | |
ec3f896c | 175 | If non-zero, this hook should be safe to apply to any frame, |
a3c87d4e | 176 | whether or not it can support scroll bars, and whether or not it is |
ec3f896c | 177 | currently displaying them. */ |
ec5d8db7 | 178 | extern void (*condemn_scroll_bars_hook) P_ ((struct frame *frame)); |
ec3f896c | 179 | |
a3c87d4e JB |
180 | /* Unmark WINDOW's scroll bar for deletion in this judgement cycle. |
181 | Note that it's okay to redeem a scroll bar that is not condemned. */ | |
ec5d8db7 | 182 | extern void (*redeem_scroll_bar_hook) P_ ((struct window *window)); |
20a558dc | 183 | |
a3c87d4e JB |
184 | /* Remove all scroll bars on FRAME that haven't been saved since the |
185 | last call to `*condemn_scroll_bars_hook'. | |
ec3f896c JB |
186 | |
187 | This should be applied to each frame after each time its window | |
a3c87d4e JB |
188 | tree is redisplayed, even if it is not displaying scroll bars at the |
189 | moment; if the HAS_SCROLL_BARS flag has just been turned off, only | |
190 | calling this and condemn_scroll_bars_hook will get rid of them. | |
20a558dc | 191 | |
ec3f896c | 192 | If non-zero, this hook should be safe to apply to any frame, |
a3c87d4e | 193 | whether or not it can support scroll bars, and whether or not it is |
ec3f896c | 194 | currently displaying them. */ |
ec5d8db7 | 195 | extern void (*judge_scroll_bars_hook) P_ ((struct frame *FRAME)); |
20a558dc | 196 | |
ec3f896c JB |
197 | \f |
198 | /* Input queue declarations and hooks. */ | |
20a558dc | 199 | |
80856e74 | 200 | /* Expedient hack: only provide the below definitions to files that |
026b8c1e | 201 | are prepared to handle lispy things. CONSP is defined iff lisp.h |
265a9e55 | 202 | has been included before this file. */ |
23c6349c | 203 | #ifdef CONSP |
80856e74 | 204 | |
351c638e RS |
205 | enum event_kind |
206 | { | |
207 | no_event, /* nothing happened. This should never | |
80856e74 | 208 | actually appear in the event queue. */ |
f05ddc05 JB |
209 | |
210 | ascii_keystroke, /* The ASCII code is in .code, perhaps | |
211 | with modifiers applied. | |
212 | .modifiers holds the state of the | |
213 | modifier keys. | |
ec3f896c JB |
214 | .frame_or_window is the frame in |
215 | which the key was typed. | |
265a9e55 JB |
216 | .timestamp gives a timestamp (in |
217 | milliseconds) for the keystroke. */ | |
4ff939ad KH |
218 | multibyte_char_keystroke, /* The multibye char code is in .code, |
219 | perhaps with modifiers applied. | |
220 | The others are the same as | |
221 | ascii_keystroke. This type of event | |
222 | is generated only when we are using | |
223 | XIM on X window. */ | |
351c638e | 224 | non_ascii_keystroke, /* .code is a number identifying the |
80856e74 JB |
225 | function key. A code N represents |
226 | a key whose name is | |
227 | function_key_names[N]; function_key_names | |
228 | is a table in keyboard.c to which you | |
229 | should feel free to add missing keys. | |
230 | .modifiers holds the state of the | |
62c07cc7 | 231 | modifier keys. |
ec3f896c JB |
232 | .frame_or_window is the frame in |
233 | which the key was typed. | |
265a9e55 JB |
234 | .timestamp gives a timestamp (in |
235 | milliseconds) for the keystroke. */ | |
b962d6c6 | 236 | timer_event, /* A timer fired. */ |
351c638e | 237 | mouse_click, /* The button number is in .code; it must |
a1867fb1 JB |
238 | be >= 0 and < NUM_MOUSE_BUTTONS, defined |
239 | below. | |
80856e74 JB |
240 | .modifiers holds the state of the |
241 | modifier keys. | |
242 | .x and .y give the mouse position, | |
1113d9db | 243 | in characters, within the window. |
ec3f896c JB |
244 | .frame_or_window gives the frame |
245 | the mouse click occurred in. | |
80856e74 JB |
246 | .timestamp gives a timestamp (in |
247 | milliseconds) for the click. */ | |
ab8f1008 | 248 | #ifdef WINDOWSNT |
523812cd RS |
249 | mouse_wheel, /* A mouse-wheel event is generated |
250 | on WINDOWSNT by a | |
ab8f1008 GV |
251 | wheel on a mouse (e.g., MS Intellimouse). |
252 | The event contains a delta that corresponds | |
253 | to the amount and direction that the wheel | |
254 | is rotated. This delta is typically | |
255 | used to implement a scroll or zoom. | |
256 | .code gives the delta. | |
257 | .modifiers holds the state of the | |
258 | modifier keys. | |
259 | .x and .y give the mouse position, | |
260 | in characters, within the window. | |
261 | .frame_or_window gives the frame | |
262 | the wheel event occurred in. | |
263 | .timestamp gives a timestamp (in | |
264 | milliseconds) for the wheel event. */ | |
dba46b7c GV |
265 | language_change_event, /* A language_change event is generated |
266 | on WINDOWSNT when the keyboard layout | |
267 | or input language is changed by the | |
268 | user. */ | |
ab8f1008 | 269 | #endif |
351c638e | 270 | scroll_bar_click, /* .code gives the number of the mouse button |
20a558dc JB |
271 | that was clicked. |
272 | .modifiers holds the state of the modifier | |
273 | keys. | |
80856e74 | 274 | .part is a lisp symbol indicating which |
a3c87d4e | 275 | part of the scroll bar got clicked. |
20a558dc JB |
276 | .x gives the distance from the start of the |
277 | scroll bar of the click; .y gives the total | |
278 | length of the scroll bar. | |
ec3f896c | 279 | .frame_or_window gives the window |
a3c87d4e | 280 | whose scroll bar was clicked in. |
80856e74 JB |
281 | .timestamp gives a timestamp (in |
282 | milliseconds) for the click. */ | |
33d5f42a | 283 | #ifdef WINDOWSNT |
fbd6baed | 284 | w32_scroll_bar_click, /* as for scroll_bar_click, but only generated |
33d5f42a RS |
285 | by MS-Windows scroll bar controls. */ |
286 | #endif | |
351c638e RS |
287 | selection_request_event, /* Another X client wants a selection from us. |
288 | See `struct selection_event'. */ | |
3a6b074b | 289 | selection_clear_event, /* Another X client cleared our selection. */ |
026b8c1e | 290 | buffer_switch_event, /* A process filter has switched buffers. */ |
765a05bc | 291 | delete_window_event, /* An X client said "delete this window". */ |
4d92e48d | 292 | MENU_BAR_EVENT, /* An event generated by the menu bar. |
b90afe71 | 293 | The frame_or_window field's cdr holds the |
765a05bc RS |
294 | Lisp-level event value. |
295 | (Only the toolkit version uses these.) */ | |
f2afbef6 | 296 | iconify_event, /* An X client iconified this window. */ |
c8b5ebed | 297 | deiconify_event, /* An X client deiconified this window. */ |
6820433e | 298 | menu_bar_activate_event, /* A button press in the menu bar |
c8b5ebed | 299 | (toolkit version only). */ |
b9818d19 | 300 | drag_n_drop, /* A drag-n-drop event is generated when |
523812cd RS |
301 | files selected outside of Emacs are dropped |
302 | onto an Emacs window. | |
303 | Currently used only on Windows NT. | |
304 | .modifiers holds the state of the | |
305 | modifier keys. | |
306 | .x and .y give the mouse position, | |
307 | in characters, within the window. | |
308 | .frame_or_window is a cons of the frame | |
309 | in which the drop was made and a list of | |
310 | the filenames of the dropped files. | |
311 | .timestamp gives a timestamp (in | |
312 | milliseconds) for the click. */ | |
4d92e48d GM |
313 | USER_SIGNAL_EVENT, /* A user signal. |
314 | code is a number identifying it, | |
6820433e GM |
315 | index into lispy_user_signals. */ |
316 | ||
4d92e48d GM |
317 | /* Help events. Member `frame_or_window' of the input_event is the |
318 | frame on which the event occurred, and member `arg' contains | |
319 | the help to show. */ | |
6820433e GM |
320 | HELP_EVENT, |
321 | ||
4d92e48d GM |
322 | /* An event from a tool-bar. Member `arg' of the input event |
323 | contains the tool-bar item selected. If `frame_or_window' | |
324 | and `arg' are equal, this is a prefix event. */ | |
0f98c4c2 GM |
325 | TOOL_BAR_EVENT, |
326 | ||
327 | /* Queued from XTread_socket on FocusIn events. Translated into | |
328 | `switch-frame' events in kbd_buffer_get_event, if necessary. */ | |
329 | FOCUS_IN_EVENT | |
351c638e RS |
330 | }; |
331 | ||
332 | /* If a struct input_event has a kind which is selection_request_event | |
333 | or selection_clear_event, then its contents are really described | |
334 | by `struct selection_event'; see xterm.h. */ | |
335 | ||
336 | /* The keyboard input buffer is an array of these structures. Each one | |
337 | represents some sort of input event - a keystroke, a mouse click, or | |
338 | a window system event. These get turned into their lispy forms when | |
339 | they are removed from the event queue. */ | |
340 | ||
f879067d RS |
341 | struct input_event |
342 | { | |
351c638e | 343 | /* What kind of event was this? */ |
a9dff54b | 344 | enum event_kind kind; |
80856e74 | 345 | |
4ff939ad KH |
346 | /* For an ascii_keystroke and multibyte_char_keystroke, this is the |
347 | character. | |
653dfe64 | 348 | For a non_ascii_keystroke, this is the keysym code. |
9257d374 | 349 | For a mouse event, this is the button number. */ |
ab8f1008 | 350 | /* In WindowsNT, for a mouse wheel event, this is the delta. */ |
653dfe64 | 351 | int code; |
a3c87d4e | 352 | enum scroll_bar_part part; |
ec3f896c | 353 | |
46cfcdb4 RS |
354 | int modifiers; /* See enum below for interpretation. */ |
355 | ||
356 | Lisp_Object x, y; | |
357 | unsigned long timestamp; | |
358 | ||
f879067d RS |
359 | /* This is padding just to put the frame_or_window field |
360 | past the size of struct selection_event. */ | |
361 | int *padding[2]; | |
362 | ||
ec3f896c JB |
363 | /* This field is copied into a vector while the event is in the queue, |
364 | so that garbage collections won't kill it. */ | |
b90afe71 KH |
365 | /* In a menu_bar_event, this is a cons cell whose car is the frame |
366 | and whose cdr is the Lisp object that is the event's value. */ | |
46cfcdb4 RS |
367 | /* This field is last so that struct selection_input_event |
368 | does not overlap with it. */ | |
ec3f896c | 369 | Lisp_Object frame_or_window; |
4d92e48d GM |
370 | |
371 | /* Additional event argument. This is used for TOOL_BAR_EVENTs and | |
372 | HELP_EVENTs and avoids calling Fcons during signal handling. */ | |
373 | Lisp_Object arg; | |
80856e74 | 374 | }; |
ec5d8db7 AS |
375 | |
376 | /* Called to read input events. */ | |
377 | extern int (*read_socket_hook) P_ ((int, struct input_event *, int, int)); | |
378 | ||
379 | /* Called when a frame's display becomes entirely up to date. */ | |
380 | extern void (*frame_up_to_date_hook) P_ ((struct frame *)); | |
351c638e | 381 | \f |
a1867fb1 | 382 | |
21cec071 JB |
383 | /* Bits in the modifiers member of the input_event structure. |
384 | Note that reorder_modifiers assumes that the bits are in canonical | |
a1867fb1 JB |
385 | order. |
386 | ||
387 | The modifiers applied to mouse clicks are rather ornate. The | |
388 | window-system-specific code should store mouse clicks with | |
45288343 JB |
389 | up_modifier or down_modifier set. Having an explicit down modifier |
390 | simplifies some of window-system-independent code; without it, the | |
391 | code would have to recognize down events by checking if the event | |
392 | is a mouse click lacking the click and drag modifiers. | |
393 | ||
394 | The window-system independent code turns all up_modifier events | |
fbcd35bd JB |
395 | bits into drag_modifier, click_modifier, double_modifier, or |
396 | triple_modifier events. The click_modifier has no written | |
397 | representation in the names of the symbols used as event heads, | |
398 | but it does appear in the Qevent_symbol_components property of the | |
399 | event heads. */ | |
80856e74 | 400 | enum { |
a1867fb1 JB |
401 | up_modifier = 1, /* Only used on mouse buttons - always |
402 | turned into a click or a drag modifier | |
403 | before lisp code sees the event. */ | |
d82222e1 JB |
404 | down_modifier = 2, /* Only used on mouse buttons. */ |
405 | drag_modifier = 4, /* This is never used in the event | |
a1867fb1 JB |
406 | queue; it's only used internally by |
407 | the window-system-independent code. */ | |
d82222e1 | 408 | click_modifier= 8, /* See drag_modifier. */ |
fbcd35bd JB |
409 | double_modifier= 16, /* See drag_modifier. */ |
410 | triple_modifier= 32, /* See drag_modifier. */ | |
d82222e1 JB |
411 | |
412 | /* The next four modifier bits are used also in keyboard events at | |
413 | the Lisp level. | |
414 | ||
415 | It's probably not the greatest idea to use the 2^23 bit for any | |
416 | modifier. It may or may not be the sign bit, depending on | |
417 | VALBITS, so using it to represent a modifier key means that | |
418 | characters thus modified have different integer equivalents | |
419 | depending on the architecture they're running on. Oh, and | |
420 | applying XINT to a character whose 2^23 bit is set sign-extends | |
421 | it, so you get a bunch of bits in the mask you didn't want. | |
422 | ||
423 | The CHAR_ macros are defined in lisp.h. */ | |
424 | alt_modifier = CHAR_ALT, /* Under X, the XK_Alt_[LR] keysyms. */ | |
425 | super_modifier= CHAR_SUPER, /* Under X, the XK_Super_[LR] keysyms. */ | |
426 | hyper_modifier= CHAR_HYPER, /* Under X, the XK_Hyper_[LR] keysyms. */ | |
427 | shift_modifier= CHAR_SHIFT, | |
428 | ctrl_modifier = CHAR_CTL, | |
6cd195e2 | 429 | meta_modifier = CHAR_META /* Under X, the XK_Meta_[LR] keysyms. */ |
80856e74 JB |
430 | }; |
431 | ||
80856e74 | 432 | #endif |