comparison lispref/keymaps.texi @ 74999:f103a7051e54

(Tool Bar): Describe `grow-only' value of `auto-resize-tool-bars'.
author Kim F. Storm <storm@cua.dk>
date Sat, 30 Dec 2006 21:39:16 +0000
parents 4ba9bcb17430
children 6d19c76d81c5 bc10a33dd40b
comparison
equal deleted inserted replaced
74998:091a17e8cb83 74999:f103a7051e54
2538 controls how many lines' worth of height to reserve for the tool bar. A 2538 controls how many lines' worth of height to reserve for the tool bar. A
2539 zero value suppresses the tool bar. If the value is nonzero, and 2539 zero value suppresses the tool bar. If the value is nonzero, and
2540 @code{auto-resize-tool-bars} is non-@code{nil}, the tool bar expands and 2540 @code{auto-resize-tool-bars} is non-@code{nil}, the tool bar expands and
2541 contracts automatically as needed to hold the specified contents. 2541 contracts automatically as needed to hold the specified contents.
2542 2542
2543 If the value of @code{auto-resize-tool-bars} is @code{grow-only},
2544 the tool bar expands automatically, but does not contract automatically.
2545 To contract the tool bar, the user has to redraw the frame by entering
2546 @kbd{C-l}.
2547
2543 The tool bar contents are controlled by a menu keymap attached to a 2548 The tool bar contents are controlled by a menu keymap attached to a
2544 fake ``function key'' called @code{tool-bar} (much like the way the menu 2549 fake ``function key'' called @code{tool-bar} (much like the way the menu
2545 bar is controlled). So you define a tool bar item using 2550 bar is controlled). So you define a tool bar item using
2546 @code{define-key}, like this: 2551 @code{define-key}, like this:
2547 2552
2665 2670
2666 @defvar auto-resize-tool-bar 2671 @defvar auto-resize-tool-bar
2667 If this variable is non-@code{nil}, the tool bar automatically resizes to 2672 If this variable is non-@code{nil}, the tool bar automatically resizes to
2668 show all defined tool bar items---but not larger than a quarter of the 2673 show all defined tool bar items---but not larger than a quarter of the
2669 frame's height. 2674 frame's height.
2675
2676 If the value is @code{grow-only}, the tool bar expands automatically,
2677 but does not contract automatically. To contract the tool bar, the
2678 user has to redraw the frame by entering @kbd{C-l}.
2670 @end defvar 2679 @end defvar
2671 2680
2672 @defvar auto-raise-tool-bar-buttons 2681 @defvar auto-raise-tool-bar-buttons
2673 If this variable is non-@code{nil}, tool bar items display 2682 If this variable is non-@code{nil}, tool bar items display
2674 in raised form when the mouse moves over them. 2683 in raised form when the mouse moves over them.