25829
|
1 @c This is part of the Emacs manual.
|
36553
|
2 @c Copyright (C) 1985, 86, 87, 93, 94, 95, 97, 99, 2000, 2001
|
28126
|
3 @c Free Software Foundation, Inc.
|
25829
|
4 @c See file emacs.texi for copying conditions.
|
|
5 @node Frames, International, Windows, Top
|
|
6 @chapter Frames and X Windows
|
|
7 @cindex frames
|
|
8
|
|
9 When using the X Window System, you can create multiple windows at the
|
|
10 X level in a single Emacs session. Each X window that belongs to Emacs
|
|
11 displays a @dfn{frame} which can contain one or several Emacs windows.
|
|
12 A frame initially contains a single general-purpose Emacs window which
|
|
13 you can subdivide vertically or horizontally into smaller windows. A
|
|
14 frame normally contains its own echo area and minibuffer, but you can
|
|
15 make frames that don't have these---they use the echo area and
|
|
16 minibuffer of another frame.
|
|
17
|
|
18 Editing you do in one frame also affects the other frames. For
|
|
19 instance, if you put text in the kill ring in one frame, you can yank it
|
|
20 in another frame. If you exit Emacs through @kbd{C-x C-c} in one frame,
|
|
21 it terminates all the frames. To delete just one frame, use @kbd{C-x 5
|
37121
|
22 0} (that is zero, not @kbd{o}).
|
25829
|
23
|
|
24 To avoid confusion, we reserve the word ``window'' for the
|
|
25 subdivisions that Emacs implements, and never use it to refer to a
|
|
26 frame.
|
|
27
|
|
28 Emacs compiled for MS-DOS emulates some aspects of the window system
|
|
29 so that you can use many of the features described in this chapter.
|
|
30 @xref{MS-DOS Input}, for more information.
|
|
31
|
27224
|
32 @cindex MS Windows
|
|
33 Emacs compiled for MS Windows mostly supports the same features as
|
49453
|
34 under X.
|
27224
|
35
|
25829
|
36 @menu
|
|
37 * Mouse Commands:: Moving, cutting, and pasting, with the mouse.
|
|
38 * Secondary Selection:: Cutting without altering point and mark.
|
33920
|
39 * Clipboard:: Using the clipboard for selections.
|
25829
|
40 * Mouse References:: Using the mouse to select an item from a list.
|
|
41 * Menu Mouse Clicks:: Mouse clicks that bring up menus.
|
|
42 * Mode Line Mouse:: Mouse clicks on the mode line.
|
36156
|
43 * Creating Frames:: Creating additional Emacs frames with various contents.
|
|
44 * Frame Commands:: Iconifying, deleting, and switching frames.
|
25829
|
45 * Speedbar:: How to make and use a speedbar frame.
|
|
46 * Multiple Displays:: How one Emacs job can talk to several displays.
|
|
47 * Special Buffer Frames:: You can make certain buffers have their own frames.
|
|
48 * Frame Parameters:: Changing the colors and other modes of frames.
|
|
49 * Scroll Bars:: How to enable and disable scroll bars; how to use them.
|
27224
|
50 * Wheeled Mice:: Using mouse wheels for scrolling.
|
53792
|
51 * Drag and drop:: Using drag and drop to open files and insert text.
|
25829
|
52 * Menu Bars:: Enabling and disabling the menu bar.
|
31609
|
53 * Tool Bars:: Enabling and disabling the tool bar.
|
27224
|
54 * Dialog Boxes:: Controlling use of dialog boxes.
|
39267
|
55 * Tooltips:: Showing "tooltips", AKA "balloon help" for active text.
|
28124
|
56 * Mouse Avoidance:: Moving the mouse pointer out of the way.
|
25829
|
57 * Non-Window Terminals:: Multiple frames on terminals that show only one.
|
27224
|
58 * XTerm Mouse:: Using the mouse in an XTerm terminal emulator.
|
25829
|
59 @end menu
|
|
60
|
|
61 @node Mouse Commands
|
|
62 @section Mouse Commands for Editing
|
|
63 @cindex mouse buttons (what they do)
|
|
64
|
|
65 The mouse commands for selecting and copying a region are mostly
|
|
66 compatible with the @code{xterm} program. You can use the same mouse
|
|
67 commands for copying between Emacs and other X client programs.
|
|
68
|
36729
|
69 @kindex DELETE @r{(and mouse selection)}
|
25829
|
70 If you select a region with any of these mouse commands, and then
|
|
71 immediately afterward type the @key{DELETE} function key, it deletes the
|
|
72 region that you selected. The @key{BACKSPACE} function key and the
|
52979
|
73 @acronym{ASCII} character @key{DEL} do not do this; if you type any other key
|
25829
|
74 in between the mouse command and @key{DELETE}, it does not do this.
|
|
75
|
|
76 @findex mouse-set-region
|
|
77 @findex mouse-set-point
|
|
78 @findex mouse-yank-at-click
|
|
79 @findex mouse-save-then-click
|
|
80 @kindex Mouse-1
|
|
81 @kindex Mouse-2
|
|
82 @kindex Mouse-3
|
|
83 @table @kbd
|
|
84 @item Mouse-1
|
|
85 Move point to where you click (@code{mouse-set-point}).
|
|
86 This is normally the left button.
|
|
87
|
|
88 @item Drag-Mouse-1
|
|
89 Set the region to the text you select by dragging, and copy it to the
|
|
90 kill ring (@code{mouse-set-region}). You can specify both ends of the
|
|
91 region with this single command.
|
|
92
|
|
93 @vindex mouse-scroll-min-lines
|
|
94 If you move the mouse off the top or bottom of the window while
|
|
95 dragging, the window scrolls at a steady rate until you move the mouse
|
|
96 back into the window. This way, you can select regions that don't fit
|
|
97 entirely on the screen. The number of lines scrolled per step depends
|
|
98 on how far away from the window edge the mouse has gone; the variable
|
|
99 @code{mouse-scroll-min-lines} specifies a minimum step size.
|
|
100
|
|
101 @item Mouse-2
|
|
102 Yank the last killed text, where you click (@code{mouse-yank-at-click}).
|
|
103 This is normally the middle button.
|
|
104
|
|
105 @item Mouse-3
|
|
106 This command, @code{mouse-save-then-kill}, has several functions
|
|
107 depending on where you click and the status of the region.
|
|
108
|
|
109 The most basic case is when you click @kbd{Mouse-1} in one place and
|
|
110 then @kbd{Mouse-3} in another. This selects the text between those two
|
|
111 positions as the region. It also copies the new region to the kill
|
|
112 ring, so that you can copy it to someplace else.
|
|
113
|
|
114 If you click @kbd{Mouse-1} in the text, scroll with the scroll bar, and
|
|
115 then click @kbd{Mouse-3}, it remembers where point was before scrolling
|
|
116 (where you put it with @kbd{Mouse-1}), and uses that position as the
|
|
117 other end of the region. This is so that you can select a region that
|
|
118 doesn't fit entirely on the screen.
|
|
119
|
|
120 More generally, if you do not have a highlighted region, @kbd{Mouse-3}
|
|
121 selects the text between point and the click position as the region. It
|
|
122 does this by setting the mark where point was, and moving point to where
|
|
123 you click.
|
|
124
|
|
125 If you have a highlighted region, or if the region was set just before
|
|
126 by dragging button 1, @kbd{Mouse-3} adjusts the nearer end of the region
|
|
127 by moving it to where you click. The adjusted region's text also
|
|
128 replaces the old region's text in the kill ring.
|
|
129
|
|
130 If you originally specified the region using a double or triple
|
|
131 @kbd{Mouse-1}, so that the region is defined to consist of entire words
|
|
132 or lines, then adjusting the region with @kbd{Mouse-3} also proceeds by
|
|
133 entire words or lines.
|
|
134
|
|
135 If you use @kbd{Mouse-3} a second time consecutively, at the same place,
|
|
136 that kills the region already selected.
|
|
137
|
|
138 @item Double-Mouse-1
|
|
139 This key sets the region around the word which you click on. If you
|
|
140 click on a character with ``symbol'' syntax (such as underscore, in C
|
|
141 mode), it sets the region around the symbol surrounding that character.
|
|
142
|
|
143 If you click on a character with open-parenthesis or close-parenthesis
|
38205
|
144 syntax, it sets the region around the parenthetical grouping
|
25829
|
145 which that character starts or ends. If you click on a character with
|
|
146 string-delimiter syntax (such as a singlequote or doublequote in C), it
|
|
147 sets the region around the string constant (using heuristics to figure
|
|
148 out whether that character is the beginning or the end of it).
|
|
149
|
|
150 @item Double-Drag-Mouse-1
|
|
151 This key selects a region made up of the words you drag across.
|
|
152
|
|
153 @item Triple-Mouse-1
|
|
154 This key sets the region around the line you click on.
|
|
155
|
|
156 @item Triple-Drag-Mouse-1
|
|
157 This key selects a region made up of the lines you drag across.
|
|
158 @end table
|
|
159
|
|
160 The simplest way to kill text with the mouse is to press @kbd{Mouse-1}
|
|
161 at one end, then press @kbd{Mouse-3} twice at the other end.
|
|
162 @xref{Killing}. To copy the text into the kill ring without deleting it
|
|
163 from the buffer, press @kbd{Mouse-3} just once---or just drag across the
|
|
164 text with @kbd{Mouse-1}. Then you can copy it elsewhere by yanking it.
|
|
165
|
|
166 @vindex mouse-yank-at-point
|
|
167 To yank the killed or copied text somewhere else, move the mouse there
|
|
168 and press @kbd{Mouse-2}. @xref{Yanking}. However, if
|
|
169 @code{mouse-yank-at-point} is non-@code{nil}, @kbd{Mouse-2} yanks at
|
|
170 point. Then it does not matter where you click, or even which of the
|
|
171 frame's windows you click on. The default value is @code{nil}. This
|
|
172 variable also affects yanking the secondary selection.
|
|
173
|
|
174 @cindex cutting and X
|
|
175 @cindex pasting and X
|
|
176 @cindex X cutting and pasting
|
|
177 To copy text to another X window, kill it or save it in the kill ring.
|
|
178 Under X, this also sets the @dfn{primary selection}. Then use the
|
|
179 ``paste'' or ``yank'' command of the program operating the other window
|
|
180 to insert the text from the selection.
|
|
181
|
37234
|
182 To copy text from another X window, use the ``cut'' or ``copy''
|
|
183 command of the program operating the other window, to select the text
|
|
184 you want. Then yank it in Emacs with @kbd{C-y} or @kbd{Mouse-2}.
|
|
185
|
43561
|
186 The standard coding system for X selections is
|
|
187 @code{compound-text-with-extensions}. To specify another coding
|
|
188 system for X selections, use @kbd{C-x @key{RET} x} or @kbd{C-x
|
|
189 @key{RET} X}. @xref{Specify Coding}.
|
25829
|
190
|
|
191 These cutting and pasting commands also work on MS-Windows.
|
|
192
|
|
193 @cindex primary selection
|
|
194 @cindex cut buffer
|
|
195 @cindex selection, primary
|
|
196 @vindex x-cut-buffer-max
|
|
197 When Emacs puts text into the kill ring, or rotates text to the front
|
|
198 of the kill ring, it sets the @dfn{primary selection} in the X server.
|
|
199 This is how other X clients can access the text. Emacs also stores the
|
|
200 text in the cut buffer, but only if the text is short enough
|
37121
|
201 (the value of @code{x-cut-buffer-max} specifies the maximum number of
|
|
202 characters); putting long strings in the cut buffer can be slow.
|
25829
|
203
|
|
204 The commands to yank the first entry in the kill ring actually check
|
|
205 first for a primary selection in another program; after that, they check
|
|
206 for text in the cut buffer. If neither of those sources provides text
|
|
207 to yank, the kill ring contents are used.
|
|
208
|
|
209 @node Secondary Selection
|
|
210 @section Secondary Selection
|
|
211 @cindex secondary selection
|
|
212
|
|
213 The @dfn{secondary selection} is another way of selecting text using
|
|
214 X. It does not use point or the mark, so you can use it to kill text
|
|
215 without setting point or the mark.
|
|
216
|
|
217 @table @kbd
|
|
218 @findex mouse-set-secondary
|
|
219 @kindex M-Drag-Mouse-1
|
|
220 @item M-Drag-Mouse-1
|
|
221 Set the secondary selection, with one end at the place where you press
|
|
222 down the button, and the other end at the place where you release it
|
|
223 (@code{mouse-set-secondary}). The highlighting appears and changes as
|
37121
|
224 you drag. You can control the appearance of the highlighting by
|
|
225 customizing the @code{secondary-selection} face (@pxref{Face
|
|
226 Customization}).
|
25829
|
227
|
|
228 If you move the mouse off the top or bottom of the window while
|
|
229 dragging, the window scrolls at a steady rate until you move the mouse
|
|
230 back into the window. This way, you can mark regions that don't fit
|
|
231 entirely on the screen.
|
|
232
|
|
233 @findex mouse-start-secondary
|
|
234 @kindex M-Mouse-1
|
|
235 @item M-Mouse-1
|
|
236 Set one endpoint for the @dfn{secondary selection}
|
|
237 (@code{mouse-start-secondary}).
|
|
238
|
|
239 @findex mouse-secondary-save-then-kill
|
|
240 @kindex M-Mouse-3
|
|
241 @item M-Mouse-3
|
|
242 Make a secondary selection, using the place specified with @kbd{M-Mouse-1}
|
|
243 as the other end (@code{mouse-secondary-save-then-kill}). A second click
|
|
244 at the same place kills the secondary selection just made.
|
|
245
|
|
246 @findex mouse-yank-secondary
|
|
247 @kindex M-Mouse-2
|
|
248 @item M-Mouse-2
|
|
249 Insert the secondary selection where you click
|
|
250 (@code{mouse-yank-secondary}). This places point at the end of the
|
|
251 yanked text.
|
|
252 @end table
|
|
253
|
|
254 Double or triple clicking of @kbd{M-Mouse-1} operates on words and
|
|
255 lines, much like @kbd{Mouse-1}.
|
|
256
|
|
257 If @code{mouse-yank-at-point} is non-@code{nil}, @kbd{M-Mouse-2}
|
|
258 yanks at point. Then it does not matter precisely where you click; all
|
|
259 that matters is which window you click on. @xref{Mouse Commands}.
|
|
260
|
33920
|
261 @node Clipboard
|
|
262 @section Using the Clipboard
|
|
263 @cindex X clipboard
|
|
264 @cindex clipboard
|
|
265 @vindex x-select-enable-clipboard
|
|
266 @findex menu-bar-enable-clipboard
|
|
267 @cindex OpenWindows
|
|
268 @cindex Gnome
|
|
269
|
36156
|
270 As well as the primary and secondary selection types, X supports a
|
33920
|
271 @dfn{clipboard} selection type which is used by some applications,
|
|
272 particularly under OpenWindows and Gnome.
|
|
273
|
36156
|
274 The command @kbd{M-x menu-bar-enable-clipboard} makes the @code{Cut},
|
33920
|
275 @code{Paste} and @code{Copy} menu items, as well as the keys of the same
|
|
276 names, all use the clipboard.
|
49600
|
277
|
36156
|
278 You can customize the option @code{x-select-enable-clipboard} to make
|
33920
|
279 the Emacs yank functions consult the clipboard before the primary
|
|
280 selection, and to make the kill functions to store in the clipboard as
|
|
281 well as the primary selection. Otherwise they do not access the
|
|
282 clipboard at all. Using the clipboard is the default on MS-Windows,
|
|
283 unlike most systems.
|
|
284
|
25829
|
285 @node Mouse References
|
|
286 @section Following References with the Mouse
|
|
287 @kindex Mouse-2 @r{(selection)}
|
|
288
|
|
289 Some Emacs buffers display lists of various sorts. These include
|
|
290 lists of files, of buffers, of possible completions, of matches for
|
|
291 a pattern, and so on.
|
|
292
|
|
293 Since yanking text into these buffers is not very useful, most of them
|
|
294 define @kbd{Mouse-2} specially, as a command to use or view the item you
|
|
295 click on.
|
|
296
|
|
297 For example, if you click @kbd{Mouse-2} on a file name in a Dired
|
|
298 buffer, you visit that file. If you click @kbd{Mouse-2} on an error
|
|
299 message in the @samp{*Compilation*} buffer, you go to the source code
|
|
300 for that error message. If you click @kbd{Mouse-2} on a completion in
|
|
301 the @samp{*Completions*} buffer, you choose that completion.
|
|
302
|
45879
|
303 @vindex mouse-highlight
|
25829
|
304 You can usually tell when @kbd{Mouse-2} has this special sort of
|
|
305 meaning because the sensitive text highlights when you move the mouse
|
45879
|
306 over it. The variable @code{mouse-highlight} controls whether to do
|
|
307 this highlighting always (even when such text appears where the mouse
|
|
308 already is), never, or only immediately after you move the mouse.
|
25829
|
309
|
|
310 @node Menu Mouse Clicks
|
|
311 @section Mouse Clicks for Menus
|
|
312
|
|
313 Mouse clicks modified with the @key{CTRL} and @key{SHIFT} keys
|
|
314 bring up menus.
|
|
315
|
|
316 @table @kbd
|
|
317 @item C-Mouse-1
|
30872
|
318 @kindex C-Mouse-1
|
25829
|
319 This menu is for selecting a buffer.
|
|
320
|
36504
|
321 The MSB (``mouse select buffer'') global minor mode makes this
|
|
322 menu smarter and more customizable. @xref{Buffer Menus}.
|
30872
|
323
|
25829
|
324 @item C-Mouse-2
|
30872
|
325 @kindex C-Mouse-2
|
25829
|
326 This menu is for specifying faces and other text properties
|
|
327 for editing formatted text. @xref{Formatted Text}.
|
|
328
|
|
329 @item C-Mouse-3
|
30872
|
330 @kindex C-Mouse-3
|
|
331 This menu is mode-specific. For most modes if Menu-bar mode is on, this
|
|
332 menu has the same items as all the mode-specific menu-bar menus put
|
|
333 together. Some modes may specify a different menu for this
|
|
334 button.@footnote{Some systems use @kbd{Mouse-3} for a mode-specific
|
|
335 menu. We took a survey of users, and found they preferred to keep
|
|
336 @kbd{Mouse-3} for selecting and killing regions. Hence the decision to
|
|
337 use @kbd{C-Mouse-3} for this menu.} If Menu-bar mode is off, this menu
|
|
338 contains all the items which would be present in the menu bar---not just
|
|
339 the mode-specific ones---so that you can access them without having to
|
|
340 display the menu bar.
|
25829
|
341
|
36156
|
342 @item S-Mouse-1
|
25829
|
343 This menu is for specifying the frame's principal font.
|
|
344 @end table
|
|
345
|
|
346 @node Mode Line Mouse
|
|
347 @section Mode Line Mouse Commands
|
30872
|
348 @cindex mode line, mouse
|
|
349 @cindex mouse on mode line
|
25829
|
350
|
|
351 You can use mouse clicks on window mode lines to select and manipulate
|
|
352 windows.
|
|
353
|
|
354 @table @kbd
|
|
355 @item Mouse-1
|
36156
|
356 @kindex Mouse-1 @r{(mode line)}
|
25829
|
357 @kbd{Mouse-1} on a mode line selects the window above. By dragging
|
|
358 @kbd{Mouse-1} on the mode line, you can move it, thus changing the
|
|
359 height of the windows above and below.
|
|
360
|
|
361 @item Mouse-2
|
36156
|
362 @kindex Mouse-2 @r{(mode line)}
|
25829
|
363 @kbd{Mouse-2} on a mode line expands that window to fill its frame.
|
|
364
|
|
365 @item Mouse-3
|
36156
|
366 @kindex Mouse-3 @r{(mode line)}
|
35954
c869b148aa3f
Document what does mouse-3 do on the mode line if there's only one window.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
367 @kbd{Mouse-3} on a mode line deletes the window above. If the frame has
|
c869b148aa3f
Document what does mouse-3 do on the mode line if there's only one window.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
368 only one window, it buries the current buffer instead and switches to
|
c869b148aa3f
Document what does mouse-3 do on the mode line if there's only one window.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
369 another buffer.
|
25829
|
370
|
|
371 @item C-Mouse-2
|
36156
|
372 @kindex C-mouse-2 @r{(mode line)}
|
25829
|
373 @kbd{C-Mouse-2} on a mode line splits the window above
|
|
374 horizontally, above the place in the mode line where you click.
|
|
375 @end table
|
|
376
|
36156
|
377 @kindex C-Mouse-2 @r{(scroll bar)}
|
25829
|
378 @kbd{C-Mouse-2} on a scroll bar splits the corresponding window
|
37121
|
379 vertically, unless you are using an X toolkit's implementation of
|
36156
|
380 scroll bars. @xref{Split Window}.
|
25829
|
381
|
36156
|
382 The commands above apply to areas of the mode line which do not have
|
|
383 special mouse bindings of their own. Some areas, such as the buffer
|
|
384 name and the major mode name, have their own special mouse bindings.
|
|
385 Emacs displays information about these bindings when you hold the
|
37121
|
386 mouse over such a place (@pxref{Tooltips}).
|
27224
|
387
|
25829
|
388 @node Creating Frames
|
|
389 @section Creating Frames
|
|
390 @cindex creating frames
|
|
391
|
|
392 @kindex C-x 5
|
|
393 The prefix key @kbd{C-x 5} is analogous to @kbd{C-x 4}, with parallel
|
|
394 subcommands. The difference is that @kbd{C-x 5} commands create a new
|
|
395 frame rather than just a new window in the selected frame (@pxref{Pop
|
|
396 Up Window}). If an existing visible or iconified frame already displays
|
|
397 the requested material, these commands use the existing frame, after
|
49600
|
398 raising or deiconifying as necessary.
|
25829
|
399
|
|
400 The various @kbd{C-x 5} commands differ in how they find or create the
|
|
401 buffer to select:
|
|
402
|
|
403 @table @kbd
|
|
404 @item C-x 5 2
|
|
405 @kindex C-x 5 2
|
|
406 @findex make-frame-command
|
|
407 Create a new frame (@code{make-frame-command}).
|
|
408 @item C-x 5 b @var{bufname} @key{RET}
|
|
409 Select buffer @var{bufname} in another frame. This runs
|
|
410 @code{switch-to-buffer-other-frame}.
|
|
411 @item C-x 5 f @var{filename} @key{RET}
|
|
412 Visit file @var{filename} and select its buffer in another frame. This
|
|
413 runs @code{find-file-other-frame}. @xref{Visiting}.
|
|
414 @item C-x 5 d @var{directory} @key{RET}
|
|
415 Select a Dired buffer for directory @var{directory} in another frame.
|
|
416 This runs @code{dired-other-frame}. @xref{Dired}.
|
|
417 @item C-x 5 m
|
|
418 Start composing a mail message in another frame. This runs
|
|
419 @code{mail-other-frame}. It is the other-frame variant of @kbd{C-x m}.
|
|
420 @xref{Sending Mail}.
|
|
421 @item C-x 5 .
|
|
422 Find a tag in the current tag table in another frame. This runs
|
|
423 @code{find-tag-other-frame}, the multiple-frame variant of @kbd{M-.}.
|
|
424 @xref{Tags}.
|
|
425 @item C-x 5 r @var{filename} @key{RET}
|
|
426 @kindex C-x 5 r
|
|
427 @findex find-file-read-only-other-frame
|
|
428 Visit file @var{filename} read-only, and select its buffer in another
|
|
429 frame. This runs @code{find-file-read-only-other-frame}.
|
|
430 @xref{Visiting}.
|
|
431 @end table
|
|
432
|
|
433 @cindex default-frame-alist
|
|
434 @cindex initial-frame-alist
|
|
435 You can control the appearance of new frames you create by setting the
|
|
436 frame parameters in @code{default-frame-alist}. You can use the
|
|
437 variable @code{initial-frame-alist} to specify parameters that affect
|
|
438 only the initial frame. @xref{Initial Parameters,,, elisp, The Emacs
|
|
439 Lisp Reference Manual}, for more information.
|
|
440
|
|
441 @cindex font (default)
|
|
442 The easiest way to specify the principal font for all your Emacs
|
|
443 frames is with an X resource (@pxref{Font X}), but you can also do it by
|
|
444 modifying @code{default-frame-alist} to specify the @code{font}
|
|
445 parameter, as shown here:
|
|
446
|
|
447 @example
|
|
448 (add-to-list 'default-frame-alist '(font . "10x20"))
|
|
449 @end example
|
|
450
|
38670
|
451 @noindent
|
|
452 Here's a similar example for specifying a foreground color:
|
|
453
|
|
454 @example
|
|
455 (add-to-list 'default-frame-alist '(background-color . "blue"))
|
|
456 @end example
|
|
457
|
|
458
|
36156
|
459 @node Frame Commands
|
|
460 @section Frame Commands
|
|
461
|
|
462 The following commands let you create, delete and operate on frames:
|
|
463
|
|
464 @table @kbd
|
|
465 @item C-z
|
|
466 @kindex C-z @r{(X windows)}
|
|
467 @findex iconify-or-deiconify-frame
|
|
468 Iconify the selected Emacs frame (@code{iconify-or-deiconify-frame}).
|
|
469 The normal meaning of @kbd{C-z}, to suspend Emacs, is not useful under a
|
|
470 window system, so it has a different binding in that case.
|
|
471
|
|
472 If you type this command on an Emacs frame's icon, it deiconifies the frame.
|
|
473
|
|
474 @item C-x 5 0
|
|
475 @kindex C-x 5 0
|
|
476 @findex delete-frame
|
|
477 Delete the selected frame (@code{delete-frame}). This is not allowed if
|
|
478 there is only one frame.
|
|
479
|
|
480 @item C-x 5 o
|
|
481 @kindex C-x 5 o
|
|
482 @findex other-frame
|
|
483 Select another frame, raise it, and warp the mouse to it so that it
|
|
484 stays selected. If you repeat this command, it cycles through all the
|
|
485 frames on your terminal.
|
|
486
|
|
487 @item C-x 5 1
|
|
488 @kindex C-x 5 1
|
|
489 @findex delete-other-frames
|
|
490 Delete all frames except the selected one.
|
|
491 @end table
|
|
492
|
43438
|
493 @vindex focus-follows-mouse
|
|
494 To make the command @kbd{C-x 5 o} work properly, you must tell Emacs
|
|
495 how the system (or the window manager) generally handles
|
|
496 focus-switching between windows. There are two possibilities: either
|
|
497 simply moving the mouse onto a window selects it (gives it focus), or
|
|
498 you have to click on it in a suitable way to do so. Unfortunately
|
|
499 there is no way Emacs can find out automatically which way the system
|
|
500 handles this, so you have to explicitly say, by setting the variable
|
|
501 @code{focus-follows-mouse}. If just moving the mouse onto a window
|
|
502 selects it, that variable should be @code{t}; if a click is necessary,
|
|
503 the variable should be @code{nil}.
|
|
504
|
25829
|
505 @node Speedbar
|
|
506 @section Making and Using a Speedbar Frame
|
|
507 @cindex speedbar
|
|
508
|
|
509 An Emacs frame can have a @dfn{speedbar}, which is a vertical window
|
|
510 that serves as a scrollable menu of files you could visit and tags
|
|
511 within those files. To create a speedbar, type @kbd{M-x speedbar}; this
|
|
512 creates a speedbar window for the selected frame. From then on, you can
|
|
513 click on a file name in the speedbar to visit that file in the
|
|
514 corresponding Emacs frame, or click on a tag name to jump to that tag in
|
|
515 the Emacs frame.
|
|
516
|
|
517 Initially the speedbar lists the immediate contents of the current
|
|
518 directory, one file per line. Each line also has a box, @samp{[+]} or
|
|
519 @samp{<+>}, that you can click on with @kbd{Mouse-2} to ``open up'' the
|
|
520 contents of that item. If the line names a directory, opening it adds
|
|
521 the contents of that directory to the speedbar display, underneath the
|
|
522 directory's own line. If the line lists an ordinary file, opening it up
|
|
523 adds a list of the tags in that file to the speedbar display. When a
|
|
524 file is opened up, the @samp{[+]} changes to @samp{[-]}; you can click
|
|
525 on that box to ``close up'' that file (hide its contents).
|
|
526
|
|
527 Some major modes, including Rmail mode, Info, and GUD, have
|
|
528 specialized ways of putting useful items into the speedbar for you to
|
|
529 select. For example, in Rmail mode, the speedbar shows a list of Rmail
|
|
530 files, and lets you move the current message to another Rmail file by
|
|
531 clicking on its @samp{<M>} box.
|
|
532
|
|
533 A speedbar belongs to one Emacs frame, and always operates on that
|
|
534 frame. If you use multiple frames, you can make a speedbar for some or
|
|
535 all of the frames; type @kbd{M-x speedbar} in any given frame to make a
|
|
536 speedbar for it.
|
|
537
|
|
538 @node Multiple Displays
|
|
539 @section Multiple Displays
|
|
540 @cindex multiple displays
|
|
541
|
35188
94d46968a93f
Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
542 A single Emacs can talk to more than one X display. Initially, Emacs
|
94d46968a93f
Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
543 uses just one display---the one specified with the @env{DISPLAY}
|
94d46968a93f
Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
544 environment variable or with the @samp{--display} option (@pxref{Initial
|
94d46968a93f
Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
545 Options}). To connect to another display, use the command
|
94d46968a93f
Don't say "X Windows". From Colin Walters <walters@cis.ohio-state.edu>.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
546 @code{make-frame-on-display}:
|
25829
|
547
|
|
548 @findex make-frame-on-display
|
|
549 @table @kbd
|
|
550 @item M-x make-frame-on-display @key{RET} @var{display} @key{RET}
|
|
551 Create a new frame on display @var{display}.
|
|
552 @end table
|
|
553
|
|
554 A single X server can handle more than one screen. When you open
|
|
555 frames on two screens belonging to one server, Emacs knows they share a
|
|
556 single keyboard, and it treats all the commands arriving from these
|
|
557 screens as a single stream of input.
|
|
558
|
|
559 When you open frames on different X servers, Emacs makes a separate
|
|
560 input stream for each server. This way, two users can type
|
|
561 simultaneously on the two displays, and Emacs will not garble their
|
|
562 input. Each server also has its own selected frame. The commands you
|
|
563 enter with a particular X server apply to that server's selected frame.
|
|
564
|
|
565 Despite these features, people using the same Emacs job from different
|
|
566 displays can still interfere with each other if they are not careful.
|
|
567 For example, if any one types @kbd{C-x C-c}, that exits the Emacs job
|
|
568 for all of them!
|
|
569
|
|
570 @node Special Buffer Frames
|
|
571 @section Special Buffer Frames
|
|
572
|
|
573 @vindex special-display-buffer-names
|
|
574 You can make certain chosen buffers, for which Emacs normally creates
|
|
575 a second window when you have just one window, appear in special frames
|
|
576 of their own. To do this, set the variable
|
|
577 @code{special-display-buffer-names} to a list of buffer names; any
|
|
578 buffer whose name is in that list automatically gets a special frame,
|
|
579 when an Emacs command wants to display it ``in another window.''
|
|
580
|
|
581 For example, if you set the variable this way,
|
|
582
|
|
583 @example
|
|
584 (setq special-display-buffer-names
|
|
585 '("*Completions*" "*grep*" "*tex-shell*"))
|
|
586 @end example
|
|
587
|
|
588 @noindent
|
|
589 then completion lists, @code{grep} output and the @TeX{} mode shell
|
|
590 buffer get individual frames of their own. These frames, and the
|
|
591 windows in them, are never automatically split or reused for any other
|
|
592 buffers. They continue to show the buffers they were created for,
|
|
593 unless you alter them by hand. Killing the special buffer deletes its
|
|
594 frame automatically.
|
|
595
|
|
596 @vindex special-display-regexps
|
|
597 More generally, you can set @code{special-display-regexps} to a list
|
|
598 of regular expressions; then a buffer gets its own frame if its name
|
|
599 matches any of those regular expressions. (Once again, this applies only
|
|
600 to buffers that normally get displayed for you in a separate window.)
|
|
601
|
|
602 @vindex special-display-frame-alist
|
|
603 The variable @code{special-display-frame-alist} specifies the frame
|
|
604 parameters for these frames. It has a default value, so you don't need
|
|
605 to set it.
|
|
606
|
|
607 For those who know Lisp, an element of
|
|
608 @code{special-display-buffer-names} or @code{special-display-regexps}
|
|
609 can also be a list. Then the first element is the buffer name or
|
|
610 regular expression; the rest of the list specifies how to create the
|
46206
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
611 frame. It can be an association list specifying frame parameter
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
612 values; these values take precedence over parameter values specified
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
613 in @code{special-display-frame-alist}. If you specify the symbol
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
614 @code{same-window} as a ``frame parameter'' in this list, with a
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
615 non-@code{nil} value, that means to use the selected window if
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
616 possible. If you use the symbol @code{same-frame} as a ``frame
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
617 parameter'' in this list, with a non-@code{nil} value, that means to
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
618 use the selected frame if possible.
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
619
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
620 Alternatively, the value can have this form:
|
25829
|
621
|
|
622 @example
|
|
623 (@var{function} @var{args}...)
|
|
624 @end example
|
|
625
|
|
626 @noindent
|
|
627 where @var{function} is a symbol. Then the frame is constructed by
|
|
628 calling @var{function}; its first argument is the buffer, and its
|
|
629 remaining arguments are @var{args}.
|
|
630
|
|
631 An analogous feature lets you specify buffers which should be
|
|
632 displayed in the selected window. @xref{Force Same Window}. The
|
|
633 same-window feature takes precedence over the special-frame feature;
|
|
634 therefore, if you add a buffer name to
|
|
635 @code{special-display-buffer-names} and it has no effect, check to see
|
|
636 whether that feature is also in use for the same buffer name.
|
|
637
|
|
638 @node Frame Parameters
|
|
639 @section Setting Frame Parameters
|
|
640 @cindex colors
|
|
641 @cindex Auto-Raise mode
|
|
642 @cindex Auto-Lower mode
|
|
643
|
|
644 This section describes commands for altering the display style and
|
|
645 window management behavior of the selected frame.
|
|
646
|
|
647 @findex set-foreground-color
|
|
648 @findex set-background-color
|
|
649 @findex set-cursor-color
|
|
650 @findex set-mouse-color
|
|
651 @findex set-border-color
|
|
652 @findex auto-raise-mode
|
|
653 @findex auto-lower-mode
|
|
654 @table @kbd
|
|
655 @item M-x set-foreground-color @key{RET} @var{color} @key{RET}
|
|
656 Specify color @var{color} for the foreground of the selected frame.
|
|
657 (This also changes the foreground color of the default face.)
|
|
658
|
|
659 @item M-x set-background-color @key{RET} @var{color} @key{RET}
|
|
660 Specify color @var{color} for the background of the selected frame.
|
|
661 (This also changes the background color of the default face.)
|
|
662
|
|
663 @item M-x set-cursor-color @key{RET} @var{color} @key{RET}
|
|
664 Specify color @var{color} for the cursor of the selected frame.
|
|
665
|
|
666 @item M-x set-mouse-color @key{RET} @var{color} @key{RET}
|
|
667 Specify color @var{color} for the mouse cursor when it is over the
|
|
668 selected frame.
|
|
669
|
|
670 @item M-x set-border-color @key{RET} @var{color} @key{RET}
|
|
671 Specify color @var{color} for the border of the selected frame.
|
|
672
|
|
673 @item M-x list-colors-display
|
|
674 Display the defined color names and show what the colors look like.
|
|
675 This command is somewhat slow.
|
|
676
|
|
677 @item M-x auto-raise-mode
|
|
678 Toggle whether or not the selected frame should auto-raise. Auto-raise
|
|
679 means that every time you move the mouse onto the frame, it raises the
|
|
680 frame.
|
|
681
|
|
682 Note that this auto-raise feature is implemented by Emacs itself. Some
|
|
683 window managers also implement auto-raise. If you enable auto-raise for
|
|
684 Emacs frames in your X window manager, it should work, but it is beyond
|
|
685 Emacs's control and therefore @code{auto-raise-mode} has no effect on
|
|
686 it.
|
|
687
|
|
688 @item M-x auto-lower-mode
|
|
689 Toggle whether or not the selected frame should auto-lower.
|
|
690 Auto-lower means that every time you move the mouse off the frame,
|
|
691 the frame moves to the bottom of the stack of X windows.
|
|
692
|
|
693 The command @code{auto-lower-mode} has no effect on auto-lower
|
|
694 implemented by the X window manager. To control that, you must use
|
|
695 the appropriate window manager features.
|
|
696
|
|
697 @findex set-frame-font
|
|
698 @item M-x set-frame-font @key{RET} @var{font} @key{RET}
|
|
699 @cindex font (principal)
|
|
700 Specify font @var{font} as the principal font for the selected frame.
|
|
701 The principal font controls several face attributes of the
|
|
702 @code{default} face (@pxref{Faces}). For example, if the principal font
|
|
703 has a height of 12 pt, all text will be drawn in 12 pt fonts, unless you
|
|
704 use another face that specifies a different height. @xref{Font X}, for
|
|
705 ways to list the available fonts on your system.
|
|
706
|
|
707 @kindex S-Mouse-1
|
|
708 You can also set a frame's principal font through a pop-up menu.
|
|
709 Press @kbd{S-Mouse-1} to activate this menu.
|
|
710 @end table
|
|
711
|
|
712 In Emacs versions that use an X toolkit, the color-setting and
|
|
713 font-setting functions don't affect menus and the menu bar, since they
|
|
714 are displayed by their own widget classes. To change the appearance of
|
41374
|
715 the menus and menu bar, you must use X resources (@pxref{Resources}).
|
42751
|
716 @xref{Colors}, regarding colors. @xref{Font X}, regarding choice of
|
25829
|
717 font.
|
|
718
|
38670
|
719 Colors, fonts, and other attributes of the frame's display can also
|
|
720 be customized by setting frame parameters in the variable
|
|
721 @code{default-frame-alist} (@pxref{Creating Frames}). For a detailed
|
|
722 description of frame parameters and customization, see @ref{Frame
|
25829
|
723 Parameters,,, elisp, The Emacs Lisp Reference Manual}.
|
|
724
|
|
725 @node Scroll Bars
|
|
726 @section Scroll Bars
|
|
727 @cindex Scroll Bar mode
|
|
728 @cindex mode, Scroll Bar
|
|
729
|
|
730 When using X, Emacs normally makes a @dfn{scroll bar} at the left of
|
27224
|
731 each Emacs window.@footnote{Placing it at the left is usually more
|
|
732 useful with overlapping frames with text starting at the left margin.}
|
|
733 The scroll bar runs the height of the window, and shows a moving
|
|
734 rectangular inner box which represents the portion of the buffer
|
|
735 currently displayed. The entire height of the scroll bar represents the
|
|
736 entire length of the buffer.
|
25829
|
737
|
|
738 You can use @kbd{Mouse-2} (normally, the middle button) in the scroll
|
|
739 bar to move or drag the inner box up and down. If you move it to the
|
|
740 top of the scroll bar, you see the top of the buffer. If you move it to
|
|
741 the bottom of the scroll bar, you see the bottom of the buffer.
|
|
742
|
|
743 The left and right buttons in the scroll bar scroll by controlled
|
|
744 increments. @kbd{Mouse-1} (normally, the left button) moves the line at
|
|
745 the level where you click up to the top of the window. @kbd{Mouse-3}
|
|
746 (normally, the right button) moves the line at the top of the window
|
|
747 down to the level where you click. By clicking repeatedly in the same
|
|
748 place, you can scroll by the same distance over and over.
|
|
749
|
34523
|
750 If you are using Emacs's own implementation of scroll bars, as opposed
|
34444
|
751 to scroll bars from an X toolkit, you can also click @kbd{C-Mouse-2} in
|
|
752 the scroll bar to split a window vertically. The split occurs on the
|
|
753 line where you click.
|
25829
|
754
|
|
755 @findex scroll-bar-mode
|
27224
|
756 @vindex scroll-bar-mode
|
25829
|
757 You can enable or disable Scroll Bar mode with the command @kbd{M-x
|
|
758 scroll-bar-mode}. With no argument, it toggles the use of scroll bars.
|
|
759 With an argument, it turns use of scroll bars on if and only if the
|
|
760 argument is positive. This command applies to all frames, including
|
27224
|
761 frames yet to be created. Customize the option @code{scroll-bar-mode}
|
|
762 to control the use of scroll bars at startup. You can use it to specify
|
|
763 that they are placed at the right of windows if you prefer that. You
|
|
764 can use the X resource @samp{verticalScrollBars} to control the initial
|
41374
|
765 setting of Scroll Bar mode similarly. @xref{Resources}.
|
25829
|
766
|
|
767 @findex toggle-scroll-bar
|
|
768 To enable or disable scroll bars for just the selected frame, use the
|
44326
|
769 command @kbd{M-x toggle-scroll-bar}.
|
25829
|
770
|
36979
|
771 @vindex scroll-bar-width
|
|
772 @cindex width of the scroll bar
|
|
773 You can control the scroll bar width by changing the value of the
|
|
774 @code{scroll-bar-width} frame parameter.
|
|
775
|
27224
|
776 @node Wheeled Mice
|
36156
|
777 @section Scrolling With ``Wheeled'' Mice
|
27224
|
778
|
36156
|
779 @cindex mouse wheel
|
36864
|
780 @cindex wheel, mouse
|
|
781 @findex mouse-wheel-mode
|
|
782 @cindex Mouse Wheel minor mode
|
|
783 @cindex mode, Mouse Wheel
|
|
784 Some mice have a ``wheel'' instead of a third button. You can
|
|
785 usually click the wheel to act as either @kbd{Mouse-2} or
|
|
786 @kbd{Mouse-3}, depending on the setup. You can also use the wheel to
|
36156
|
787 scroll windows instead of using the scroll bar or keyboard commands.
|
36864
|
788 To do so, turn on Mouse Wheel global minor mode with the command
|
|
789 @kbd{M-x mouse-wheel-mode} or by customizing the option
|
|
790 @code{mouse-wheel-mode}. Support for the wheel depends on the system
|
|
791 generating appropriate events for Emacs.
|
27224
|
792
|
35875
|
793 @vindex mouse-wheel-follow-mouse
|
|
794 @vindex mouse-wheel-scroll-amount
|
36156
|
795 The variables @code{mouse-wheel-follow-mouse} and
|
35875
|
796 @code{mouse-wheel-scroll-amount} determine where and by how much
|
|
797 buffers are scrolled.
|
27224
|
798
|
53792
|
799 @node Drag and drop
|
|
800 @section Drag and drop in Emacs.
|
|
801
|
|
802 @cindex drag and drop
|
|
803 Emacs supports drag and drop so that dropping of files and text is handeled.
|
53950
|
804 Currently supported drag and drop protocols are XDND, Motif and the old
|
|
805 KDE 1.x protocol. There is no drag support yet.
|
53795
|
806 When text is dropped on Emacs, Emacs inserts the text where it is dropped.
|
53794
|
807 When a file is dragged from a file manager to Emacs, Emacs opens that file.
|
|
808 As a special case, if a file is dropped on a dired buffer the file is
|
|
809 copied or moved (depends on exactly how it is dragged and the application
|
53795
|
810 it was dragged from) to the directory the dired buffer is displaying.
|
53792
|
811
|
53793
|
812 @vindex x-dnd-open-file-other-window
|
53792
|
813 A file is normally opened in the window it is dropped on, but if you
|
53795
|
814 prefer the file to be opened in a new window you can customize the variable
|
53792
|
815 @code{x-dnd-open-file-other-window}.
|
|
816
|
|
817 @vindex x-dnd-types-alist
|
53795
|
818 If you want to change the way Emacs handles drop of different types
|
53792
|
819 or add a new type, you shall customize @code{x-dnd-types-alist}. This
|
|
820 requires detailed knowledge of what types other applications use
|
|
821 for drag and drop.
|
|
822
|
|
823 @vindex x-dnd-protocol-alist
|
53795
|
824 When an URL is dropped on Emacs it may be a file, but it may also be
|
53792
|
825 another URL type (ftp, http, etc.). Emacs first checks
|
|
826 @code{x-dnd-protocol-alist} to determine what to do with the URL. If there
|
53795
|
827 is no match there and if @code{browse-url-browser-function} is an alist,
|
|
828 Emacs looks for a match there. If no match is found the text for the URL
|
53792
|
829 is inserted. If you want to alter Emacs behaviour you can customize these
|
|
830 variables.
|
|
831
|
|
832
|
25829
|
833 @node Menu Bars
|
|
834 @section Menu Bars
|
|
835 @cindex Menu Bar mode
|
|
836 @cindex mode, Menu Bar
|
|
837
|
|
838 You can turn display of menu bars on or off with @kbd{M-x
|
31609
|
839 menu-bar-mode} or by customizing the option @code{menu-bar-mode}.
|
|
840 With no argument, this command toggles Menu Bar mode, a
|
25829
|
841 minor mode. With an argument, the command turns Menu Bar mode on if the
|
|
842 argument is positive, off if the argument is not positive. You can use
|
|
843 the X resource @samp{menuBarLines} to control the initial setting of
|
41374
|
844 Menu Bar mode. @xref{Resources}.
|
31609
|
845
|
36156
|
846 @kindex C-Mouse-3 @r{(when menu bar is disabled)}
|
|
847 Expert users often turn off the menu bar, especially on text-only
|
|
848 terminals, where this makes one additional line available for text.
|
|
849 If the menu bar is off, you can still pop up a menu of its contents
|
39267
|
850 with @kbd{C-Mouse-3} on a display which supports pop-up menus.
|
36156
|
851 @xref{Menu Mouse Clicks}.
|
25829
|
852
|
|
853 @xref{Menu Bar}, for information on how to invoke commands with the
|
40527
|
854 menu bar. @xref{X Resources}, for how to customize the menu bar
|
|
855 menus.
|
25829
|
856
|
31609
|
857 @node Tool Bars
|
|
858 @section Tool Bars
|
|
859 @cindex Tool Bar mode
|
|
860 @cindex mode, Tool Bar
|
49917
|
861 @cindex icons, toolbar
|
27224
|
862
|
36156
|
863 The @dfn{tool bar} is a line (or multiple lines) of icons at the top
|
|
864 of the Emacs window. You can click on these icons with the mouse
|
|
865 to do various jobs.
|
31609
|
866
|
36156
|
867 The global tool bar contains general commands. Some major modes
|
|
868 define their own tool bars to replace it. A few ``special'' modes
|
|
869 that are not designed for ordinary editing remove some items from the
|
|
870 global tool bar.
|
|
871
|
36408
|
872 Tool bars work only on a graphical display. The tool bar uses colored
|
|
873 XPM icons if Emacs was built with XPM support. Otherwise, the tool
|
|
874 bar uses monochrome icons (PBM or XBM format).
|
36156
|
875
|
|
876 You can turn display of tool bars on or off with @kbd{M-x
|
|
877 tool-bar-mode}.
|
27224
|
878
|
|
879 @node Dialog Boxes
|
|
880 @section Using Dialog Boxes
|
|
881 @cindex dialog boxes
|
|
882
|
|
883 @vindex use-dialog-box
|
36156
|
884 A dialog box is a special kind of menu for asking you a yes-or-no
|
|
885 question or some other special question. Many Emacs commands use a
|
|
886 dialog box to ask a yes-or-no question, if you used the mouse to
|
|
887 invoke the command to begin with.
|
|
888
|
|
889 You can customize the option @code{use-dialog-box} to suppress the
|
|
890 use of dialog boxes. This also controls whether to use file selection
|
|
891 windows (but those are not supported on all platforms).
|
27224
|
892
|
53191
|
893 @vindex use-file-dialog
|
|
894 A file selection window is a special kind of dialog box for asking for
|
|
895 file names.
|
|
896
|
|
897 You can customize the option @code{use-file-dialog} to suppress the
|
|
898 use of file selection windows even if you still want other kinds
|
|
899 of dialogs. This option has no effect if you have supressed all dialog
|
|
900 boxes with the option @code{use-dialog-box}.
|
|
901
|
|
902
|
27224
|
903 @node Tooltips
|
36156
|
904 @section Tooltips (or ``Balloon Help'')
|
27224
|
905
|
|
906 @cindex balloon help
|
36156
|
907 Tooltips are small X windows displaying a help string at the current
|
28432
|
908 mouse position, typically over text---including the mode line---which
|
|
909 can be activated with the mouse or other keys. (This facility is
|
36185
|
910 sometimes known as @dfn{balloon help}.) Help text may be available for
|
36156
|
911 menu items too.
|
28432
|
912
|
36156
|
913 @findex tooltip-mode
|
|
914 To use tooltips, enable Tooltip mode with the command @kbd{M-x
|
|
915 tooltip-mode}. The customization group @code{tooltip} controls
|
|
916 various aspects of how tooltips work. When Tooltip mode is disabled,
|
|
917 the help text is displayed in the echo area instead.
|
27224
|
918
|
46206
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
919 @vindex tooltip-delay
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
920 The variables @code{tooltip-delay} specifies how long Emacs should
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
921 wait before displaying a tooltip. For additional customization
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
922 options for displaying tooltips, use @kbd{M-x customize-group
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
923 @key{RET} tooltip @key{RET}}. @xref{X Resources}, for information on
|
1ad1838fbda4
Document toolip-delay and other tooltip customization. Explain the
Richard M. Stallman <rms@gnu.org>
diff
changeset
|
924 customizing the windows that display tooltips.
|
35730
|
925
|
28124
|
926 @node Mouse Avoidance
|
|
927 @section Mouse Avoidance
|
36156
|
928 @cindex avoiding mouse in the way of your typing
|
|
929 @cindex mouse avoidance
|
28124
|
930
|
36156
|
931 @vindex mouse-avoidance-mode
|
28124
|
932 Mouse Avoidance mode keeps the window system mouse pointer away from
|
36156
|
933 point, to avoid obscuring text. Whenever it moves the mouse, it also
|
|
934 raises the frame. To use Mouse Avoidance mode, customize the option
|
|
935 @code{mouse-avoidance-mode}. You can set this to various values to
|
|
936 move the mouse in several ways:
|
28124
|
937
|
|
938 @table @code
|
|
939 @item banish
|
39267
|
940 Move the mouse to the upper-right corner on any key-press;
|
28124
|
941 @item exile
|
|
942 Move the mouse to the corner only if the cursor gets too close,
|
|
943 and allow it to return once the cursor is out of the way;
|
|
944 @item jump
|
|
945 If the cursor gets too close to the mouse, displace the mouse
|
|
946 a random distance & direction;
|
|
947 @item animate
|
|
948 As @code{jump}, but shows steps along the way for illusion of motion;
|
|
949 @item cat-and-mouse
|
|
950 The same as @code{animate};
|
|
951 @item proteus
|
|
952 As @code{animate}, but changes the shape of the mouse pointer too.
|
|
953 @end table
|
|
954
|
36156
|
955 @findex mouse-avoidance-mode
|
|
956 You can also use the command @kbd{M-x mouse-avoidance-mode} to enable
|
28124
|
957 the mode.
|
27224
|
958
|
25829
|
959 @node Non-Window Terminals
|
|
960 @section Non-Window Terminals
|
|
961 @cindex non-window terminals
|
|
962 @cindex single-frame terminals
|
|
963
|
|
964 If your terminal does not have a window system that Emacs supports,
|
|
965 then it can display only one Emacs frame at a time. However, you can
|
|
966 still create multiple Emacs frames, and switch between them. Switching
|
|
967 frames on these terminals is much like switching between different
|
|
968 window configurations.
|
|
969
|
|
970 Use @kbd{C-x 5 2} to create a new frame and switch to it; use @kbd{C-x
|
|
971 5 o} to cycle through the existing frames; use @kbd{C-x 5 0} to delete
|
|
972 the current frame.
|
|
973
|
|
974 Each frame has a number to distinguish it. If your terminal can
|
|
975 display only one frame at a time, the selected frame's number @var{n}
|
|
976 appears near the beginning of the mode line, in the form
|
|
977 @samp{F@var{n}}.
|
|
978
|
|
979 @findex set-frame-name
|
|
980 @findex select-frame-by-name
|
|
981 @samp{F@var{n}} is actually the frame's name. You can also specify a
|
|
982 different name if you wish, and you can select a frame by its name. Use
|
|
983 the command @kbd{M-x set-frame-name @key{RET} @var{name} @key{RET}} to
|
|
984 specify a new name for the selected frame, and use @kbd{M-x
|
|
985 select-frame-by-name @key{RET} @var{name} @key{RET}} to select a frame
|
|
986 according to its name. The name you specify appears in the mode line
|
|
987 when the frame is selected.
|
|
988
|
27224
|
989 @node XTerm Mouse
|
|
990 @section Using a Mouse in Terminal Emulators
|
28124
|
991 @cindex xterm, mouse support
|
|
992 @cindex terminal emulators, mouse support
|
27224
|
993
|
|
994 Some terminal emulators under X support mouse clicks in the terminal
|
|
995 window. In a terminal emulator which is compatible with @code{xterm},
|
|
996 you can use @kbd{M-x xterm-mouse-mode} to enable simple use of the
|
|
997 mouse---only single clicks are supported. The normal @code{xterm} mouse
|
|
998 functionality is still available by holding down the @kbd{SHIFT} key
|
36864
|
999 when you press the mouse button. The Linux console supports this
|
|
1000 mode if it has support for the mouse enabled, e.g.@: using the
|
|
1001 @command{gpm} daemon.
|
52401
|
1002
|
|
1003 @ignore
|
|
1004 arch-tag: 7dcf3a31-a43b-45d4-a900-445b10d77e49
|
|
1005 @end ignore
|