diff options
| author | Kenichi Handa | 2003-09-08 11:56:09 +0000 |
|---|---|---|
| committer | Kenichi Handa | 2003-09-08 11:56:09 +0000 |
| commit | 463f5630a5e7cbe7f042bc1175d1fa1c4e98860f (patch) | |
| tree | 3287d0c628fea2249abf4635b3a4f45bedd6f8c4 /lispref/frames.texi | |
| parent | 4256310de631bd57c78b88b5131caa073315b3d7 (diff) | |
| download | emacs-463f5630a5e7cbe7f042bc1175d1fa1c4e98860f.tar.gz emacs-463f5630a5e7cbe7f042bc1175d1fa1c4e98860f.zip | |
New directory
Diffstat (limited to 'lispref/frames.texi')
| -rw-r--r-- | lispref/frames.texi | 117 |
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 | |||
| 225 | doesn't change. | 225 | doesn't change. |
| 226 | @end defun | 226 | @end defun |
| 227 | 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 | 228 | @node Initial Parameters |
| 236 | @subsection Initial Frame Parameters | 229 | @subsection Initial Frame Parameters |
| 237 | 230 | ||
| @@ -430,6 +423,13 @@ considers that buffer. | |||
| 430 | A list of buffers that have been selected in this frame, | 423 | A list of buffers that have been selected in this frame, |
| 431 | ordered most-recently-selected first. | 424 | ordered most-recently-selected first. |
| 432 | 425 | ||
| 426 | @item font | ||
| 427 | The name of the font for displaying text in the frame. This is a | ||
| 428 | string, either a valid font name for your system or the name of an Emacs | ||
| 429 | fontset (@pxref{Fontsets}). Changing this frame parameter on a frame | ||
| 430 | also changes the font-related attributes of the default face on that | ||
| 431 | frame. | ||
| 432 | |||
| 433 | @item auto-raise | 433 | @item auto-raise |
| 434 | Whether selecting the frame raises it (non-@code{nil} means yes). | 434 | Whether 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 | |||
| 447 | implemented.) | 447 | implemented.) |
| 448 | 448 | ||
| 449 | @item scroll-bar-width | 449 | @item scroll-bar-width |
| 450 | The width of the vertical scroll bar, in pixels, | 450 | The width of the vertical scroll bar, in pixels. |
| 451 | or @code{nil} meaning to use the default width. | ||
| 452 | 451 | ||
| 453 | @item icon-type | 452 | @item icon-type |
| 454 | The type of icon to use for this frame when it is iconified. If the | 453 | The 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. | |||
| 460 | The name to use in the icon for this frame, when and if the icon | 459 | 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. | 460 | appears. If this is @code{nil}, the frame's title is used. |
| 462 | 461 | ||
| 462 | @item foreground-color | ||
| 463 | The color to use for the image of a character. This is a string; the | ||
| 464 | window system defines the meaningful color names. Changing this | ||
| 465 | parameter is equivalent to changing the foreground color of the face | ||
| 466 | @code{default} on the frame in question. | ||
| 467 | |||
| 468 | @item background-color | ||
| 469 | The color to use for the background of characters. Changing this | ||
| 470 | parameter 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 |
| 464 | This parameter is either @code{dark} or @code{light}, according | 474 | This parameter is either @code{dark} or @code{light}, according |
| 465 | to whether the background color is a light one or a dark one. | 475 | to whether the background color is a light one or a dark one. |
| 466 | 476 | ||
| 477 | @item mouse-color | ||
| 478 | The color for the mouse pointer. Changing this parameter is equivalent | ||
| 479 | to changing the background color of face @code{mouse}. | ||
| 480 | |||
| 481 | @item cursor-color | ||
| 482 | The color for the cursor that shows point. Changing this parameter is | ||
| 483 | equivalent to changing the background color of face @code{cursor}. | ||
| 484 | |||
| 485 | @item border-color | ||
| 486 | The color for the border of the frame. Changing this parameter is | ||
| 487 | equivalent 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 |
| 469 | This parameter overrides the terminal's color support as given by the | 491 | This 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 |
| 479 | used as the color support mode. | 501 | used as the color support mode. |
| 480 | 502 | ||
| 503 | @item scroll-bar-foreground | ||
| 504 | If non-@code{nil}, the color for the foreground of scroll bars. | ||
| 505 | Changing this parameter is equivalent to setting the foreground color of | ||
| 506 | face @code{scroll-bar}. | ||
| 507 | |||
| 508 | @item scroll-bar-background | ||
| 509 | If non-@code{nil}, the color for the background of scroll bars. | ||
| 510 | Changing this parameter is equivalent to setting the background color of | ||
| 511 | face @code{scroll-bar}. | ||
| 512 | |||
| 481 | @item display-type | 513 | @item display-type |
| 482 | This parameter describes the range of possible colors that can be used | 514 | This parameter describes the range of possible colors that can be used |
| 483 | in this frame. Its value is @code{color}, @code{grayscale} or | 515 | in 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 |
| 516 | The distance in pixels between text and border. | 548 | The distance in pixels between text and border. |
| 517 | 549 | ||
| 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 | 550 | @item unsplittable |
| 535 | If non-@code{nil}, this frame's window is never split automatically. | 551 | If 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 | |||
| 595 | is examined only when you specify a cursor type for a frame. | 611 | is examined only when you specify a cursor type for a frame. |
| 596 | @end defvar | 612 | @end defvar |
| 597 | 613 | ||
| 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 | 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 | |||
| 823 | way windows behave. | 798 | way 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 |
| 827 | This function deletes the frame @var{frame} after running the hook | 802 | This 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. | 804 | frame. |
| 830 | 805 | ||
| 831 | A frame cannot be deleted if its minibuffer is used by other frames. | 806 | 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, | 807 | Normally, 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. | |||
| 1897 | The functions @code{x-pixel-width} and @code{x-pixel-height} return the | 1872 | 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. | 1873 | width 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 | ||