mh-e: Tool Bar

 
 14 The Tool Bar
 ***************
 
 Emacs also provides a graphical tool bar.  For a description of the tool
 bar, please SeeTool 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’.  SeeSearching.  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.