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 |
|
|
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 |
|
|
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 |
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 |
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 |
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 |
|
|
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 |
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, |
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 |