mh-e: Tool Bar
14 The Tool Bar
***************
Emacs also provides a graphical tool bar. For a description of the tool
bar, please Tool Bars (emacs)Tool Bars.
MH-E adds several icons to this tool bar; you can modify the MH-E
aspects of the tool bar via the ‘mh-tool-bar’ customization group.
‘mh-tool-bar-folder-buttons’
List of buttons to include in MH-Folder tool bar (default: a
checklist too long to list here).
‘mh-tool-bar-letter-buttons’
List of buttons to include in MH-Letter tool bar (default: a
checklist too long to list here).
‘mh-tool-bar-search-function’
Function called by the tool bar search button (default:
‘mh-search’).
‘mh-xemacs-tool-bar-position’
Tool bar location (default: ‘Same As Default Tool Bar’).
‘mh-xemacs-use-tool-bar-flag’
If ‘on’, use tool bar (default: ‘on’, if supported).
In GNU Emacs, icons for some of MH-E’s functions are added to the
tool bar. In XEmacs, you have the opportunity to create a separate tool
bar for the MH-E icons.
In either case, you can select which of these functions you’d like to
see by customizing the options ‘mh-tool-bar-folder-buttons’ and
‘mh-tool-bar-letter-buttons’. As you probably guessed, the former
customizes the tool bar in MH-Folder mode and the latter in MH-Letter
mode. Both of these options present you with a list of functions; check
the functions whose icons you want to see and clear the check boxes for
those you don’t.
The function associated with the searching icon can be set via the
option ‘mh-tool-bar-search-function’. By default, this is set to
‘mh-search’. Searching. You can also choose ‘Other Function’
from the ‘Value Menu’ and enter a function of your own choosing.
XEmacs provides a couple of extra options. The first,
‘mh-xemacs-use-tool-bar-flag’, controls whether to show the MH-E icons
at all. By default, this option is turned on if the window system
supports tool bars. If your system doesn’t support tool bars, then you
won’t be able to turn on this option.
The second extra option is ‘mh-xemacs-tool-bar-position’ which
controls the placement of the tool bar along the four edges of the
frame. You can choose from one of ‘Same As Default Tool Bar’, ‘Top’,
‘Bottom’, ‘Left’, or ‘Right’. If this variable is set to anything other
than ‘Same As Default Tool Bar’ and the default tool bar is in a
different location, then two tool bars will be displayed: the MH-E tool
bar and the default tool bar.