14 The Tool Bar

Emacs also provides a graphical tool bar. For a description of the tool bar, please see the section Tool Bars in The GNU Emacs Manual.

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. See Searching Through Messages. 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.