aboutsummaryrefslogtreecommitdiffstats
path: root/lispref/frames.texi
diff options
context:
space:
mode:
authorKenichi Handa2003-09-08 11:56:09 +0000
committerKenichi Handa2003-09-08 11:56:09 +0000
commit463f5630a5e7cbe7f042bc1175d1fa1c4e98860f (patch)
tree3287d0c628fea2249abf4635b3a4f45bedd6f8c4 /lispref/frames.texi
parent4256310de631bd57c78b88b5131caa073315b3d7 (diff)
downloademacs-463f5630a5e7cbe7f042bc1175d1fa1c4e98860f.tar.gz
emacs-463f5630a5e7cbe7f042bc1175d1fa1c4e98860f.zip
New directory
Diffstat (limited to 'lispref/frames.texi')
-rw-r--r--lispref/frames.texi117
1 files changed, 44 insertions, 73 deletions
diff --git a/lispref/frames.texi b/lispref/frames.texi
index 76b4228cc4f..fd9e74bea36 100644
--- a/lispref/frames.texi
+++ b/lispref/frames.texi
@@ -225,13 +225,6 @@ parameter. If you don't mention a parameter in @var{alist}, its value
225doesn't change. 225doesn't change.
226@end defun 226@end defun
227 227
228@defun modify-all-frames-parameters alist
229This function alters the frame parameters of all existing frames
230according to @var{alist}, then modifies @code{default-frame-alist}
231to apply the same parameter values to frames that will be created
232henceforth.
233@end defun
234
235@node Initial Parameters 228@node Initial Parameters
236@subsection Initial Frame Parameters 229@subsection Initial Frame Parameters
237 230
@@ -430,6 +423,13 @@ considers that buffer.
430A list of buffers that have been selected in this frame, 423A list of buffers that have been selected in this frame,
431ordered most-recently-selected first. 424ordered most-recently-selected first.
432 425
426@item font
427The name of the font for displaying text in the frame. This is a
428string, either a valid font name for your system or the name of an Emacs
429fontset (@pxref{Fontsets}). Changing this frame parameter on a frame
430also changes the font-related attributes of the default face on that
431frame.
432
433@item auto-raise 433@item auto-raise
434Whether selecting the frame raises it (non-@code{nil} means yes). 434Whether selecting the frame raises it (non-@code{nil} means yes).
435 435
@@ -447,8 +447,7 @@ Whether the frame has scroll bars for horizontal scrolling
447implemented.) 447implemented.)
448 448
449@item scroll-bar-width 449@item scroll-bar-width
450The width of the vertical scroll bar, in pixels, 450The width of the vertical scroll bar, in pixels.
451or @code{nil} meaning to use the default width.
452 451
453@item icon-type 452@item icon-type
454The type of icon to use for this frame when it is iconified. If the 453The type of icon to use for this frame when it is iconified. If the
@@ -460,10 +459,33 @@ picture of a gnu); @code{nil} specifies a text icon.
460The name to use in the icon for this frame, when and if the icon 459The name to use in the icon for this frame, when and if the icon
461appears. If this is @code{nil}, the frame's title is used. 460appears. If this is @code{nil}, the frame's title is used.
462 461
462@item foreground-color
463The color to use for the image of a character. This is a string; the
464window system defines the meaningful color names. Changing this
465parameter is equivalent to changing the foreground color of the face
466@code{default} on the frame in question.
467
468@item background-color
469The color to use for the background of characters. Changing this
470parameter is equivalent to changing the foreground color of the face
471@code{default} on the frame in question.
472
463@item background-mode 473@item background-mode
464This parameter is either @code{dark} or @code{light}, according 474This parameter is either @code{dark} or @code{light}, according
465to whether the background color is a light one or a dark one. 475to whether the background color is a light one or a dark one.
466 476
477@item mouse-color
478The color for the mouse pointer. Changing this parameter is equivalent
479to changing the background color of face @code{mouse}.
480
481@item cursor-color
482The color for the cursor that shows point. Changing this parameter is
483equivalent to changing the background color of face @code{cursor}.
484
485@item border-color
486The color for the border of the frame. Changing this parameter is
487equivalent to changing the background color of face @code{border}.
488
467@item tty-color-mode 489@item tty-color-mode
468@cindex standard colors for character terminals 490@cindex standard colors for character terminals
469This parameter overrides the terminal's color support as given by the 491This parameter overrides the terminal's color support as given by the
@@ -478,6 +500,16 @@ value is a symbol, that symbol is looked up in the alist
478@code{tty-color-mode-alist}, and if found, the associated number is 500@code{tty-color-mode-alist}, and if found, the associated number is
479used as the color support mode. 501used as the color support mode.
480 502
503@item scroll-bar-foreground
504If non-@code{nil}, the color for the foreground of scroll bars.
505Changing this parameter is equivalent to setting the foreground color of
506face @code{scroll-bar}.
507
508@item scroll-bar-background
509If non-@code{nil}, the color for the background of scroll bars.
510Changing this parameter is equivalent to setting the background color of
511face @code{scroll-bar}.
512
481@item display-type 513@item display-type
482This parameter describes the range of possible colors that can be used 514This parameter describes the range of possible colors that can be used
483in this frame. Its value is @code{color}, @code{grayscale} or 515in this frame. Its value is @code{color}, @code{grayscale} or
@@ -515,22 +547,6 @@ The width in pixels of the window border.
515@item internal-border-width 547@item internal-border-width
516The distance in pixels between text and border. 548The distance in pixels between text and border.
517 549
518@item left-fringe
519@itemx right-fringe
520The default width of the left and right fringes of windows in this
521frame (@pxref{Fringes}). If either of these is zero, that effectively
522removes the corresponding fringe. A value of @code{nil} stands for
523the standard fringe width, which is the width needed to display the
524fringe bitmaps.
525
526The combined fringe widths must add up to an integral number of
527columns, so the actual default fringe widths for the frame may be
528larger than the specified values. The extra width needed to reach an
529acceptable total is distributed evenly between the left and right
530fringe. However, you can force one frame or the other to a precise
531width by specifying that width a negative integer. If both widths are
532negative, only the left fringe gets the specified width.
533
534@item unsplittable 550@item unsplittable
535If non-@code{nil}, this frame's window is never split automatically. 551If non-@code{nil}, this frame's window is never split automatically.
536 552
@@ -595,47 +611,6 @@ in this variable do not take effect immediately, because the variable
595is examined only when you specify a cursor type for a frame. 611is examined only when you specify a cursor type for a frame.
596@end defvar 612@end defvar
597 613
598These frame parameters are semi-obsolete in that they are automatically
599equivalent to particular face attributes of particular faces.
600
601@table @code
602@item font
603The name of the font for displaying text in the frame. This is a
604string, either a valid font name for your system or the name of an Emacs
605fontset (@pxref{Fontsets}). It is equivalent to the @code{font}
606attribute of the @code{default} face.
607
608@item foreground-color
609The color to use for the image of a character. It is equivalent to
610the @code{:foreground} attribute of the @code{default} face.
611
612@item background-color
613The color to use for the background of characters. It is equivalent to
614the @code{:background} attribute of the @code{default} face.
615
616@item mouse-color
617The color for the mouse pointer. It is equivalent to the @code{:background}
618attribute of the @code{mouse} face.
619
620@item cursor-color
621The color for the cursor that shows point. It is equivalent to the
622@code{:background} attribute of the @code{cursor} face.
623
624@item border-color
625The color for the border of the frame. It is equivalent to the
626@code{:background} attribute of the @code{border} face.
627
628@item scroll-bar-foreground
629If non-@code{nil}, the color for the foreground of scroll bars. It is
630equivalent to the @code{:foreground} attribute of the
631@code{scroll-bar} face.
632
633@item scroll-bar-background
634If non-@code{nil}, the color for the background of scroll bars. It is
635equivalent to the @code{:background} attribute of the
636@code{scroll-bar} face.
637@end table
638
639@node Size and Position 614@node Size and Position
640@subsection Frame Size And Position 615@subsection Frame Size And Position
641@cindex size of frame 616@cindex size of frame
@@ -823,10 +798,10 @@ configuration (@pxref{Frame Configurations}); this is similar to the
823way windows behave. 798way windows behave.
824 799
825@deffn Command delete-frame &optional frame force 800@deffn Command delete-frame &optional frame force
826@vindex delete-frame-functions 801@vindex delete-frame-hook
827This function deletes the frame @var{frame} after running the hook 802This function deletes the frame @var{frame} after running the hook
828@code{delete-frame-functions} (each function gets one argument, 803@code{delete-frame-hook}. By default, @var{frame} is the selected
829@var{frame}). By default, @var{frame} is the selected frame. 804frame.
830 805
831A frame cannot be deleted if its minibuffer is used by other frames. 806A frame cannot be deleted if its minibuffer is used by other frames.
832Normally, you cannot delete a frame if all other frames are invisible, 807Normally, you cannot delete a frame if all other frames are invisible,
@@ -1897,7 +1872,3 @@ This variable's value is @code{t} if no X window manager is in use.
1897The functions @code{x-pixel-width} and @code{x-pixel-height} return the 1872The functions @code{x-pixel-width} and @code{x-pixel-height} return the
1898width and height of an X Window frame, measured in pixels. 1873width and height of an X Window frame, measured in pixels.
1899@end ignore 1874@end ignore
1900
1901@ignore
1902 arch-tag: 94977df6-3dca-4730-b57b-c6329e9282ba
1903@end ignore