[comp.soft-sys.andrew] cmenu.help

gk5g+@ANDREW.CMU.EDU (Gary Keim) (06/05/90)

I posted that I had made the cmenu help file conform to reality, but
then failed to let everyone see it.  Well, here it is.  Comments are
welcomed.

==================================================

Cmenu: Controlling the menus for Andrew applications

What cmenu is

        Cmenu is an Xlib-based menu package used by Andrew
        applications. Since it is also used by non-ATK applications,
        cmenu is customized by specifying X11 resources, rather than
        ATK preferences. The resources that affect cmenu's behavior
        are explained below.

Customizing the menus

    Below are some entries you can use to change the way that cmenus
    appear.  The default value for each entry is shown.  If you like the
    way the menus appear, there is no need to create or add cmenu
    resource entries.  In fact, setting some entries to their default
    values can cause unexpected results, so you should only add cmenu
    resource specifications if you want something other than the default.

    For a complete explanation of Xlib Resource Management please see
    Section 10.11 of the Xlib manual as well as Section 4.2 of the X
    Toolkit manual.

    TitleFont: AndySans12b
        Controls the font that is used for the label or title of each
        menu pane.  Any valid X font may be used.

    SelectionFont: AndySans12b
        Controls the font that is used for each selectable item on the
        menus.  Any valid X font may be used. 

    ClickInterval: 350
    This attribute (in milliseconds) determines the period of time, from
    the onset of the depression of the middle mouse button, during which
    you may release the middle mouse button and still have the menus up
    on the screen for selection purposes.  In other words, you can
    peruse the menu stack without having the middle mouse button
    depressed.  To select a menu option while in this state, you must
    again depress the middle mouse button on the selection of your
    choice.  There is an invisible bounding box around the menu stack
    which, if you cross while the menus are up, will force the menus to
    be retracted without a selection.

    OverlapPct: 0
        Determines the percentage of overlap that is used when flipping
        to the previous menu card.  By setting this value to 50, the
        user can move the mouse cursor halfway across a menu card before
        it flips to the previous card.  Setting this value to 100 will
        keep the current menu card showing until the user moves
        completely off the right edge of the card onto the previous
        card.  By setting this value to 0 (the default), the previous
        menu card will flip over after moving slightly past its left
        edge.  No setting of this value will cause the previous menu to
        be displayed without at least moving the mouse slightly past its
        left edge.

    UseSaveUnder: 1
    Determines whether or not the X server will save the bits under the
    menus so that the application will not have to redraw the window
    when the menus are retracted.  The default value is 1.  The reason
    this option exists is for those displays (like the QDSS) where save
    unders are available, but slower than just redrawing.

    MenuForeground: black
    Determines the color to use for the foreground when drawing the
    menus.  The default value for the foreground color is black.  This
    attribute is only consulted if the menus are being drawn on a color
    monitor.

    MenuBackground: white
    Determines the color to use for the background when drawing the
    menus.  The default value for the background color is white.  This
    attribute is only consulted if the menus are being drawn on a color
    monitor.


Related tools  

Select (highlight) one of the italicized names and choose "Show Help on
Selected Word" from the pop-up menu to see the help file for:

    preferences
    X(1)
    xrdb(1)