/[emacs]/emacs/lispref/frames.texi
ViewVC logotype

Diff of /emacs/lispref/frames.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.60.2.1 by miles, Fri Apr 4 06:20:41 2003 UTC revision 1.60.2.2 by miles, Tue Oct 14 23:10:11 2003 UTC
# Line 225  parameter.  If you don't mention a param Line 225  parameter.  If you don't mention a param
225  doesn't change.  doesn't change.
226  @end defun  @end defun
227    
228    @defun modify-all-frames-parameters alist
229    This function alters the frame parameters of all existing frames
230    according to @var{alist}, then modifies @code{default-frame-alist}
231    to apply the same parameter values to frames that will be created
232    henceforth.
233    @end defun
234    
235  @node Initial Parameters  @node Initial Parameters
236  @subsection Initial Frame Parameters  @subsection Initial Frame Parameters
237    
# Line 423  considers that buffer. Line 430  considers that buffer.
430  A list of buffers that have been selected in this frame,  A list of buffers that have been selected in this frame,
431  ordered most-recently-selected first.  ordered most-recently-selected first.
432    
 @item font  
 The name of the font for displaying text in the frame.  This is a  
 string, either a valid font name for your system or the name of an Emacs  
 fontset (@pxref{Fontsets}).  Changing this frame parameter on a frame  
 also changes the font-related attributes of the default face on that  
 frame.  
   
433  @item auto-raise  @item auto-raise
434  Whether selecting the frame raises it (non-@code{nil} means yes).  Whether selecting the frame raises it (non-@code{nil} means yes).
435    
# Line 447  Whether the frame has scroll bars for ho Line 447  Whether the frame has scroll bars for ho
447  implemented.)  implemented.)
448    
449  @item scroll-bar-width  @item scroll-bar-width
450  The width of the vertical scroll bar, in pixels.  The width of the vertical scroll bar, in pixels,
451    or @code{nil} meaning to use the default width.
452    
453  @item icon-type  @item icon-type
454  The type of icon to use for this frame when it is iconified.  If the  The type of icon to use for this frame when it is iconified.  If the
# Line 459  picture of a gnu); @code{nil} specifies Line 460  picture of a gnu); @code{nil} specifies
460  The name to use in the icon for this frame, when and if the icon  The name to use in the icon for this frame, when and if the icon
461  appears.  If this is @code{nil}, the frame's title is used.  appears.  If this is @code{nil}, the frame's title is used.
462    
 @item foreground-color  
 The color to use for the image of a character.  This is a string; the  
 window system defines the meaningful color names.  Changing this  
 parameter is equivalent to changing the foreground color of the face  
 @code{default} on the frame in question.  
   
 @item background-color  
 The color to use for the background of characters.  Changing this  
 parameter is equivalent to changing the foreground color of the face  
 @code{default} on the frame in question.  
   
463  @item background-mode  @item background-mode
464  This parameter is either @code{dark} or @code{light}, according  This parameter is either @code{dark} or @code{light}, according
465  to whether the background color is a light one or a dark one.  to whether the background color is a light one or a dark one.
466    
 @item mouse-color  
 The color for the mouse pointer.  Changing this parameter is equivalent  
 to changing the background color of face @code{mouse}.  
   
 @item cursor-color  
 The color for the cursor that shows point.  Changing this parameter is  
 equivalent to changing the background color of face @code{cursor}.  
   
 @item border-color  
 The color for the border of the frame.  Changing this parameter is  
 equivalent to changing the background color of face @code{border}.  
   
467  @item tty-color-mode  @item tty-color-mode
468  @cindex standard colors for character terminals  @cindex standard colors for character terminals
469  This parameter overrides the terminal's color support as given by the  This parameter overrides the terminal's color support as given by the
# Line 500  value is a symbol, that symbol is looked Line 478  value is a symbol, that symbol is looked
478  @code{tty-color-mode-alist}, and if found, the associated number is  @code{tty-color-mode-alist}, and if found, the associated number is
479  used as the color support mode.  used as the color support mode.
480    
 @item scroll-bar-foreground  
 If non-@code{nil}, the color for the foreground of scroll bars.  
 Changing this parameter is equivalent to setting the foreground color of  
 face @code{scroll-bar}.  
   
 @item scroll-bar-background  
 If non-@code{nil}, the color for the background of scroll bars.  
 Changing this parameter is equivalent to setting the background color of  
 face @code{scroll-bar}.  
   
481  @item display-type  @item display-type
482  This parameter describes the range of possible colors that can be used  This parameter describes the range of possible colors that can be used
483  in this frame.  Its value is @code{color}, @code{grayscale} or  in this frame.  Its value is @code{color}, @code{grayscale} or
# Line 547  The width in pixels of the window border Line 515  The width in pixels of the window border
515  @item internal-border-width  @item internal-border-width
516  The distance in pixels between text and border.  The distance in pixels between text and border.
517    
518    @item left-fringe
519    @itemx right-fringe
520    The default width of the left and right fringes of windows in this
521    frame (@pxref{Fringes}).  If either of these is zero, that effectively
522    removes the corresponding fringe.  A value of @code{nil} stands for
523    the standard fringe width, which is the width needed to display the
524    fringe bitmaps.
525    
526    The combined fringe widths must add up to an integral number of
527    columns, so the actual default fringe widths for the frame may be
528    larger than the specified values.  The extra width needed to reach an
529    acceptable total is distributed evenly between the left and right
530    fringe.  However, you can force one frame or the other to a precise
531    width by specifying that width a negative integer.  If both widths are
532    negative, only the left fringe gets the specified width.
533    
534  @item unsplittable  @item unsplittable
535  If non-@code{nil}, this frame's window is never split automatically.  If non-@code{nil}, this frame's window is never split automatically.
536    
# Line 611  in this variable do not take effect imme Line 595  in this variable do not take effect imme
595  is examined only when you specify a cursor type for a frame.  is examined only when you specify a cursor type for a frame.
596  @end defvar  @end defvar
597    
598    These frame parameters are semi-obsolete in that they are automatically
599    equivalent to particular face attributes of particular faces.
600    
601    @table @code
602    @item font
603    The name of the font for displaying text in the frame.  This is a
604    string, either a valid font name for your system or the name of an Emacs
605    fontset (@pxref{Fontsets}).  It is equivalent to the @code{font}
606    attribute of the @code{default} face.
607    
608    @item foreground-color
609    The color to use for the image of a character.  It is equivalent to
610    the @code{:foreground} attribute of the @code{default} face.
611    
612    @item background-color
613    The color to use for the background of characters.  It is equivalent to
614    the @code{:background} attribute of the @code{default} face.
615    
616    @item mouse-color
617    The color for the mouse pointer.  It is equivalent to the @code{:background}
618    attribute of the @code{mouse} face.
619    
620    @item cursor-color
621    The 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
625    The 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
629    If non-@code{nil}, the color for the foreground of scroll bars.  It is
630    equivalent to the @code{:foreground} attribute of the
631    @code{scroll-bar} face.
632    
633    @item scroll-bar-background
634    If non-@code{nil}, the color for the background of scroll bars.  It is
635    equivalent to the @code{:background} attribute of the
636    @code{scroll-bar} face.
637    @end table
638    
639  @node Size and Position  @node Size and Position
640  @subsection Frame Size And Position  @subsection Frame Size And Position
641  @cindex size of frame  @cindex size of frame
# Line 798  configuration (@pxref{Frame Configuratio Line 823  configuration (@pxref{Frame Configuratio
823  way windows behave.  way windows behave.
824    
825  @deffn Command delete-frame &optional frame force  @deffn Command delete-frame &optional frame force
826  @vindex delete-frame-hook  @vindex delete-frame-functions
827  This function deletes the frame @var{frame} after running the hook  This function deletes the frame @var{frame} after running the hook
828  @code{delete-frame-hook}.  By default, @var{frame} is the selected  @code{delete-frame-functions} (each function gets one argument,
829  frame.  @var{frame}).  By default, @var{frame} is the selected frame.
830    
831  A frame cannot be deleted if its minibuffer is used by other frames.  A frame cannot be deleted if its minibuffer is used by other frames.
832  Normally, you cannot delete a frame if all other frames are invisible,  Normally, you cannot delete a frame if all other frames are invisible,
# Line 1872  This variable's value is @code{t} if no Line 1897  This variable's value is @code{t} if no
1897  The functions @code{x-pixel-width} and @code{x-pixel-height} return the  The functions @code{x-pixel-width} and @code{x-pixel-height} return the
1898  width and height of an X Window frame, measured in pixels.  width and height of an X Window frame, measured in pixels.
1899  @end ignore  @end ignore
1900    
1901    @ignore
1902       arch-tag: 94977df6-3dca-4730-b57b-c6329e9282ba
1903    @end ignore

Legend:
Removed from v.1.60.2.1  
changed lines
  Added in v.1.60.2.2

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26