home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / tkisrc04.zip / tk / os2 / tkMenu.c < prev    next >
C/C++ Source or Header  |  1998-08-10  |  85KB  |  2,707 lines
  1. /* 
  2.  * tkMenu.c --
  3.  *
  4.  *    This module implements menus for the Tk toolkit.  The menus
  5.  *    support normal button entries, plus check buttons, radio
  6.  *    buttons, iconic forms of all of the above, and separator
  7.  *    entries.
  8.  *
  9.  * Copyright (c) 1990-1994 The Regents of the University of California.
  10.  * Copyright (c) 1994-1995 Sun Microsystems, Inc.
  11.  *
  12.  * See the file "license.terms" for information on usage and redistribution
  13.  * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  14.  *
  15.  * SCCS: @(#) tkMenu.c 1.102 96/03/26 16:07:08
  16.  */
  17.  
  18. #include "tkPort.h"
  19. #include "default.h"
  20. #include "tkInt.h"
  21.  
  22. /*
  23.  * One of the following data structures is kept for each entry of each
  24.  * menu managed by this file:
  25.  */
  26.  
  27. typedef struct MenuEntry {
  28.     int type;            /* Type of menu entry;  see below for
  29.                  * valid types. */
  30.     struct Menu *menuPtr;    /* Menu with which this entry is associated. */
  31.     char *label;        /* Main text label displayed in entry (NULL
  32.                  * if no label).  Malloc'ed. */
  33.     int labelLength;        /* Number of non-NULL characters in label. */
  34.     int underline;        /* Index of character to underline. */
  35.     Pixmap bitmap;        /* Bitmap to display in menu entry, or None.
  36.                  * If not None then label is ignored. */
  37.     char *imageString;        /* Name of image to display (malloc'ed), or
  38.                  * NULL.  If non-NULL, bitmap, text, and
  39.                  * textVarName are ignored. */
  40.     Tk_Image image;        /* Image to display in menu entry, or NULL if
  41.                  * none. */
  42.     char *selectImageString;    /* Name of image to display when selected
  43.                  * (malloc'ed), or NULL. */
  44.     Tk_Image selectImage;    /* Image to display in entry when selected,
  45.                  * or NULL if none.  Ignored if image is
  46.                  * NULL. */
  47.     char *accel;        /* Accelerator string displayed at right
  48.                  * of menu entry.  NULL means no such
  49.                  * accelerator.  Malloc'ed. */
  50.     int accelLength;        /* Number of non-NULL characters in
  51.                  * accelerator. */
  52.  
  53.     /*
  54.      * Information related to displaying entry:
  55.      */
  56.  
  57.     Tk_Uid state;        /* State of button for display purposes:
  58.                  * normal, active, or disabled. */
  59.     int height;            /* Number of pixels occupied by entry in
  60.                  * vertical dimension, including raised
  61.                  * border drawn around entry when active. */
  62.     int y;            /* Y-coordinate of topmost pixel in entry. */
  63.     int indicatorOn;        /* True means draw indicator, false means
  64.                  * don't draw it. */
  65.     int indicatorDiameter;    /* Size of indicator display, in pixels. */
  66.     Tk_3DBorder border;        /* Structure used to draw background for
  67.                  * entry.  NULL means use overall border
  68.                  * for menu. */
  69.     XColor *fg;            /* Foreground color to use for entry.  NULL
  70.                  * means use foreground color from menu. */
  71.     Tk_3DBorder activeBorder;    /* Used to draw background and border when
  72.                  * element is active.  NULL means use
  73.                  * activeBorder from menu. */
  74.     XColor *activeFg;        /* Foreground color to use when entry is
  75.                  * active.  NULL means use active foreground
  76.                  * from menu. */
  77.     XFontStruct *fontPtr;    /* Text font for menu entries.  NULL means
  78.                  * use overall font for menu. */
  79.     GC textGC;            /* GC for drawing text in entry.  NULL means
  80.                  * use overall textGC for menu. */
  81.     GC activeGC;        /* GC for drawing text in entry when active.
  82.                  * NULL means use overall activeGC for
  83.                  * menu. */
  84.     GC disabledGC;        /* Used to produce disabled effect for entry.
  85.                  * NULL means use overall disabledGC from
  86.                  * menu structure.  See comments for
  87.                  * disabledFg in menu structure for more
  88.                  * information. */
  89.     XColor *indicatorFg;    /* Color for indicators in radio and check
  90.                  * button entries.  NULL means use indicatorFg
  91.                  * GC from menu. */
  92.     GC indicatorGC;        /* For drawing indicators.  None means use
  93.                  * GC from menu. */
  94.  
  95.     /*
  96.      * Information used to implement this entry's action:
  97.      */
  98.  
  99.     char *command;        /* Command to invoke when entry is invoked.
  100.                  * Malloc'ed. */
  101.     char *name;            /* Name of variable (for check buttons and
  102.                  * radio buttons) or menu (for cascade
  103.                  * entries).  Malloc'ed.*/
  104.     char *onValue;        /* Value to store in variable when selected
  105.                  * (only for radio and check buttons).
  106.                  * Malloc'ed. */
  107.     char *offValue;        /* Value to store in variable when not
  108.                  * selected (only for check buttons).
  109.                  * Malloc'ed. */
  110.  
  111.     /*
  112.      * Miscellaneous information:
  113.      */
  114.  
  115.     int flags;            /* Various flags.  See below for definitions. */
  116. } MenuEntry;
  117.  
  118. /*
  119.  * Flag values defined for menu entries:
  120.  *
  121.  * ENTRY_SELECTED:        Non-zero means this is a radio or check
  122.  *                button and that it should be drawn in
  123.  *                the "selected" state.
  124.  * ENTRY_NEEDS_REDISPLAY:    Non-zero means the entry should be redisplayed.
  125.  */
  126.  
  127. #define ENTRY_SELECTED        1
  128. #define ENTRY_NEEDS_REDISPLAY    4
  129.  
  130. /*
  131.  * Types defined for MenuEntries:
  132.  */
  133.  
  134. #define COMMAND_ENTRY        0
  135. #define SEPARATOR_ENTRY        1
  136. #define CHECK_BUTTON_ENTRY    2
  137. #define RADIO_BUTTON_ENTRY    3
  138. #define CASCADE_ENTRY        4
  139. #define TEAROFF_ENTRY        5
  140.  
  141. /*
  142.  * Mask bits for above types:
  143.  */
  144.  
  145. #define COMMAND_MASK        TK_CONFIG_USER_BIT
  146. #define SEPARATOR_MASK        (TK_CONFIG_USER_BIT << 1)
  147. #define CHECK_BUTTON_MASK    (TK_CONFIG_USER_BIT << 2)
  148. #define RADIO_BUTTON_MASK    (TK_CONFIG_USER_BIT << 3)
  149. #define CASCADE_MASK        (TK_CONFIG_USER_BIT << 4)
  150. #define TEAROFF_MASK        (TK_CONFIG_USER_BIT << 5)
  151. #define ALL_MASK        (COMMAND_MASK | SEPARATOR_MASK \
  152.     | CHECK_BUTTON_MASK | RADIO_BUTTON_MASK | CASCADE_MASK | TEAROFF_MASK)
  153.  
  154. /*
  155.  * Configuration specs for individual menu entries:
  156.  */
  157.  
  158. static Tk_ConfigSpec entryConfigSpecs[] = {
  159.     {TK_CONFIG_BORDER, "-activebackground", (char *) NULL, (char *) NULL,
  160.     DEF_MENU_ENTRY_ACTIVE_BG, Tk_Offset(MenuEntry, activeBorder),
  161.     COMMAND_MASK|CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|CASCADE_MASK
  162.     |TK_CONFIG_NULL_OK},
  163.     {TK_CONFIG_COLOR, "-activeforeground", (char *) NULL, (char *) NULL,
  164.     DEF_MENU_ENTRY_ACTIVE_FG, Tk_Offset(MenuEntry, activeFg),
  165.     COMMAND_MASK|CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|CASCADE_MASK
  166.     |TK_CONFIG_NULL_OK},
  167.     {TK_CONFIG_STRING, "-accelerator", (char *) NULL, (char *) NULL,
  168.     DEF_MENU_ENTRY_ACCELERATOR, Tk_Offset(MenuEntry, accel),
  169.     COMMAND_MASK|CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|CASCADE_MASK
  170.     |TK_CONFIG_NULL_OK},
  171.     {TK_CONFIG_BORDER, "-background", (char *) NULL, (char *) NULL,
  172.     DEF_MENU_ENTRY_BG, Tk_Offset(MenuEntry, border),
  173.     COMMAND_MASK|CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|CASCADE_MASK
  174.     |SEPARATOR_MASK|TEAROFF_MASK|TK_CONFIG_NULL_OK},
  175.     {TK_CONFIG_BITMAP, "-bitmap", (char *) NULL, (char *) NULL,
  176.     DEF_MENU_ENTRY_BITMAP, Tk_Offset(MenuEntry, bitmap),
  177.     COMMAND_MASK|CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|CASCADE_MASK
  178.     |TK_CONFIG_NULL_OK},
  179.     {TK_CONFIG_STRING, "-command", (char *) NULL, (char *) NULL,
  180.     DEF_MENU_ENTRY_COMMAND, Tk_Offset(MenuEntry, command),
  181.     COMMAND_MASK|CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|CASCADE_MASK
  182.     |TK_CONFIG_NULL_OK},
  183.     {TK_CONFIG_FONT, "-font", (char *) NULL, (char *) NULL,
  184.     DEF_MENU_ENTRY_FONT, Tk_Offset(MenuEntry, fontPtr),
  185.     COMMAND_MASK|CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|CASCADE_MASK
  186.     |TK_CONFIG_NULL_OK},
  187.     {TK_CONFIG_COLOR, "-foreground", (char *) NULL, (char *) NULL,
  188.     DEF_MENU_ENTRY_FG, Tk_Offset(MenuEntry, fg),
  189.     COMMAND_MASK|CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|CASCADE_MASK
  190.     |TK_CONFIG_NULL_OK},
  191.     {TK_CONFIG_STRING, "-image", (char *) NULL, (char *) NULL,
  192.     DEF_MENU_ENTRY_IMAGE, Tk_Offset(MenuEntry, imageString),
  193.     COMMAND_MASK|CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|CASCADE_MASK
  194.     |TK_CONFIG_NULL_OK},
  195.     {TK_CONFIG_BOOLEAN, "-indicatoron", (char *) NULL, (char *) NULL,
  196.     DEF_MENU_ENTRY_INDICATOR, Tk_Offset(MenuEntry, indicatorOn),
  197.     CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|TK_CONFIG_DONT_SET_DEFAULT},
  198.     {TK_CONFIG_STRING, "-label", (char *) NULL, (char *) NULL,
  199.     DEF_MENU_ENTRY_LABEL, Tk_Offset(MenuEntry, label),
  200.     COMMAND_MASK|CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|CASCADE_MASK},
  201.     {TK_CONFIG_STRING, "-menu", (char *) NULL, (char *) NULL,
  202.     DEF_MENU_ENTRY_MENU, Tk_Offset(MenuEntry, name),
  203.     CASCADE_MASK|TK_CONFIG_NULL_OK},
  204.     {TK_CONFIG_STRING, "-offvalue", (char *) NULL, (char *) NULL,
  205.     DEF_MENU_ENTRY_OFF_VALUE, Tk_Offset(MenuEntry, offValue),
  206.     CHECK_BUTTON_MASK},
  207.     {TK_CONFIG_STRING, "-onvalue", (char *) NULL, (char *) NULL,
  208.     DEF_MENU_ENTRY_ON_VALUE, Tk_Offset(MenuEntry, onValue),
  209.     CHECK_BUTTON_MASK},
  210.     {TK_CONFIG_COLOR, "-selectcolor", (char *) NULL, (char *) NULL,
  211.     DEF_MENU_ENTRY_SELECT, Tk_Offset(MenuEntry, indicatorFg),
  212.     CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|TK_CONFIG_NULL_OK},
  213.     {TK_CONFIG_STRING, "-selectimage", (char *) NULL, (char *) NULL,
  214.     DEF_MENU_ENTRY_SELECT_IMAGE, Tk_Offset(MenuEntry, selectImageString),
  215.     CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|TK_CONFIG_NULL_OK},
  216.     {TK_CONFIG_UID, "-state", (char *) NULL, (char *) NULL,
  217.     DEF_MENU_ENTRY_STATE, Tk_Offset(MenuEntry, state),
  218.     COMMAND_MASK|CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|CASCADE_MASK
  219.     |TEAROFF_MASK|TK_CONFIG_DONT_SET_DEFAULT},
  220.     {TK_CONFIG_STRING, "-value", (char *) NULL, (char *) NULL,
  221.     DEF_MENU_ENTRY_VALUE, Tk_Offset(MenuEntry, onValue),
  222.     RADIO_BUTTON_MASK|TK_CONFIG_NULL_OK},
  223.     {TK_CONFIG_STRING, "-variable", (char *) NULL, (char *) NULL,
  224.     DEF_MENU_ENTRY_CHECK_VARIABLE, Tk_Offset(MenuEntry, name),
  225.     CHECK_BUTTON_MASK|TK_CONFIG_NULL_OK},
  226.     {TK_CONFIG_STRING, "-variable", (char *) NULL, (char *) NULL,
  227.     DEF_MENU_ENTRY_RADIO_VARIABLE, Tk_Offset(MenuEntry, name),
  228.     RADIO_BUTTON_MASK},
  229.     {TK_CONFIG_INT, "-underline", (char *) NULL, (char *) NULL,
  230.     DEF_MENU_ENTRY_UNDERLINE, Tk_Offset(MenuEntry, underline),
  231.     COMMAND_MASK|CHECK_BUTTON_MASK|RADIO_BUTTON_MASK|CASCADE_MASK
  232.     |TK_CONFIG_DONT_SET_DEFAULT},
  233.     {TK_CONFIG_END, (char *) NULL, (char *) NULL, (char *) NULL,
  234.     (char *) NULL, 0, 0}
  235. };
  236.  
  237. /*
  238.  * A data structure of the following type is kept for each
  239.  * menu managed by this file:
  240.  */
  241.  
  242. typedef struct Menu {
  243.     Tk_Window tkwin;        /* Window that embodies the pane.  NULL
  244.                  * means that the window has been destroyed
  245.                  * but the data structures haven't yet been
  246.                  * cleaned up.*/
  247.     Display *display;        /* Display containing widget.  Needed, among
  248.                  * other things, so that resources can be
  249.                  * freed up even after tkwin has gone away. */
  250.     Tcl_Interp *interp;        /* Interpreter associated with menu. */
  251.     Tcl_Command widgetCmd;    /* Token for menu's widget command. */
  252.     MenuEntry **entries;    /* Array of pointers to all the entries
  253.                  * in the menu.  NULL means no entries. */
  254.     int numEntries;        /* Number of elements in entries. */
  255.     int active;            /* Index of active entry.  -1 means
  256.                  * nothing active. */
  257.  
  258.     /*
  259.      * Information used when displaying widget:
  260.      */
  261.  
  262.     Tk_3DBorder border;        /* Structure used to draw 3-D
  263.                  * border and background for menu. */
  264.     int borderWidth;        /* Width of border around whole menu. */
  265.     Tk_3DBorder activeBorder;    /* Used to draw background and border for
  266.                  * active element (if any). */
  267.     int activeBorderWidth;    /* Width of border around active element. */
  268.     int relief;            /* 3-d effect: TK_RELIEF_RAISED, etc. */
  269.     XFontStruct *fontPtr;    /* Text font for menu entries. */
  270.     XColor *fg;            /* Foreground color for entries. */
  271.     GC textGC;            /* GC for drawing text and other features
  272.                  * of menu entries. */
  273.     XColor *disabledFg;        /* Foreground color when disabled.  NULL
  274.                  * means use normalFg with a 50% stipple
  275.                  * instead. */
  276.     Pixmap gray;        /* Bitmap for drawing disabled entries in
  277.                  * a stippled fashion.  None means not
  278.                  * allocated yet. */
  279.     GC disabledGC;        /* Used to produce disabled effect.  If
  280.                  * disabledFg isn't NULL, this GC is used to
  281.                  * draw text and icons for disabled entries.
  282.                  * Otherwise text and icons are drawn with
  283.                  * normalGC and this GC is used to stipple
  284.                  * background across them. */
  285.     XColor *activeFg;        /* Foreground color for active entry. */
  286.     GC activeGC;        /* GC for drawing active entry. */
  287.     XColor *indicatorFg;    /* Color for indicators in radio and check
  288.                  * button entries. */
  289.     GC indicatorGC;        /* For drawing indicators. */
  290.     int indicatorSpace;        /* Number of pixels to allow for displaying
  291.                  * indicators in menu entries (includes extra
  292.                  * space around indicator). */
  293.     int labelWidth;        /* Number of pixels to allow for displaying
  294.                  * labels in menu entries. */
  295.  
  296.     /*
  297.      * Miscellaneous information:
  298.      */
  299.  
  300.     int tearOff;        /* 1 means this is a tear-off menu, so the
  301.                  * first entry always shows a dashed stripe
  302.                  * for tearing off. */
  303.     char *tearOffCommand;    /* If non-NULL, points to a command to
  304.                  * run whenever the menu is torn-off. */
  305.     int transient;        /* 1 means menu is only posted briefly as
  306.                  * a popup or pulldown or cascade.  0 means
  307.                  * menu is always visible, e.g. as a torn-off
  308.                  * menu.  Determines whether save_under and
  309.                  * override_redirect should be set. */
  310.     Tk_Cursor cursor;        /* Current cursor for window, or None. */
  311.     char *takeFocus;        /* Value of -takefocus option;  not used in
  312.                  * the C code, but used by keyboard traversal
  313.                  * scripts.  Malloc'ed, but may be NULL. */
  314.     char *postCommand;        /* Command to execute just before posting
  315.                  * this menu, or NULL.  Malloc-ed. */
  316.     MenuEntry *postedCascade;    /* Points to menu entry for cascaded
  317.                  * submenu that is currently posted, or
  318.                  * NULL if no submenu posted. */
  319.     int flags;            /* Various flags;  see below for
  320.                  * definitions. */
  321. } Menu;
  322.  
  323. /*
  324.  * Flag bits for menus:
  325.  *
  326.  * REDRAW_PENDING:        Non-zero means a DoWhenIdle handler
  327.  *                has already been queued to redraw
  328.  *                this window.
  329.  * RESIZE_PENDING:        Non-zero means a call to ComputeMenuGeometry
  330.  *                has already been scheduled.
  331.  */
  332.  
  333. #define REDRAW_PENDING        1
  334. #define RESIZE_PENDING        2
  335.  
  336. /*
  337.  * Configuration specs valid for the menu as a whole:
  338.  */
  339.  
  340. static Tk_ConfigSpec configSpecs[] = {
  341.     {TK_CONFIG_BORDER, "-activebackground", "activeBackground", "Foreground",
  342.     DEF_MENU_ACTIVE_BG_COLOR, Tk_Offset(Menu, activeBorder),
  343.     TK_CONFIG_COLOR_ONLY},
  344.     {TK_CONFIG_BORDER, "-activebackground", "activeBackground", "Foreground",
  345.     DEF_MENU_ACTIVE_BG_MONO, Tk_Offset(Menu, activeBorder),
  346.     TK_CONFIG_MONO_ONLY},
  347.     {TK_CONFIG_PIXELS, "-activeborderwidth", "activeBorderWidth", "BorderWidth",
  348.     DEF_MENU_ACTIVE_BORDER_WIDTH, Tk_Offset(Menu, activeBorderWidth), 0},
  349.     {TK_CONFIG_COLOR, "-activeforeground", "activeForeground", "Background",
  350.     DEF_MENU_ACTIVE_FG_COLOR, Tk_Offset(Menu, activeFg),
  351.     TK_CONFIG_COLOR_ONLY},
  352.     {TK_CONFIG_COLOR, "-activeforeground", "activeForeground", "Background",
  353.     DEF_MENU_ACTIVE_FG_MONO, Tk_Offset(Menu, activeFg),
  354.     TK_CONFIG_MONO_ONLY},
  355.     {TK_CONFIG_BORDER, "-background", "background", "Background",
  356.     DEF_MENU_BG_COLOR, Tk_Offset(Menu, border), TK_CONFIG_COLOR_ONLY},
  357.     {TK_CONFIG_BORDER, "-background", "background", "Background",
  358.     DEF_MENU_BG_MONO, Tk_Offset(Menu, border), TK_CONFIG_MONO_ONLY},
  359.     {TK_CONFIG_SYNONYM, "-bd", "borderWidth", (char *) NULL,
  360.     (char *) NULL, 0, 0},
  361.     {TK_CONFIG_SYNONYM, "-bg", "background", (char *) NULL,
  362.     (char *) NULL, 0, 0},
  363.     {TK_CONFIG_PIXELS, "-borderwidth", "borderWidth", "BorderWidth",
  364.     DEF_MENU_BORDER_WIDTH, Tk_Offset(Menu, borderWidth), 0},
  365.     {TK_CONFIG_ACTIVE_CURSOR, "-cursor", "cursor", "Cursor",
  366.     DEF_MENU_CURSOR, Tk_Offset(Menu, cursor), TK_CONFIG_NULL_OK},
  367.     {TK_CONFIG_COLOR, "-disabledforeground", "disabledForeground",
  368.     "DisabledForeground", DEF_MENU_DISABLED_FG_COLOR,
  369.     Tk_Offset(Menu, disabledFg), TK_CONFIG_COLOR_ONLY|TK_CONFIG_NULL_OK},
  370.     {TK_CONFIG_COLOR, "-disabledforeground", "disabledForeground",
  371.     "DisabledForeground", DEF_MENU_DISABLED_FG_MONO,
  372.     Tk_Offset(Menu, disabledFg), TK_CONFIG_MONO_ONLY|TK_CONFIG_NULL_OK},
  373.     {TK_CONFIG_SYNONYM, "-fg", "foreground", (char *) NULL,
  374.     (char *) NULL, 0, 0},
  375.     {TK_CONFIG_FONT, "-font", "font", "Font",
  376.     DEF_MENU_FONT, Tk_Offset(Menu, fontPtr), 0},
  377.     {TK_CONFIG_COLOR, "-foreground", "foreground", "Foreground",
  378.     DEF_MENU_FG, Tk_Offset(Menu, fg), 0},
  379.     {TK_CONFIG_STRING, "-postcommand", "postCommand", "Command",
  380.     DEF_MENU_POST_COMMAND, Tk_Offset(Menu, postCommand), TK_CONFIG_NULL_OK},
  381.     {TK_CONFIG_RELIEF, "-relief", "relief", "Relief",
  382.     DEF_MENU_RELIEF, Tk_Offset(Menu, relief), 0},
  383.     {TK_CONFIG_COLOR, "-selectcolor", "selectColor", "Background",
  384.     DEF_MENU_SELECT_COLOR, Tk_Offset(Menu, indicatorFg),
  385.     TK_CONFIG_COLOR_ONLY},
  386.     {TK_CONFIG_COLOR, "-selectcolor", "selectColor", "Background",
  387.     DEF_MENU_SELECT_MONO, Tk_Offset(Menu, indicatorFg),
  388.     TK_CONFIG_MONO_ONLY},
  389.     {TK_CONFIG_STRING, "-takefocus", "takeFocus", "TakeFocus",
  390.     DEF_MENU_TAKE_FOCUS, Tk_Offset(Menu, takeFocus), TK_CONFIG_NULL_OK},
  391.     {TK_CONFIG_BOOLEAN, "-tearoff", "tearOff", "TearOff",
  392.     DEF_MENU_TEAROFF, Tk_Offset(Menu, tearOff), 0},
  393.     {TK_CONFIG_STRING, "-tearoffcommand", "tearOffCommand", "TearOffCommand",
  394.     DEF_MENU_TEAROFF_CMD, Tk_Offset(Menu, tearOffCommand),
  395.     TK_CONFIG_NULL_OK},
  396.     {TK_CONFIG_BOOLEAN, "-transient", "transient", "Transient",
  397.     DEF_MENU_TRANSIENT, Tk_Offset(Menu, transient), 0},
  398.     {TK_CONFIG_END, (char *) NULL, (char *) NULL, (char *) NULL,
  399.     (char *) NULL, 0, 0}
  400. };
  401.  
  402. /*
  403.  * Various geometry definitions:
  404.  */
  405.  
  406. #define CASCADE_ARROW_HEIGHT 10
  407. #define CASCADE_ARROW_WIDTH 8
  408. #define DECORATION_BORDER_WIDTH 2
  409. #define MARGIN_WIDTH 2
  410.  
  411. /*
  412.  * Forward declarations for procedures defined later in this file:
  413.  */
  414.  
  415. static int        ActivateMenuEntry _ANSI_ARGS_((Menu *menuPtr,
  416.                 int index));
  417. static void        ComputeMenuGeometry _ANSI_ARGS_((
  418.                 ClientData clientData));
  419. static int        ConfigureMenu _ANSI_ARGS_((Tcl_Interp *interp,
  420.                 Menu *menuPtr, int argc, char **argv,
  421.                 int flags));
  422. static int        ConfigureMenuEntry _ANSI_ARGS_((Tcl_Interp *interp,
  423.                 Menu *menuPtr, MenuEntry *mePtr, int index,
  424.                 int argc, char **argv, int flags));
  425. static void        DestroyMenu _ANSI_ARGS_((char *memPtr));
  426. static void        DestroyMenuEntry _ANSI_ARGS_((char *memPtr));
  427. static void        DisplayMenu _ANSI_ARGS_((ClientData clientData));
  428. static void        EventuallyRedrawMenu _ANSI_ARGS_((Menu *menuPtr,
  429.                 MenuEntry *mePtr));
  430. static int        GetMenuIndex _ANSI_ARGS_((Tcl_Interp *interp,
  431.                 Menu *menuPtr, char *string, int lastOK,
  432.                 int *indexPtr));
  433. static int        MenuAddOrInsert _ANSI_ARGS_((Tcl_Interp *interp,
  434.                 Menu *menuPtr, char *indexString, int argc,
  435.                 char **argv));
  436. static void        MenuCmdDeletedProc _ANSI_ARGS_((
  437.                 ClientData clientData));
  438. static void        MenuEventProc _ANSI_ARGS_((ClientData clientData,
  439.                 XEvent *eventPtr));
  440. static void        MenuImageProc _ANSI_ARGS_((ClientData clientData,
  441.                 int x, int y, int width, int height, int imgWidth,
  442.                 int imgHeight));
  443. static MenuEntry *    MenuNewEntry _ANSI_ARGS_((Menu *menuPtr, int index,
  444.                 int type));
  445. static void        MenuSelectImageProc _ANSI_ARGS_((ClientData clientData,
  446.                 int x, int y, int width, int height, int imgWidth,
  447.                 int imgHeight));
  448. static char *        MenuVarProc _ANSI_ARGS_((ClientData clientData,
  449.                 Tcl_Interp *interp, char *name1, char *name2,
  450.                 int flags));
  451. static int        MenuWidgetCmd _ANSI_ARGS_((ClientData clientData,
  452.                 Tcl_Interp *interp, int argc, char **argv));
  453. static int        PostSubmenu _ANSI_ARGS_((Tcl_Interp *interp,
  454.                 Menu *menuPtr, MenuEntry *mePtr));
  455.  
  456. /*
  457.  *--------------------------------------------------------------
  458.  *
  459.  * Tk_MenuCmd --
  460.  *
  461.  *    This procedure is invoked to process the "menu" Tcl
  462.  *    command.  See the user documentation for details on
  463.  *    what it does.
  464.  *
  465.  * Results:
  466.  *    A standard Tcl result.
  467.  *
  468.  * Side effects:
  469.  *    See the user documentation.
  470.  *
  471.  *--------------------------------------------------------------
  472.  */
  473.  
  474. int
  475. Tk_MenuCmd(clientData, interp, argc, argv)
  476.     ClientData clientData;    /* Main window associated with
  477.                  * interpreter. */
  478.     Tcl_Interp *interp;        /* Current interpreter. */
  479.     int argc;            /* Number of arguments. */
  480.     char **argv;        /* Argument strings. */
  481. {
  482.     Tk_Window tkwin = (Tk_Window) clientData;
  483.     Tk_Window new;
  484.     register Menu *menuPtr;
  485.  
  486.     if (argc < 2) {
  487.     Tcl_AppendResult(interp, "wrong # args: should be \"",
  488.         argv[0], " pathName ?options?\"", (char *) NULL);
  489.     return TCL_ERROR;
  490.     }
  491.  
  492.     /*
  493.      * Create the new window.  Set override-redirect so the window
  494.      * manager won't add a border or argue about placement, and set
  495.      * save-under so that the window can pop up and down without a
  496.      * lot of re-drawing.
  497.      */
  498.  
  499.     new = Tk_CreateWindowFromPath(interp, tkwin, argv[1], "");
  500.     if (new == NULL) {
  501.     return TCL_ERROR;
  502.     }
  503.  
  504.     /*
  505.      * Initialize the data structure for the menu.
  506.      */
  507.  
  508.     menuPtr = (Menu *) ckalloc(sizeof(Menu));
  509.     menuPtr->tkwin = new;
  510.     menuPtr->display = Tk_Display(new);
  511.     menuPtr->interp = interp;
  512.     menuPtr->widgetCmd = Tcl_CreateCommand(interp,
  513.         Tk_PathName(menuPtr->tkwin), MenuWidgetCmd,
  514.         (ClientData) menuPtr, MenuCmdDeletedProc);
  515.     menuPtr->entries = NULL;
  516.     menuPtr->numEntries = 0;
  517.     menuPtr->active = -1;
  518.     menuPtr->border = NULL;
  519.     menuPtr->borderWidth = 0;
  520.     menuPtr->relief = TK_RELIEF_FLAT;
  521.     menuPtr->activeBorder = NULL;
  522.     menuPtr->activeBorderWidth = 0;
  523.     menuPtr->fontPtr = NULL;
  524.     menuPtr->fg = NULL;
  525.     menuPtr->textGC = None;
  526.     menuPtr->disabledFg = NULL;
  527.     menuPtr->gray = None;
  528.     menuPtr->disabledGC = None;
  529.     menuPtr->activeFg = NULL;
  530.     menuPtr->activeGC = None;
  531.     menuPtr->indicatorFg = NULL;
  532.     menuPtr->indicatorGC = None;
  533.     menuPtr->indicatorSpace = 0;
  534.     menuPtr->labelWidth = 0;
  535.     menuPtr->tearOff = 1;
  536.     menuPtr->tearOffCommand = NULL;
  537.     menuPtr->cursor = None;
  538.     menuPtr->takeFocus = NULL;
  539.     menuPtr->postCommand = NULL;
  540.     menuPtr->postedCascade = NULL;
  541.     menuPtr->flags = 0;
  542.  
  543.     Tk_SetClass(new, "Menu");
  544.     Tk_CreateEventHandler(menuPtr->tkwin, ExposureMask|StructureNotifyMask,
  545.         MenuEventProc, (ClientData) menuPtr);
  546.     if (ConfigureMenu(interp, menuPtr, argc-2, argv+2, 0) != TCL_OK) {
  547.     goto error;
  548.     }
  549.  
  550.     interp->result = Tk_PathName(menuPtr->tkwin);
  551.     return TCL_OK;
  552.  
  553.     error:
  554.     Tk_DestroyWindow(menuPtr->tkwin);
  555.     return TCL_ERROR;
  556. }
  557.  
  558. /*
  559.  *--------------------------------------------------------------
  560.  *
  561.  * MenuWidgetCmd --
  562.  *
  563.  *    This procedure is invoked to process the Tcl command
  564.  *    that corresponds to a widget managed by this module.
  565.  *    See the user documentation for details on what it does.
  566.  *
  567.  * Results:
  568.  *    A standard Tcl result.
  569.  *
  570.  * Side effects:
  571.  *    See the user documentation.
  572.  *
  573.  *--------------------------------------------------------------
  574.  */
  575.  
  576. static int
  577. MenuWidgetCmd(clientData, interp, argc, argv)
  578.     ClientData clientData;    /* Information about menu widget. */
  579.     Tcl_Interp *interp;        /* Current interpreter. */
  580.     int argc;            /* Number of arguments. */
  581.     char **argv;        /* Argument strings. */
  582. {
  583.     register Menu *menuPtr = (Menu *) clientData;
  584.     register MenuEntry *mePtr;
  585.     int result = TCL_OK;
  586.     size_t length;
  587.     int c;
  588.  
  589.     if (argc < 2) {
  590.     Tcl_AppendResult(interp, "wrong # args: should be \"",
  591.         argv[0], " option ?arg arg ...?\"", (char *) NULL);
  592.     return TCL_ERROR;
  593.     }
  594.     Tcl_Preserve((ClientData) menuPtr);
  595.     c = argv[1][0];
  596.     length = strlen(argv[1]);
  597.     if ((c == 'a') && (strncmp(argv[1], "activate", length) == 0)
  598.         && (length >= 2)) {
  599.     int index;
  600.  
  601.     if (argc != 3) {
  602.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  603.             argv[0], " activate index\"", (char *) NULL);
  604.         goto error;
  605.     }
  606.     if (GetMenuIndex(interp, menuPtr, argv[2], 0, &index) != TCL_OK) {
  607.         goto error;
  608.     }
  609.     if (menuPtr->active == index) {
  610.         goto done;
  611.     }
  612.     if (index >= 0) {
  613.         if ((menuPtr->entries[index]->type == SEPARATOR_ENTRY)
  614.             || (menuPtr->entries[index]->state == tkDisabledUid)) {
  615.         index = -1;
  616.         }
  617.     }
  618.     result = ActivateMenuEntry(menuPtr, index);
  619.     } else if ((c == 'a') && (strncmp(argv[1], "add", length) == 0)
  620.         && (length >= 2)) {
  621.     if (argc < 3) {
  622.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  623.             argv[0], " add type ?options?\"", (char *) NULL);
  624.         goto error;
  625.     }
  626.     if (MenuAddOrInsert(interp, menuPtr, (char *) NULL,
  627.         argc-2, argv+2) != TCL_OK) {
  628.         goto error;
  629.     }
  630.     } else if ((c == 'c') && (strncmp(argv[1], "cget", length) == 0)
  631.         && (length >= 2)) {
  632.     if (argc != 3) {
  633.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  634.             argv[0], " cget option\"",
  635.             (char *) NULL);
  636.         goto error;
  637.     }
  638.     result = Tk_ConfigureValue(interp, menuPtr->tkwin, configSpecs,
  639.         (char *) menuPtr, argv[2], 0);
  640.     } else if ((c == 'c') && (strncmp(argv[1], "configure", length) == 0)
  641.         && (length >= 2)) {
  642.     if (argc == 2) {
  643.         result = Tk_ConfigureInfo(interp, menuPtr->tkwin, configSpecs,
  644.             (char *) menuPtr, (char *) NULL, 0);
  645.     } else if (argc == 3) {
  646.         result = Tk_ConfigureInfo(interp, menuPtr->tkwin, configSpecs,
  647.             (char *) menuPtr, argv[2], 0);
  648.     } else {
  649.         result = ConfigureMenu(interp, menuPtr, argc-2, argv+2,
  650.             TK_CONFIG_ARGV_ONLY);
  651.     }
  652.     } else if ((c == 'd') && (strncmp(argv[1], "delete", length) == 0)) {
  653.     int first, last, i, numDeleted;
  654.  
  655.     if ((argc != 3) && (argc != 4)) {
  656.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  657.             argv[0], " delete first ?last?\"", (char *) NULL);
  658.         goto error;
  659.     }
  660.     if (GetMenuIndex(interp, menuPtr, argv[2], 0, &first) != TCL_OK) {
  661.         goto error;
  662.     }
  663.     if (argc == 3) {
  664.         last = first;
  665.     } else {
  666.         if (GetMenuIndex(interp, menuPtr, argv[3], 0, &last) != TCL_OK) {
  667.             goto error;
  668.         }
  669.     }
  670.     if (menuPtr->tearOff && (first == 0)) {
  671.         /*
  672.          * Sorry, can't delete the tearoff entry;  must reconfigure
  673.          * the menu.
  674.          */
  675.         first = 1;
  676.     }
  677.     if ((first < 0) || (last < first)) {
  678.         goto done;
  679.     }
  680.     numDeleted = last + 1 - first;
  681.     for (i = first; i <= last; i++) {
  682.         Tcl_EventuallyFree((ClientData) menuPtr->entries[i],
  683.                   DestroyMenuEntry);
  684.     }
  685.     for (i = last+1; i < menuPtr->numEntries; i++) {
  686.         menuPtr->entries[i-numDeleted] = menuPtr->entries[i];
  687.     }
  688.     menuPtr->numEntries -= numDeleted;
  689.     if ((menuPtr->active >= first) && (menuPtr->active <= last)) {
  690.         menuPtr->active = -1;
  691.     } else if (menuPtr->active > last) {
  692.         menuPtr->active -= numDeleted;
  693.     }
  694.     if (!(menuPtr->flags & RESIZE_PENDING)) {
  695.         menuPtr->flags |= RESIZE_PENDING;
  696.         Tcl_DoWhenIdle(ComputeMenuGeometry, (ClientData) menuPtr);
  697.     }
  698.     } else if ((c == 'e') && (length >= 7)
  699.         && (strncmp(argv[1], "entrycget", length) == 0)) {
  700.     int index;
  701.  
  702.     if (argc != 4) {
  703.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  704.             argv[0], " entrycget index option\"",
  705.             (char *) NULL);
  706.         goto error;
  707.     }
  708.     if (GetMenuIndex(interp, menuPtr, argv[2], 0, &index) != TCL_OK) {
  709.         goto error;
  710.     }
  711.     if (index < 0) {
  712.         goto done;
  713.     }
  714.     mePtr = menuPtr->entries[index];
  715.     Tcl_Preserve((ClientData) mePtr);
  716.     result = Tk_ConfigureValue(interp, menuPtr->tkwin, entryConfigSpecs,
  717.         (char *) mePtr, argv[3], COMMAND_MASK << mePtr->type);
  718.     Tcl_Release((ClientData) mePtr);
  719.     } else if ((c == 'e') && (length >= 7)
  720.         && (strncmp(argv[1], "entryconfigure", length) == 0)) {
  721.     int index;
  722.  
  723.     if (argc < 3) {
  724.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  725.             argv[0], " entryconfigure index ?option value ...?\"",
  726.             (char *) NULL);
  727.         goto error;
  728.     }
  729.     if (GetMenuIndex(interp, menuPtr, argv[2], 0, &index) != TCL_OK) {
  730.         goto error;
  731.     }
  732.     if (index < 0) {
  733.         goto done;
  734.     }
  735.     mePtr = menuPtr->entries[index];
  736.     Tcl_Preserve((ClientData) mePtr);
  737.     if (argc == 3) {
  738.         result = Tk_ConfigureInfo(interp, menuPtr->tkwin, entryConfigSpecs,
  739.             (char *) mePtr, (char *) NULL,
  740.             COMMAND_MASK << mePtr->type);
  741.     } else if (argc == 4) {
  742.         result = Tk_ConfigureInfo(interp, menuPtr->tkwin, entryConfigSpecs,
  743.             (char *) mePtr, argv[3], COMMAND_MASK << mePtr->type);
  744.     } else {
  745.         result = ConfigureMenuEntry(interp, menuPtr, mePtr, index, argc-3,
  746.             argv+3, TK_CONFIG_ARGV_ONLY | COMMAND_MASK << mePtr->type);
  747.     }
  748.     Tcl_Release((ClientData) mePtr);
  749.     } else if ((c == 'i') && (strncmp(argv[1], "index", length) == 0)
  750.         && (length >= 3)) {
  751.     int index;
  752.  
  753.     if (argc != 3) {
  754.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  755.             argv[0], " index string\"", (char *) NULL);
  756.         goto error;
  757.     }
  758.     if (GetMenuIndex(interp, menuPtr, argv[2], 0, &index) != TCL_OK) {
  759.         goto error;
  760.     }
  761.     if (index < 0) {
  762.         interp->result = "none";
  763.     } else {
  764.         sprintf(interp->result, "%d", index);
  765.     }
  766.     } else if ((c == 'i') && (strncmp(argv[1], "insert", length) == 0)
  767.         && (length >= 3)) {
  768.     if (argc < 4) {
  769.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  770.             argv[0], " insert index type ?options?\"", (char *) NULL);
  771.         goto error;
  772.     }
  773.     if (MenuAddOrInsert(interp, menuPtr, argv[2],
  774.         argc-3, argv+3) != TCL_OK) {
  775.         goto error;
  776.     }
  777.     } else if ((c == 'i') && (strncmp(argv[1], "invoke", length) == 0)
  778.         && (length >= 3)) {
  779.     int index;
  780.  
  781.     if (argc != 3) {
  782.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  783.             argv[0], " invoke index\"", (char *) NULL);
  784.         goto error;
  785.     }
  786.     if (GetMenuIndex(interp, menuPtr, argv[2], 0, &index) != TCL_OK) {
  787.         goto error;
  788.     }
  789.     if (index < 0) {
  790.         goto done;
  791.     }
  792.     mePtr = menuPtr->entries[index];
  793.     if (mePtr->state == tkDisabledUid) {
  794.         goto done;
  795.     }
  796.     Tcl_Preserve((ClientData) mePtr);
  797.     if (mePtr->type == CHECK_BUTTON_ENTRY) {
  798.         if (mePtr->flags & ENTRY_SELECTED) {
  799.         if (Tcl_SetVar(interp, mePtr->name, mePtr->offValue,
  800.             TCL_GLOBAL_ONLY|TCL_LEAVE_ERR_MSG) == NULL) {
  801.             result = TCL_ERROR;
  802.         }
  803.         } else {
  804.         if (Tcl_SetVar(interp, mePtr->name, mePtr->onValue,
  805.             TCL_GLOBAL_ONLY|TCL_LEAVE_ERR_MSG) == NULL) {
  806.             result = TCL_ERROR;
  807.         }
  808.         }
  809.     } else if (mePtr->type == RADIO_BUTTON_ENTRY) {
  810.         if (Tcl_SetVar(interp, mePtr->name, mePtr->onValue,
  811.             TCL_GLOBAL_ONLY|TCL_LEAVE_ERR_MSG) == NULL) {
  812.         result = TCL_ERROR;
  813.         }
  814.     }
  815.     if ((result == TCL_OK) && (mePtr->command != NULL)) {
  816.         result = TkCopyAndGlobalEval(interp, mePtr->command);
  817.     }
  818.     if ((result == TCL_OK) && (mePtr->type == CASCADE_ENTRY)) {
  819.         result = PostSubmenu(menuPtr->interp, menuPtr, mePtr);
  820.     }
  821.     Tcl_Release((ClientData) mePtr);
  822.     } else if ((c == 'p') && (strncmp(argv[1], "post", length) == 0)
  823.         && (length == 4)) {
  824.     int x, y, tmp, vRootX, vRootY;
  825.     int vRootWidth, vRootHeight;
  826.  
  827.     if (argc != 4) {
  828.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  829.             argv[0], " post x y\"", (char *) NULL);
  830.         goto error;
  831.     }
  832.     if ((Tcl_GetInt(interp, argv[2], &x) != TCL_OK)
  833.         || (Tcl_GetInt(interp, argv[3], &y) != TCL_OK)) {
  834.         goto error;
  835.     }
  836.  
  837.     /*
  838.      * De-activate any active element.
  839.      */
  840.  
  841.     ActivateMenuEntry(menuPtr, -1);
  842.  
  843.     /*
  844.      * If there is a command for the menu, execute it.  This
  845.      * may change the size of the menu, so be sure to recompute
  846.      * the menu's geometry if needed.
  847.      */
  848.  
  849.     if (menuPtr->postCommand != NULL) {
  850.         result = TkCopyAndGlobalEval(menuPtr->interp,
  851.             menuPtr->postCommand);
  852.         if (result != TCL_OK) {
  853.         return result;
  854.         }
  855.         if (menuPtr->flags & RESIZE_PENDING) {
  856.         Tcl_CancelIdleCall(ComputeMenuGeometry, (ClientData) menuPtr);
  857.         ComputeMenuGeometry((ClientData) menuPtr);
  858.         }
  859.     }
  860.  
  861.     /*
  862.      * Adjust the position of the menu if necessary to keep it
  863.      * visible on the screen.  There are two special tricks to
  864.      * make this work right:
  865.      *
  866.      * 1. If a virtual root window manager is being used then
  867.      *    the coordinates are in the virtual root window of
  868.      *    menuPtr's parent;  since the menu uses override-redirect
  869.      *    mode it will be in the *real* root window for the screen,
  870.      *    so we have to map the coordinates from the virtual root
  871.      *    (if any) to the real root.  Can't get the virtual root
  872.      *    from the menu itself (it will never be seen by the wm)
  873.      *    so use its parent instead (it would be better to have an
  874.      *    an option that names a window to use for this...).
  875.      * 2. The menu may not have been mapped yet, so its current size
  876.      *    might be the default 1x1.  To compute how much space it
  877.      *    needs, use its requested size, not its actual size.
  878.      */
  879.  
  880.     Tk_GetVRootGeometry(Tk_Parent(menuPtr->tkwin), &vRootX, &vRootY,
  881.         &vRootWidth, &vRootHeight);
  882.     x += vRootX;
  883.     y += vRootY;
  884.     tmp = WidthOfScreen(Tk_Screen(menuPtr->tkwin))
  885.         - Tk_ReqWidth(menuPtr->tkwin);
  886.     if (x > tmp) {
  887.         x = tmp;
  888.     }
  889.     if (x < 0) {
  890.         x = 0;
  891.     }
  892.     tmp = HeightOfScreen(Tk_Screen(menuPtr->tkwin))
  893.         - Tk_ReqHeight(menuPtr->tkwin);
  894.     if (y > tmp) {
  895.         y = tmp;
  896.     }
  897.     if (y < 0) {
  898.         y = 0;
  899.     }
  900.     if ((x != Tk_X(menuPtr->tkwin)) || (y != Tk_Y(menuPtr->tkwin))) {
  901.         Tk_MoveToplevelWindow(menuPtr->tkwin, x, y);
  902.     }
  903.     if (!Tk_IsMapped(menuPtr->tkwin)) {
  904.         Tk_MapWindow(menuPtr->tkwin);
  905.     }
  906.     XRaiseWindow(menuPtr->display, Tk_WindowId(menuPtr->tkwin));
  907.     } else if ((c == 'p') && (strncmp(argv[1], "postcascade", length) == 0)
  908.         && (length > 4)) {
  909.     int index;
  910.     if (argc != 3) {
  911.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  912.             argv[0], " postcascade index\"", (char *) NULL);
  913.         goto error;
  914.     }
  915.     if (GetMenuIndex(interp, menuPtr, argv[2], 0, &index) != TCL_OK) {
  916.         goto error;
  917.     }
  918.     if ((index < 0) || (menuPtr->entries[index]->type != CASCADE_ENTRY)) {
  919.         result = PostSubmenu(interp, menuPtr, (MenuEntry *) NULL);
  920.     } else {
  921.         result = PostSubmenu(interp, menuPtr, menuPtr->entries[index]);
  922.     }
  923.     } else if ((c == 't') && (strncmp(argv[1], "type", length) == 0)) {
  924.     int index;
  925.     if (argc != 3) {
  926.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  927.             argv[0], " type index\"", (char *) NULL);
  928.         goto error;
  929.     }
  930.     if (GetMenuIndex(interp, menuPtr, argv[2], 0, &index) != TCL_OK) {
  931.         goto error;
  932.     }
  933.     if (index < 0) {
  934.         goto done;
  935.     }
  936.     mePtr = menuPtr->entries[index];
  937.     switch (mePtr->type) {
  938.         case COMMAND_ENTRY:
  939.         interp->result = "command";
  940.         break;
  941.         case SEPARATOR_ENTRY:
  942.         interp->result = "separator";
  943.         break;
  944.         case CHECK_BUTTON_ENTRY:
  945.         interp->result = "checkbutton";
  946.         break;
  947.         case RADIO_BUTTON_ENTRY:
  948.         interp->result = "radiobutton";
  949.         break;
  950.         case CASCADE_ENTRY:
  951.         interp->result = "cascade";
  952.         break;
  953.         case TEAROFF_ENTRY:
  954.         interp->result = "tearoff";
  955.         break;
  956.     }
  957.     } else if ((c == 'u') && (strncmp(argv[1], "unpost", length) == 0)) {
  958.     if (argc != 2) {
  959.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  960.             argv[0], " unpost\"", (char *) NULL);
  961.         goto error;
  962.     }
  963.     Tk_UnmapWindow(menuPtr->tkwin);
  964.     if (result == TCL_OK) {
  965.         result = PostSubmenu(interp, menuPtr, (MenuEntry *) NULL);
  966.     }
  967.     } else if ((c == 'y') && (strncmp(argv[1], "yposition", length) == 0)) {
  968.     int index;
  969.  
  970.     if (argc != 3) {
  971.         Tcl_AppendResult(interp, "wrong # args: should be \"",
  972.             argv[0], " yposition index\"", (char *) NULL);
  973.         goto error;
  974.     }
  975.     if (GetMenuIndex(interp, menuPtr, argv[2], 0, &index) != TCL_OK) {
  976.         goto error;
  977.     }
  978.     if (index < 0) {
  979.         interp->result = "0";
  980.     } else {
  981.         sprintf(interp->result, "%d", menuPtr->entries[index]->y);
  982.     }
  983.     } else {
  984.     Tcl_AppendResult(interp, "bad option \"", argv[1],
  985.         "\": must be activate, add, cget, configure, delete, ",
  986.         "entrycget, entryconfigure, index, insert, invoke, ",
  987.         "post, postcascade, type, unpost, or yposition",
  988.         (char *) NULL);
  989.     goto error;
  990.     }
  991.     done:
  992.     Tcl_Release((ClientData) menuPtr);
  993.     return result;
  994.  
  995.     error:
  996.     Tcl_Release((ClientData) menuPtr);
  997.     return TCL_ERROR;
  998. }
  999.  
  1000. /*
  1001.  *----------------------------------------------------------------------
  1002.  *
  1003.  * DestroyMenu --
  1004.  *
  1005.  *    This procedure is invoked by Tcl_EventuallyFree or Tcl_Release
  1006.  *    to clean up the internal structure of a menu at a safe time
  1007.  *    (when no-one is using it anymore).
  1008.  *
  1009.  * Results:
  1010.  *    None.
  1011.  *
  1012.  * Side effects:
  1013.  *    Everything associated with the menu is freed up.
  1014.  *
  1015.  *----------------------------------------------------------------------
  1016.  */
  1017.  
  1018. static void
  1019. DestroyMenu(memPtr)
  1020.     char *memPtr;    /* Info about menu widget. */
  1021. {
  1022.     register Menu *menuPtr = (Menu *) memPtr;
  1023.     int i;
  1024.  
  1025.     /*
  1026.      * Free up all the stuff that requires special handling, then
  1027.      * let Tk_FreeOptions handle all the standard option-related
  1028.      * stuff.
  1029.      */
  1030.  
  1031.     for (i = 0; i < menuPtr->numEntries; i++) {
  1032.     DestroyMenuEntry((char *) menuPtr->entries[i]);
  1033.     }
  1034.     if (menuPtr->entries != NULL) {
  1035.     ckfree((char *) menuPtr->entries);
  1036.     }
  1037.     if (menuPtr->textGC != None) {
  1038.     Tk_FreeGC(menuPtr->display, menuPtr->textGC);
  1039.     }
  1040.     if (menuPtr->gray != None) {
  1041.     Tk_FreeBitmap(menuPtr->display, menuPtr->gray);
  1042.     }
  1043.     if (menuPtr->disabledGC != None) {
  1044.     Tk_FreeGC(menuPtr->display, menuPtr->disabledGC);
  1045.     }
  1046.     if (menuPtr->activeGC != None) {
  1047.     Tk_FreeGC(menuPtr->display, menuPtr->activeGC);
  1048.     }
  1049.     if (menuPtr->indicatorGC != None) {
  1050.     Tk_FreeGC(menuPtr->display, menuPtr->indicatorGC);
  1051.     }
  1052.     Tk_FreeOptions(configSpecs, (char *) menuPtr, menuPtr->display, 0);
  1053.     ckfree((char *) menuPtr);
  1054. }
  1055.  
  1056. /*
  1057.  *----------------------------------------------------------------------
  1058.  *
  1059.  * DestroyMenuEntry --
  1060.  *
  1061.  *    This procedure is invoked by Tcl_EventuallyFree or Tcl_Release
  1062.  *    to clean up the internal structure of a menu entry at a safe time
  1063.  *    (when no-one is using it anymore).
  1064.  *
  1065.  * Results:
  1066.  *    None.
  1067.  *
  1068.  * Side effects:
  1069.  *    Everything associated with the menu entry is freed up.
  1070.  *
  1071.  *----------------------------------------------------------------------
  1072.  */
  1073.  
  1074. static void
  1075. DestroyMenuEntry(memPtr)
  1076.     char *memPtr;        /* Pointer to entry to be freed. */
  1077. {
  1078.     register MenuEntry *mePtr = (MenuEntry *) memPtr;
  1079.     Menu *menuPtr = mePtr->menuPtr;
  1080.  
  1081.     /*
  1082.      * Free up all the stuff that requires special handling, then
  1083.      * let Tk_FreeOptions handle all the standard option-related
  1084.      * stuff.
  1085.      */
  1086.  
  1087.     if (menuPtr->postedCascade == mePtr) {
  1088.     /*
  1089.      * Ignore errors while unposting the menu, since it's possible
  1090.      * that the menu has already been deleted and the unpost will
  1091.      * generate an error.
  1092.      */
  1093.  
  1094.     PostSubmenu(menuPtr->interp, menuPtr, (MenuEntry *) NULL);
  1095.     }
  1096.     if (mePtr->image != NULL) {
  1097.     Tk_FreeImage(mePtr->image);
  1098.     }
  1099.     if (mePtr->textGC != None) {
  1100.     Tk_FreeGC(menuPtr->display, mePtr->textGC);
  1101.     }
  1102.     if (mePtr->activeGC != None) {
  1103.     Tk_FreeGC(menuPtr->display, mePtr->activeGC);
  1104.     }
  1105.     if (mePtr->disabledGC != None) {
  1106.     Tk_FreeGC(menuPtr->display, mePtr->disabledGC);
  1107.     }
  1108.     if (mePtr->indicatorGC != None) {
  1109.     Tk_FreeGC(menuPtr->display, mePtr->indicatorGC);
  1110.     }
  1111.     if (mePtr->name != NULL) {
  1112.     Tcl_UntraceVar(menuPtr->interp, mePtr->name,
  1113.         TCL_GLOBAL_ONLY|TCL_TRACE_WRITES|TCL_TRACE_UNSETS,
  1114.         MenuVarProc, (ClientData) mePtr);
  1115.     }
  1116.     Tk_FreeOptions(entryConfigSpecs, (char *) mePtr, menuPtr->display, 
  1117.         (COMMAND_MASK << mePtr->type));
  1118.     ckfree((char *) mePtr);
  1119. }
  1120.  
  1121. /*
  1122.  *----------------------------------------------------------------------
  1123.  *
  1124.  * ConfigureMenu --
  1125.  *
  1126.  *    This procedure is called to process an argv/argc list, plus
  1127.  *    the Tk option database, in order to configure (or
  1128.  *    reconfigure) a menu widget.
  1129.  *
  1130.  * Results:
  1131.  *    The return value is a standard Tcl result.  If TCL_ERROR is
  1132.  *    returned, then interp->result contains an error message.
  1133.  *
  1134.  * Side effects:
  1135.  *    Configuration information, such as colors, font, etc. get set
  1136.  *    for menuPtr;  old resources get freed, if there were any.
  1137.  *
  1138.  *----------------------------------------------------------------------
  1139.  */
  1140.  
  1141. static int
  1142. ConfigureMenu(interp, menuPtr, argc, argv, flags)
  1143.     Tcl_Interp *interp;        /* Used for error reporting. */
  1144.     register Menu *menuPtr;    /* Information about widget;  may or may
  1145.                  * not already have values for some fields. */
  1146.     int argc;            /* Number of valid entries in argv. */
  1147.     char **argv;        /* Arguments. */
  1148.     int flags;            /* Flags to pass to Tk_ConfigureWidget. */
  1149. {
  1150.     XGCValues gcValues;
  1151.     GC newGC;
  1152.     unsigned long mask;
  1153.     int i;
  1154.     XSetWindowAttributes atts;
  1155.  
  1156.     if (Tk_ConfigureWidget(interp, menuPtr->tkwin, configSpecs,
  1157.         argc, argv, (char *) menuPtr, flags) != TCL_OK) {
  1158.     return TCL_ERROR;
  1159.     }
  1160.  
  1161.     /*
  1162.      * A few options need special processing, such as setting the
  1163.      * background from a 3-D border, or filling in complicated
  1164.      * defaults that couldn't be specified to Tk_ConfigureWidget.
  1165.      */
  1166.  
  1167.     Tk_SetBackgroundFromBorder(menuPtr->tkwin, menuPtr->border);
  1168.  
  1169.     gcValues.font = menuPtr->fontPtr->fid;
  1170.     gcValues.foreground = menuPtr->fg->pixel;
  1171.     gcValues.background = Tk_3DBorderColor(menuPtr->border)->pixel;
  1172.     newGC = Tk_GetGC(menuPtr->tkwin, GCForeground|GCBackground|GCFont,
  1173.         &gcValues);
  1174.     if (menuPtr->textGC != None) {
  1175.     Tk_FreeGC(menuPtr->display, menuPtr->textGC);
  1176.     }
  1177.     menuPtr->textGC = newGC;
  1178.  
  1179.     if (menuPtr->disabledFg != NULL) {
  1180.     gcValues.foreground = menuPtr->disabledFg->pixel;
  1181.     mask = GCForeground|GCBackground|GCFont;
  1182.     } else {
  1183.     gcValues.foreground = gcValues.background;
  1184.     if (menuPtr->gray == None) {
  1185.         menuPtr->gray = Tk_GetBitmap(interp, menuPtr->tkwin,
  1186.             Tk_GetUid("gray50"));
  1187.         if (menuPtr->gray == None) {
  1188.         return TCL_ERROR;
  1189.         }
  1190.     }
  1191.     gcValues.fill_style = FillStippled;
  1192.     gcValues.stipple = menuPtr->gray;
  1193.     mask = GCForeground|GCFillStyle|GCStipple;
  1194.     }
  1195.     newGC = Tk_GetGC(menuPtr->tkwin, mask, &gcValues);
  1196.     if (menuPtr->disabledGC != None) {
  1197.     Tk_FreeGC(menuPtr->display, menuPtr->disabledGC);
  1198.     }
  1199.     menuPtr->disabledGC = newGC;
  1200.  
  1201.     gcValues.font = menuPtr->fontPtr->fid;
  1202.     gcValues.foreground = menuPtr->activeFg->pixel;
  1203.     gcValues.background = Tk_3DBorderColor(menuPtr->activeBorder)->pixel;
  1204.     newGC = Tk_GetGC(menuPtr->tkwin, GCForeground|GCBackground|GCFont,
  1205.         &gcValues);
  1206.     if (menuPtr->activeGC != None) {
  1207.     Tk_FreeGC(menuPtr->display, menuPtr->activeGC);
  1208.     }
  1209.     menuPtr->activeGC = newGC;
  1210.  
  1211.     gcValues.foreground = menuPtr->indicatorFg->pixel;
  1212.     newGC = Tk_GetGC(menuPtr->tkwin, GCForeground|GCFont, &gcValues);
  1213.     if (menuPtr->indicatorGC != None) {
  1214.     Tk_FreeGC(menuPtr->display, menuPtr->indicatorGC);
  1215.     }
  1216.     menuPtr->indicatorGC = newGC;
  1217.  
  1218.     if (menuPtr->transient) {
  1219.     atts.override_redirect = True;
  1220.     atts.save_under = True;
  1221.     } else {
  1222.     atts.override_redirect = False;
  1223.     atts.save_under = False;
  1224.     }
  1225.     if ((atts.override_redirect
  1226.         != Tk_Attributes(menuPtr->tkwin)->override_redirect)
  1227.         || (atts.save_under
  1228.         != Tk_Attributes(menuPtr->tkwin)->save_under)) {
  1229.     Tk_ChangeWindowAttributes(menuPtr->tkwin,
  1230.         CWOverrideRedirect|CWSaveUnder, &atts);
  1231.     }
  1232.  
  1233.     /*
  1234.      * After reconfiguring a menu, we need to reconfigure all of the
  1235.      * entries in the menu, since some of the things in the children
  1236.      * (such as graphics contexts) may have to change to reflect changes
  1237.      * in the parent.
  1238.      */
  1239.  
  1240.     for (i = 0; i < menuPtr->numEntries; i++) {
  1241.     MenuEntry *mePtr;
  1242.  
  1243.     mePtr = menuPtr->entries[i];
  1244.     ConfigureMenuEntry(interp, menuPtr, mePtr, i, 0, (char **) NULL,
  1245.         TK_CONFIG_ARGV_ONLY | COMMAND_MASK << mePtr->type);
  1246.     }
  1247.  
  1248.     /*
  1249.      * Depending on the -tearOff option, make sure that there is or
  1250.      * isn't an initial tear-off entry at the beginning of the menu.
  1251.      */
  1252.  
  1253.     if (menuPtr->tearOff) {
  1254.     if ((menuPtr->numEntries == 0)
  1255.         || (menuPtr->entries[0]->type != TEAROFF_ENTRY)) {
  1256.         MenuNewEntry(menuPtr, 0, TEAROFF_ENTRY);
  1257.     }
  1258.     } else if ((menuPtr->numEntries > 0)
  1259.         && (menuPtr->entries[0]->type == TEAROFF_ENTRY)) {
  1260.     Tcl_EventuallyFree((ClientData) menuPtr->entries[0],
  1261.               DestroyMenuEntry);
  1262.     for (i = 1; i < menuPtr->numEntries;  i++) {
  1263.         menuPtr->entries[i-1] = menuPtr->entries[i];
  1264.     }
  1265.     menuPtr->numEntries--;
  1266.     }
  1267.  
  1268.     if (!(menuPtr->flags & RESIZE_PENDING)) {
  1269.     menuPtr->flags |= RESIZE_PENDING;
  1270.     Tcl_DoWhenIdle(ComputeMenuGeometry, (ClientData) menuPtr);
  1271.     }
  1272.  
  1273.     return TCL_OK;
  1274. }
  1275.  
  1276. /*
  1277.  *----------------------------------------------------------------------
  1278.  *
  1279.  * ConfigureMenuEntry --
  1280.  *
  1281.  *    This procedure is called to process an argv/argc list, plus
  1282.  *    the Tk option database, in order to configure (or
  1283.  *    reconfigure) one entry in a menu.
  1284.  *
  1285.  * Results:
  1286.  *    The return value is a standard Tcl result.  If TCL_ERROR is
  1287.  *    returned, then interp->result contains an error message.
  1288.  *
  1289.  * Side effects:
  1290.  *    Configuration information such as label and accelerator get
  1291.  *    set for mePtr;  old resources get freed, if there were any.
  1292.  *
  1293.  *----------------------------------------------------------------------
  1294.  */
  1295.  
  1296. static int
  1297. ConfigureMenuEntry(interp, menuPtr, mePtr, index, argc, argv, flags)
  1298.     Tcl_Interp *interp;            /* Used for error reporting. */
  1299.     Menu *menuPtr;            /* Information about whole menu. */
  1300.     register MenuEntry *mePtr;        /* Information about menu entry;  may
  1301.                      * or may not already have values for
  1302.                      * some fields. */
  1303.     int index;                /* Index of mePtr within menuPtr's
  1304.                      * entries. */
  1305.     int argc;                /* Number of valid entries in argv. */
  1306.     char **argv;            /* Arguments. */
  1307.     int flags;                /* Additional flags to pass to
  1308.                      * Tk_ConfigureWidget. */
  1309. {
  1310.     XGCValues gcValues;
  1311.     GC newGC, newActiveGC, newDisabledGC;
  1312.     unsigned long mask;
  1313.     Tk_Image image;
  1314.  
  1315.     /*
  1316.      * If this entry is a cascade and the cascade is posted, then unpost
  1317.      * it before reconfiguring the entry (otherwise the reconfigure might
  1318.      * change the name of the cascaded entry, leaving a posted menu
  1319.      * high and dry).
  1320.      */
  1321.  
  1322.     if (menuPtr->postedCascade == mePtr) {
  1323.     if (PostSubmenu(menuPtr->interp, menuPtr, (MenuEntry *) NULL)
  1324.         != TCL_OK) {
  1325.         Tcl_BackgroundError(menuPtr->interp);
  1326.     }
  1327.     }
  1328.  
  1329.     /*
  1330.      * If this entry is a check button or radio button, then remove
  1331.      * its old trace procedure.
  1332.      */
  1333.  
  1334.     if ((mePtr->name != NULL) &&
  1335.         ((mePtr->type == CHECK_BUTTON_ENTRY)
  1336.         || (mePtr->type == RADIO_BUTTON_ENTRY))) {
  1337.     Tcl_UntraceVar(menuPtr->interp, mePtr->name,
  1338.         TCL_GLOBAL_ONLY|TCL_TRACE_WRITES|TCL_TRACE_UNSETS,
  1339.         MenuVarProc, (ClientData) mePtr);
  1340.     }
  1341.  
  1342.     if (Tk_ConfigureWidget(interp, menuPtr->tkwin, entryConfigSpecs,
  1343.         argc, argv, (char *) mePtr,
  1344.         flags | (COMMAND_MASK << mePtr->type)) != TCL_OK) {
  1345.     return TCL_ERROR;
  1346.     }
  1347.  
  1348.     /*
  1349.      * The code below handles special configuration stuff not taken
  1350.      * care of by Tk_ConfigureWidget, such as special processing for
  1351.      * defaults, sizing strings, graphics contexts, etc.
  1352.      */
  1353.  
  1354.     if (mePtr->label == NULL) {
  1355.     mePtr->labelLength = 0;
  1356.     } else {
  1357.     mePtr->labelLength = strlen(mePtr->label);
  1358.     }
  1359.     if (mePtr->accel == NULL) {
  1360.     mePtr->accelLength = 0;
  1361.     } else {
  1362.     mePtr->accelLength = strlen(mePtr->accel);
  1363.     }
  1364.  
  1365.     if (mePtr->state == tkActiveUid) {
  1366.     if (index != menuPtr->active) {
  1367.         ActivateMenuEntry(menuPtr, index);
  1368.     }
  1369.     } else {
  1370.     if (index == menuPtr->active) {
  1371.         ActivateMenuEntry(menuPtr, -1);
  1372.     }
  1373.     if ((mePtr->state != tkNormalUid) && (mePtr->state != tkDisabledUid)) {
  1374.         Tcl_AppendResult(interp, "bad state value \"", mePtr->state,
  1375.             "\": must be normal, active, or disabled", (char *) NULL);
  1376.         mePtr->state = tkNormalUid;
  1377.         return TCL_ERROR;
  1378.     }
  1379.     }
  1380.  
  1381.     if ((mePtr->fontPtr != NULL) || (mePtr->border != NULL)
  1382.         || (mePtr->fg != NULL) || (mePtr->activeBorder != NULL)
  1383.         || (mePtr->activeFg != NULL)) {
  1384.     gcValues.foreground = (mePtr->fg != NULL) ? mePtr->fg->pixel
  1385.         : menuPtr->fg->pixel;
  1386.     gcValues.background = Tk_3DBorderColor(
  1387.         (mePtr->border != NULL) ? mePtr->border : menuPtr->border)
  1388.         ->pixel;
  1389.     gcValues.font = (mePtr->fontPtr != NULL) ? mePtr->fontPtr->fid
  1390.         : menuPtr->fontPtr->fid;
  1391.  
  1392.     /*
  1393.      * Note: disable GraphicsExpose events;  we know there won't be
  1394.      * obscured areas when copying from an off-screen pixmap to the
  1395.      * screen and this gets rid of unnecessary events.
  1396.      */
  1397.  
  1398.     gcValues.graphics_exposures = False;
  1399.     newGC = Tk_GetGC(menuPtr->tkwin,
  1400.         GCForeground|GCBackground|GCFont|GCGraphicsExposures,
  1401.         &gcValues);
  1402.  
  1403.     if (menuPtr->disabledFg != NULL) {
  1404.         gcValues.foreground = menuPtr->disabledFg->pixel;
  1405.         mask = GCForeground|GCBackground|GCFont|GCGraphicsExposures;
  1406.     } else {
  1407.         gcValues.foreground = gcValues.background;
  1408.         gcValues.fill_style = FillStippled;
  1409.         gcValues.stipple = menuPtr->gray;
  1410.         mask = GCForeground|GCFillStyle|GCStipple;
  1411.     }
  1412.     newDisabledGC = Tk_GetGC(menuPtr->tkwin, mask, &gcValues);
  1413.  
  1414.     gcValues.foreground = (mePtr->activeFg != NULL)
  1415.         ? mePtr->activeFg->pixel : menuPtr->activeFg->pixel;
  1416.     gcValues.background = Tk_3DBorderColor(
  1417.         (mePtr->activeBorder != NULL) ? mePtr->activeBorder
  1418.         : menuPtr->activeBorder)->pixel;
  1419.     newActiveGC = Tk_GetGC(menuPtr->tkwin,
  1420.         GCForeground|GCBackground|GCFont|GCGraphicsExposures,
  1421.         &gcValues);
  1422.     } else {
  1423.     newGC = None;
  1424.     newActiveGC = None;
  1425.     newDisabledGC = None;
  1426.     }
  1427.     if (mePtr->textGC != None) {
  1428.         Tk_FreeGC(menuPtr->display, mePtr->textGC);
  1429.     }
  1430.     mePtr->textGC = newGC;
  1431.     if (mePtr->activeGC != None) {
  1432.         Tk_FreeGC(menuPtr->display, mePtr->activeGC);
  1433.     }
  1434.     mePtr->activeGC = newActiveGC;
  1435.     if (mePtr->disabledGC != None) {
  1436.         Tk_FreeGC(menuPtr->display, mePtr->disabledGC);
  1437.     }
  1438.     mePtr->disabledGC = newDisabledGC;
  1439.     if (mePtr->indicatorFg != NULL) {
  1440.     gcValues.foreground = mePtr->indicatorFg->pixel;
  1441.     newGC = Tk_GetGC(menuPtr->tkwin, GCForeground, &gcValues);
  1442.     } else {
  1443.     newGC = None;
  1444.     }
  1445.     if (mePtr->indicatorGC != None) {
  1446.     Tk_FreeGC(menuPtr->display, mePtr->indicatorGC);
  1447.     }
  1448.     mePtr->indicatorGC = newGC;
  1449.  
  1450.     if ((mePtr->type == CHECK_BUTTON_ENTRY)
  1451.         || (mePtr->type == RADIO_BUTTON_ENTRY)) {
  1452.     char *value;
  1453.  
  1454.     if (mePtr->name == NULL) {
  1455.         mePtr->name = (char *) ckalloc((unsigned) (mePtr->labelLength + 1));
  1456.         strcpy(mePtr->name, (mePtr->label == NULL) ? "" : mePtr->label);
  1457.     }
  1458.     if (mePtr->onValue == NULL) {
  1459.         mePtr->onValue = (char *) ckalloc((unsigned)
  1460.             (mePtr->labelLength + 1));
  1461.         strcpy(mePtr->onValue, (mePtr->label == NULL) ? "" : mePtr->label);
  1462.     }
  1463.  
  1464.     /*
  1465.      * Select the entry if the associated variable has the
  1466.      * appropriate value, initialize the variable if it doesn't
  1467.      * exist, then set a trace on the variable to monitor future
  1468.      * changes to its value.
  1469.      */
  1470.  
  1471.     value = Tcl_GetVar(interp, mePtr->name, TCL_GLOBAL_ONLY);
  1472.     mePtr->flags &= ~ENTRY_SELECTED;
  1473.     if (value != NULL) {
  1474.         if (strcmp(value, mePtr->onValue) == 0) {
  1475.         mePtr->flags |= ENTRY_SELECTED;
  1476.         }
  1477.     } else {
  1478.         Tcl_SetVar(interp, mePtr->name,
  1479.             (mePtr->type == CHECK_BUTTON_ENTRY) ? mePtr->offValue : "",
  1480.             TCL_GLOBAL_ONLY);
  1481.     }
  1482.     Tcl_TraceVar(interp, mePtr->name,
  1483.         TCL_GLOBAL_ONLY|TCL_TRACE_WRITES|TCL_TRACE_UNSETS,
  1484.         MenuVarProc, (ClientData) mePtr);
  1485.     }
  1486.  
  1487.     /*
  1488.      * Get the images for the entry, if there are any.  Allocate the
  1489.      * new images before freeing the old ones, so that the reference
  1490.      * counts don't go to zero and cause image data to be discarded.
  1491.      */
  1492.  
  1493.     if (mePtr->imageString != NULL) {
  1494.     image = Tk_GetImage(interp, menuPtr->tkwin, mePtr->imageString,
  1495.         MenuImageProc, (ClientData) mePtr);
  1496.     if (image == NULL) {
  1497.         return TCL_ERROR;
  1498.     }
  1499.     } else {
  1500.     image = NULL;
  1501.     }
  1502.     if (mePtr->image != NULL) {
  1503.     Tk_FreeImage(mePtr->image);
  1504.     }
  1505.     mePtr->image = image;
  1506.     if (mePtr->selectImageString != NULL) {
  1507.     image = Tk_GetImage(interp, menuPtr->tkwin, mePtr->selectImageString,
  1508.         MenuSelectImageProc, (ClientData) mePtr);
  1509.     if (image == NULL) {
  1510.         return TCL_ERROR;
  1511.     }
  1512.     } else {
  1513.     image = NULL;
  1514.     }
  1515.     if (mePtr->selectImage != NULL) {
  1516.     Tk_FreeImage(mePtr->selectImage);
  1517.     }
  1518.     mePtr->selectImage = image;
  1519.  
  1520.     if (!(menuPtr->flags & RESIZE_PENDING)) {
  1521.     menuPtr->flags |= RESIZE_PENDING;
  1522.     Tcl_DoWhenIdle(ComputeMenuGeometry, (ClientData) menuPtr);
  1523.     }
  1524.     return TCL_OK;
  1525. }
  1526.  
  1527. /*
  1528.  *--------------------------------------------------------------
  1529.  *
  1530.  * ComputeMenuGeometry --
  1531.  *
  1532.  *    This procedure is invoked to recompute the size and
  1533.  *    layout of a menu.  It is called as a when-idle handler so
  1534.  *    that it only gets done once, even if a group of changes is
  1535.  *    made to the menu.
  1536.  *
  1537.  * Results:
  1538.  *    None.
  1539.  *
  1540.  * Side effects:
  1541.  *    Fields of menu entries are changed to reflect their
  1542.  *    current positions, and the size of the menu window
  1543.  *    itself may be changed.
  1544.  *
  1545.  *--------------------------------------------------------------
  1546.  */
  1547.  
  1548. static void
  1549. ComputeMenuGeometry(clientData)
  1550.     ClientData clientData;        /* Structure describing menu. */
  1551. {
  1552.     Menu *menuPtr = (Menu *) clientData;
  1553.     register MenuEntry *mePtr;
  1554.     XFontStruct *fontPtr;
  1555.     int maxLabelWidth, maxIndicatorWidth, maxAccelWidth;
  1556.     int width, height, indicatorSpace;
  1557.     int i, y;
  1558.     int imageWidth, imageHeight;
  1559.  
  1560.     if (menuPtr->tkwin == NULL) {
  1561.     return;
  1562.     }
  1563.  
  1564.     maxLabelWidth = maxIndicatorWidth = maxAccelWidth = 0;
  1565.     y = menuPtr->borderWidth;
  1566.  
  1567.     for (i = 0; i < menuPtr->numEntries; i++) {
  1568.     mePtr = menuPtr->entries[i];
  1569.     indicatorSpace = 0;
  1570.     fontPtr = mePtr->fontPtr;
  1571.     if (fontPtr == NULL) {
  1572.         fontPtr = menuPtr->fontPtr;
  1573.     }
  1574.  
  1575.     /*
  1576.      * For each entry, compute the height required by that
  1577.      * particular entry, plus three widths:  the width of the
  1578.      * label, the width to allow for an indicator to be displayed
  1579.      * to the left of the label (if any), and the width of the
  1580.      * accelerator to be displayed to the right of the label
  1581.      * (if any).  These sizes depend, of course, on the type
  1582.      * of the entry.
  1583.      */
  1584.  
  1585.     if (mePtr->image != NULL) {
  1586.         Tk_SizeOfImage(mePtr->image, &imageWidth, &imageHeight);
  1587.  
  1588.         imageOrBitmap:
  1589.         mePtr->height = imageHeight;
  1590.         width = imageWidth;
  1591.         if (mePtr->indicatorOn) {
  1592.         if (mePtr->type == CHECK_BUTTON_ENTRY) {
  1593.             indicatorSpace = (14*mePtr->height)/10;
  1594.             mePtr->indicatorDiameter = (65*mePtr->height)/100;
  1595.         } else if (mePtr->type == RADIO_BUTTON_ENTRY) {
  1596.             indicatorSpace = (14*mePtr->height)/10;
  1597.             mePtr->indicatorDiameter = (75*mePtr->height)/100;
  1598.         }
  1599.         }
  1600.     } else if (mePtr->bitmap != None) {
  1601.         Tk_SizeOfBitmap(menuPtr->display, mePtr->bitmap,
  1602.             &imageWidth, &imageHeight);
  1603.         goto imageOrBitmap;
  1604.     } else {
  1605.         mePtr->height = fontPtr->ascent + fontPtr->descent;
  1606.         if (mePtr->label != NULL) {
  1607.         (void) TkMeasureChars(fontPtr, mePtr->label,
  1608.             mePtr->labelLength, 0, (int) 100000, 0,
  1609.             TK_NEWLINES_NOT_SPECIAL, &width);
  1610.         } else {
  1611.         width = 0;
  1612.         }
  1613.         if (mePtr->indicatorOn) {
  1614.         if (mePtr->type == CHECK_BUTTON_ENTRY) {
  1615.             indicatorSpace = mePtr->height;
  1616.             mePtr->indicatorDiameter = (80*mePtr->height)/100;
  1617.         } else if (mePtr->type == RADIO_BUTTON_ENTRY) {
  1618.             indicatorSpace = mePtr->height;
  1619.             mePtr->indicatorDiameter = mePtr->height;
  1620.         }
  1621.         }
  1622.     }
  1623.     mePtr->height += 2*menuPtr->activeBorderWidth + 2;
  1624.     if (width > maxLabelWidth) {
  1625.         maxLabelWidth = width;
  1626.     }
  1627.     if (mePtr->type == CASCADE_ENTRY) {
  1628.         width = 2*CASCADE_ARROW_WIDTH;
  1629.     } else if (mePtr->accel != NULL) {
  1630.         (void) TkMeasureChars(fontPtr, mePtr->accel, mePtr->accelLength,
  1631.             0, (int) 100000, 0, TK_NEWLINES_NOT_SPECIAL, &width);
  1632.     } else {
  1633.         width = 0;
  1634.     }
  1635.     if (width > maxAccelWidth) {
  1636.         maxAccelWidth = width;
  1637.     }
  1638.     if (mePtr->type == SEPARATOR_ENTRY) {
  1639.         mePtr->height = 8;
  1640.     }
  1641.     if (mePtr->type == TEAROFF_ENTRY) {
  1642.         mePtr->height = 12;
  1643.     }
  1644.     if (indicatorSpace > maxIndicatorWidth) {
  1645.         maxIndicatorWidth = indicatorSpace;
  1646.     }
  1647.     mePtr->y = y;
  1648.     y += mePtr->height;
  1649.     }
  1650.  
  1651.     /*
  1652.      * Got all the sizes.  Update fields in the menu structure, then
  1653.      * resize the window if necessary.  Leave margins on either side
  1654.      * of the indicator (or just one margin if there is no indicator).
  1655.      * Leave another margin on the right side of the label, plus yet
  1656.      * another margin to the right of the accelerator (if there is one).
  1657.      */
  1658.  
  1659.     menuPtr->indicatorSpace = maxIndicatorWidth + MARGIN_WIDTH;
  1660.     if (maxIndicatorWidth != 0) {
  1661.     menuPtr->indicatorSpace += MARGIN_WIDTH;
  1662.     }
  1663.     menuPtr->labelWidth = maxLabelWidth + MARGIN_WIDTH;
  1664.     width = menuPtr->indicatorSpace + menuPtr->labelWidth + maxAccelWidth
  1665.         + 2*menuPtr->borderWidth + 2*menuPtr->activeBorderWidth;
  1666.     if (maxAccelWidth != 0) {
  1667.     width += MARGIN_WIDTH;
  1668.     }
  1669.     height = y + menuPtr->borderWidth;
  1670.  
  1671.     /*
  1672.      * The X server doesn't like zero dimensions, so round up to at least
  1673.      * 1 (a zero-sized menu should never really occur, anyway).
  1674.      */
  1675.  
  1676.     if (width <= 0) {
  1677.     width = 1;
  1678.     }
  1679.     if (height <= 0) {
  1680.     height = 1;
  1681.     }
  1682.     if ((width != Tk_ReqWidth(menuPtr->tkwin)) ||
  1683.         (height != Tk_ReqHeight(menuPtr->tkwin))) {
  1684.     Tk_GeometryRequest(menuPtr->tkwin, width, height);
  1685.     } else {
  1686.     /*
  1687.      * Must always force a redisplay here if the window is mapped
  1688.      * (even if the size didn't change, something else might have
  1689.      * changed in the menu, such as a label or accelerator).  The
  1690.      * resize will force a redisplay above.
  1691.      */
  1692.  
  1693.     EventuallyRedrawMenu(menuPtr, (MenuEntry *) NULL);
  1694.     }
  1695.  
  1696.     menuPtr->flags &= ~RESIZE_PENDING;
  1697. }
  1698.  
  1699. /*
  1700.  *----------------------------------------------------------------------
  1701.  *
  1702.  * DisplayMenu --
  1703.  *
  1704.  *    This procedure is invoked to display a menu widget.
  1705.  *
  1706.  * Results:
  1707.  *    None.
  1708.  *
  1709.  * Side effects:
  1710.  *    Commands are output to X to display the menu in its
  1711.  *    current mode.
  1712.  *
  1713.  *----------------------------------------------------------------------
  1714.  */
  1715.  
  1716. static void
  1717. DisplayMenu(clientData)
  1718.     ClientData clientData;    /* Information about widget. */
  1719. {
  1720.     register Menu *menuPtr = (Menu *) clientData;
  1721.     register MenuEntry *mePtr;
  1722.     register Tk_Window tkwin = menuPtr->tkwin;
  1723.     Tk_3DBorder bgBorder, activeBorder;
  1724.     XFontStruct *fontPtr;
  1725.     int index, baseline, strictMotif, leftEdge, y,  height;
  1726.     GC gc;
  1727.     XPoint points[3];
  1728.  
  1729.     menuPtr->flags &= ~REDRAW_PENDING;
  1730.     if ((menuPtr->tkwin == NULL) || !Tk_IsMapped(tkwin)) {
  1731.     return;
  1732.     }
  1733.  
  1734.     /*
  1735.      * Loop through all of the entries, drawing them one at a time.
  1736.      */
  1737.  
  1738.     strictMotif = Tk_StrictMotif(menuPtr->tkwin);
  1739.     leftEdge = menuPtr->borderWidth + menuPtr->indicatorSpace
  1740.         + menuPtr->activeBorderWidth;
  1741.     for (index = 0; index < menuPtr->numEntries; index++) {
  1742.     mePtr = menuPtr->entries[index];
  1743.     if (!(mePtr->flags & ENTRY_NEEDS_REDISPLAY)) {
  1744.         continue;
  1745.     }
  1746.     mePtr->flags &= ~ENTRY_NEEDS_REDISPLAY;
  1747.  
  1748.     /*
  1749.      * Background.
  1750.      */
  1751.  
  1752.     bgBorder = mePtr->border;
  1753.     if (bgBorder == NULL) {
  1754.         bgBorder = menuPtr->border;
  1755.     }
  1756.     if (strictMotif) {
  1757.         activeBorder = bgBorder;
  1758.     } else {
  1759.         activeBorder = mePtr->activeBorder;
  1760.         if (activeBorder == NULL) {
  1761.         activeBorder = menuPtr->activeBorder;
  1762.         }
  1763.     }
  1764.     if (mePtr->state == tkActiveUid) {
  1765.         bgBorder = activeBorder;
  1766.         Tk_Fill3DRectangle(menuPtr->tkwin, Tk_WindowId(tkwin),
  1767.             bgBorder, menuPtr->borderWidth, mePtr->y,
  1768.             Tk_Width(tkwin) - 2*menuPtr->borderWidth, mePtr->height,
  1769.             menuPtr->activeBorderWidth, TK_RELIEF_RAISED);
  1770.     } else {
  1771.         Tk_Fill3DRectangle(menuPtr->tkwin, Tk_WindowId(tkwin),
  1772.             bgBorder, menuPtr->borderWidth, mePtr->y,
  1773.             Tk_Width(tkwin) - 2*menuPtr->borderWidth, mePtr->height,
  1774.             0, TK_RELIEF_FLAT);
  1775.     }
  1776.  
  1777.     /*
  1778.      * Choose the gc for drawing the foreground part of the entry.
  1779.      */
  1780.  
  1781.     if ((mePtr->state == tkActiveUid) && !strictMotif) {
  1782.         gc = mePtr->activeGC;
  1783.         if (gc == NULL) {
  1784.         gc = menuPtr->activeGC;
  1785.         }
  1786.     } else {
  1787.         if ((mePtr->state == tkDisabledUid)
  1788.             && (menuPtr->disabledFg != NULL)) {
  1789.         gc = mePtr->disabledGC;
  1790.         if (gc == NULL) {
  1791.             gc = menuPtr->disabledGC;
  1792.         }
  1793.         } else {
  1794.         gc = mePtr->textGC;
  1795.         if (gc == NULL) {
  1796.             gc = menuPtr->textGC;
  1797.         }
  1798.         }
  1799.     }
  1800.  
  1801.     /*
  1802.      * Draw label or bitmap or image for entry.
  1803.      */
  1804.  
  1805.     fontPtr = mePtr->fontPtr;
  1806.     if (fontPtr == NULL) {
  1807.         fontPtr = menuPtr->fontPtr;
  1808.     }
  1809.     baseline = mePtr->y + (mePtr->height + fontPtr->ascent
  1810.         - fontPtr->descent)/2;
  1811.     if (mePtr->image != NULL) {
  1812.         int width, height;
  1813.  
  1814.         Tk_SizeOfImage(mePtr->image, &width, &height);
  1815.         if ((mePtr->selectImage != NULL)
  1816.             && (mePtr->flags & ENTRY_SELECTED)) {
  1817.         Tk_RedrawImage(mePtr->selectImage, 0, 0, width, height,
  1818.             Tk_WindowId(tkwin), leftEdge,
  1819.             (int) (mePtr->y + (mePtr->height - height)/2));
  1820.         } else {
  1821.         Tk_RedrawImage(mePtr->image, 0, 0, width, height,
  1822.             Tk_WindowId(tkwin), leftEdge,
  1823.             (int) (mePtr->y + (mePtr->height - height)/2));
  1824.         }
  1825.     } else if (mePtr->bitmap != None) {
  1826.         int width, height;
  1827.  
  1828.         Tk_SizeOfBitmap(menuPtr->display, mePtr->bitmap, &width, &height);
  1829.         XCopyPlane(menuPtr->display, mePtr->bitmap, Tk_WindowId(tkwin),
  1830.             gc, 0, 0, (unsigned) width, (unsigned) height, leftEdge,
  1831.             (int) (mePtr->y + (mePtr->height - height)/2), 1);
  1832.     } else {
  1833.         baseline = mePtr->y + (mePtr->height + fontPtr->ascent
  1834.             - fontPtr->descent)/2;
  1835.         if (mePtr->label != NULL) {
  1836.         TkDisplayChars(menuPtr->display, Tk_WindowId(tkwin), gc,
  1837.             fontPtr, mePtr->label, mePtr->labelLength,
  1838.             leftEdge, baseline, leftEdge,
  1839.             TK_NEWLINES_NOT_SPECIAL);
  1840.         if (mePtr->underline >= 0) {
  1841.             TkUnderlineChars(menuPtr->display, Tk_WindowId(tkwin), gc,
  1842.                 fontPtr, mePtr->label, leftEdge, baseline,
  1843.                 leftEdge, TK_NEWLINES_NOT_SPECIAL,
  1844.                 mePtr->underline, mePtr->underline);
  1845.         }
  1846.         }
  1847.     }
  1848.  
  1849.     /*
  1850.      * Draw accelerator or cascade arrow.
  1851.      */
  1852.  
  1853.     if (mePtr->type == CASCADE_ENTRY) {
  1854.         points[0].x = Tk_Width(tkwin) - menuPtr->borderWidth
  1855.             - menuPtr->activeBorderWidth - MARGIN_WIDTH
  1856.             - CASCADE_ARROW_WIDTH;
  1857.         points[0].y = mePtr->y + (mePtr->height - CASCADE_ARROW_HEIGHT)/2;
  1858.         points[1].x = points[0].x;
  1859.         points[1].y = points[0].y + CASCADE_ARROW_HEIGHT;
  1860.         points[2].x = points[0].x + CASCADE_ARROW_WIDTH;
  1861.         points[2].y = points[0].y + CASCADE_ARROW_HEIGHT/2;
  1862.         Tk_Fill3DPolygon(menuPtr->tkwin, Tk_WindowId(tkwin), activeBorder,
  1863.             points, 3, DECORATION_BORDER_WIDTH,
  1864.             (menuPtr->postedCascade == mePtr) ? TK_RELIEF_SUNKEN
  1865.             : TK_RELIEF_RAISED);
  1866.     } else if (mePtr->accel != NULL) {
  1867.         TkDisplayChars(menuPtr->display, Tk_WindowId(tkwin), gc,
  1868.             fontPtr, mePtr->accel, mePtr->accelLength,
  1869.             leftEdge + menuPtr->labelWidth, baseline,
  1870.             leftEdge + menuPtr->labelWidth, TK_NEWLINES_NOT_SPECIAL);
  1871.     }
  1872.  
  1873.     /*
  1874.      * Draw check-button indicator.
  1875.      */
  1876.  
  1877.     gc = mePtr->indicatorGC;
  1878.     if (gc == None) {
  1879.         gc = menuPtr->indicatorGC;
  1880.     }
  1881.     if ((mePtr->type == CHECK_BUTTON_ENTRY) && mePtr->indicatorOn) {
  1882.         int dim, x, y;
  1883.  
  1884.         dim = mePtr->indicatorDiameter;
  1885.         x = menuPtr->borderWidth + menuPtr->activeBorderWidth
  1886.             + (menuPtr->indicatorSpace - dim)/2;
  1887.         y = mePtr->y + (mePtr->height - dim)/2;
  1888.         Tk_Fill3DRectangle(menuPtr->tkwin, Tk_WindowId(tkwin),
  1889.             menuPtr->border, x, y, dim, dim,
  1890.             DECORATION_BORDER_WIDTH, TK_RELIEF_SUNKEN);
  1891.         x += DECORATION_BORDER_WIDTH;
  1892.         y += DECORATION_BORDER_WIDTH;
  1893.         dim -= 2*DECORATION_BORDER_WIDTH;
  1894.         if ((dim > 0) && (mePtr->flags & ENTRY_SELECTED)) {
  1895.         XFillRectangle(menuPtr->display, Tk_WindowId(tkwin), gc,
  1896.             x, y, (unsigned int) dim, (unsigned int) dim);
  1897.         }
  1898.     }
  1899.  
  1900.     /*
  1901.      * Draw radio-button indicator.
  1902.      */
  1903.  
  1904.     if ((mePtr->type == RADIO_BUTTON_ENTRY) && mePtr->indicatorOn) {
  1905.         XPoint points[4];
  1906.         int radius;
  1907.  
  1908.         radius = mePtr->indicatorDiameter/2;
  1909.         points[0].x = menuPtr->borderWidth + menuPtr->activeBorderWidth
  1910.             + (menuPtr->indicatorSpace - mePtr->indicatorDiameter)/2;
  1911.         points[0].y = mePtr->y + (mePtr->height)/2;
  1912.         points[1].x = points[0].x + radius;
  1913.         points[1].y = points[0].y + radius;
  1914.         points[2].x = points[1].x + radius;
  1915.         points[2].y = points[0].y;
  1916.         points[3].x = points[1].x;
  1917.         points[3].y = points[0].y - radius;
  1918.         if (mePtr->flags & ENTRY_SELECTED) {
  1919.         XFillPolygon(menuPtr->display, Tk_WindowId(tkwin), gc,
  1920.             points, 4, Convex, CoordModeOrigin);
  1921.         } else {
  1922.         Tk_Fill3DPolygon(menuPtr->tkwin, Tk_WindowId(tkwin),
  1923.             menuPtr->border, points, 4, DECORATION_BORDER_WIDTH,
  1924.             TK_RELIEF_FLAT);
  1925.         }
  1926.         Tk_Draw3DPolygon(menuPtr->tkwin, Tk_WindowId(tkwin),
  1927.             menuPtr->border, points, 4, DECORATION_BORDER_WIDTH,
  1928.             TK_RELIEF_SUNKEN);
  1929.     }
  1930.  
  1931.     /*
  1932.      * Draw separator.
  1933.      */
  1934.  
  1935.     if (mePtr->type == SEPARATOR_ENTRY) {
  1936.         XPoint points[2];
  1937.         int margin;
  1938.  
  1939.         margin = (fontPtr->ascent + fontPtr->descent)/2;
  1940.         points[0].x = 0;
  1941.         points[0].y = mePtr->y + mePtr->height/2;
  1942.         points[1].x = Tk_Width(tkwin) - 1;
  1943.         points[1].y = points[0].y;
  1944.         Tk_Draw3DPolygon(menuPtr->tkwin, Tk_WindowId(tkwin),
  1945.             menuPtr->border, points, 2, 1, TK_RELIEF_RAISED);
  1946.     }
  1947.  
  1948.     /*
  1949.      * Draw tear-off line.
  1950.      */
  1951.  
  1952.     if (mePtr->type == TEAROFF_ENTRY) {
  1953.         XPoint points[2];
  1954.         int margin, width, maxX;
  1955.  
  1956.         margin = (fontPtr->ascent + fontPtr->descent)/2;
  1957.         points[0].x = 0;
  1958.         points[0].y = mePtr->y + mePtr->height/2;
  1959.         points[1].y = points[0].y;
  1960.         width = 6;
  1961.         maxX  = Tk_Width(tkwin) - 1;
  1962.  
  1963.         while (points[0].x < maxX) {
  1964.         points[1].x = points[0].x + width;
  1965.         if (points[1].x > maxX) {
  1966.             points[1].x = maxX;
  1967.         }
  1968.         Tk_Draw3DPolygon(menuPtr->tkwin, Tk_WindowId(tkwin),
  1969.             menuPtr->border, points, 2, 1, TK_RELIEF_RAISED);
  1970.         points[0].x += 2*width;
  1971.         }
  1972.     }
  1973.  
  1974.     /*
  1975.      * If the entry is disabled with a stipple rather than a special
  1976.      * foreground color, generate the stippled effect.
  1977.      */
  1978.  
  1979.     if ((mePtr->state == tkDisabledUid) && (menuPtr->disabledFg == NULL)) {
  1980.         XFillRectangle(menuPtr->display, Tk_WindowId(tkwin),
  1981.             menuPtr->disabledGC, menuPtr->borderWidth,
  1982.             mePtr->y,
  1983.             (unsigned) (Tk_Width(tkwin) - 2*menuPtr->borderWidth),
  1984.             (unsigned) mePtr->height);
  1985.     }
  1986.     }
  1987.  
  1988.     /*
  1989.      * If there is extra space after the last entry in the menu,
  1990.      * clear it.
  1991.      */
  1992.  
  1993.     if (menuPtr->numEntries >= 1) {
  1994.     mePtr = menuPtr->entries[menuPtr->numEntries-1];
  1995.     y = mePtr->y + mePtr->height;
  1996.     } else {
  1997.     y = menuPtr->borderWidth;
  1998.     }
  1999.     height = Tk_Height(tkwin) - menuPtr->borderWidth - y;
  2000.     if (height > 0) {
  2001.     Tk_Fill3DRectangle(tkwin, Tk_WindowId(tkwin),
  2002.         menuPtr->border, menuPtr->borderWidth, y, 
  2003.         Tk_Width(tkwin) - 2*menuPtr->borderWidth,
  2004.         height, 0, TK_RELIEF_FLAT);
  2005.     }
  2006.  
  2007.     Tk_Draw3DRectangle(menuPtr->tkwin, Tk_WindowId(tkwin),
  2008.         menuPtr->border, 0, 0, Tk_Width(tkwin), Tk_Height(tkwin),
  2009.         menuPtr->borderWidth, menuPtr->relief);
  2010. }
  2011.  
  2012. /*
  2013.  *--------------------------------------------------------------
  2014.  *
  2015.  * GetMenuIndex --
  2016.  *
  2017.  *    Parse a textual index into a menu and return the numerical
  2018.  *    index of the indicated entry.
  2019.  *
  2020.  * Results:
  2021.  *    A standard Tcl result.  If all went well, then *indexPtr is
  2022.  *    filled in with the entry index corresponding to string
  2023.  *    (ranges from -1 to the number of entries in the menu minus
  2024.  *    one).  Otherwise an error message is left in interp->result.
  2025.  *
  2026.  * Side effects:
  2027.  *    None.
  2028.  *
  2029.  *--------------------------------------------------------------
  2030.  */
  2031.  
  2032. static int
  2033. GetMenuIndex(interp, menuPtr, string, lastOK, indexPtr)
  2034.     Tcl_Interp *interp;        /* For error messages. */
  2035.     Menu *menuPtr;        /* Menu for which the index is being
  2036.                  * specified. */
  2037.     char *string;        /* Specification of an entry in menu.  See
  2038.                  * manual entry for valid .*/
  2039.     int lastOK;            /* Non-zero means its OK to return index
  2040.                  * just *after* last entry. */
  2041.     int *indexPtr;        /* Where to store converted relief. */
  2042. {
  2043.     int i, y;
  2044.  
  2045.     if ((string[0] == 'a') && (strcmp(string, "active") == 0)) {
  2046.     *indexPtr = menuPtr->active;
  2047.     return TCL_OK;
  2048.     }
  2049.  
  2050.     if (((string[0] == 'l') && (strcmp(string, "last") == 0))
  2051.         || ((string[0] == 'e') && (strcmp(string, "end") == 0))) {
  2052.     *indexPtr = menuPtr->numEntries - ((lastOK) ? 0 : 1);
  2053.     return TCL_OK;
  2054.     }
  2055.  
  2056.     if ((string[0] == 'n') && (strcmp(string, "none") == 0)) {
  2057.     *indexPtr = -1;
  2058.     return TCL_OK;
  2059.     }
  2060.  
  2061.     if (string[0] == '@') {
  2062.     if (Tcl_GetInt(interp, string+1,  &y) == TCL_OK) {
  2063.         for (i = 0; i < menuPtr->numEntries; i++) {
  2064.         MenuEntry *mePtr = menuPtr->entries[i];
  2065.  
  2066.         if (y < (mePtr->y + mePtr->height)) {
  2067.             break;
  2068.         }
  2069.         }
  2070.         if (i >= menuPtr->numEntries) {
  2071.         i = menuPtr->numEntries-1;
  2072.         }
  2073.         *indexPtr = i;
  2074.         return TCL_OK;
  2075.     } else {
  2076.         Tcl_SetResult(interp, (char *) NULL, TCL_STATIC);
  2077.     }
  2078.     }
  2079.  
  2080.     if (isdigit(UCHAR(string[0]))) {
  2081.     if (Tcl_GetInt(interp, string,  &i) == TCL_OK) {
  2082.         if (i >= menuPtr->numEntries) {
  2083.         if (lastOK) {
  2084.             i = menuPtr->numEntries;
  2085.         } else {
  2086.             i = menuPtr->numEntries-1;
  2087.         }
  2088.         } else if (i < 0) {
  2089.         i = -1;
  2090.         }
  2091.         *indexPtr = i;
  2092.         return TCL_OK;
  2093.     }
  2094.     Tcl_SetResult(interp, (char *) NULL, TCL_STATIC);
  2095.     }
  2096.  
  2097.     for (i = 0; i < menuPtr->numEntries; i++) {
  2098.     char *label;
  2099.  
  2100.     label = menuPtr->entries[i]->label;
  2101.     if ((label != NULL)
  2102.         && (Tcl_StringMatch(menuPtr->entries[i]->label, string))) {
  2103.         *indexPtr = i;
  2104.         return TCL_OK;
  2105.     }
  2106.     }
  2107.  
  2108.     Tcl_AppendResult(interp, "bad menu entry index \"",
  2109.         string, "\"", (char *) NULL);
  2110.     return TCL_ERROR;
  2111. }
  2112.  
  2113. /*
  2114.  *--------------------------------------------------------------
  2115.  *
  2116.  * MenuEventProc --
  2117.  *
  2118.  *    This procedure is invoked by the Tk dispatcher for various
  2119.  *    events on menus.
  2120.  *
  2121.  * Results:
  2122.  *    None.
  2123.  *
  2124.  * Side effects:
  2125.  *    When the window gets deleted, internal structures get
  2126.  *    cleaned up.  When it gets exposed, it is redisplayed.
  2127.  *
  2128.  *--------------------------------------------------------------
  2129.  */
  2130.  
  2131. static void
  2132. MenuEventProc(clientData, eventPtr)
  2133.     ClientData clientData;    /* Information about window. */
  2134.     XEvent *eventPtr;        /* Information about event. */
  2135. {
  2136.     Menu *menuPtr = (Menu *) clientData;
  2137.     if ((eventPtr->type == Expose) && (eventPtr->xexpose.count == 0)) {
  2138.     EventuallyRedrawMenu(menuPtr, (MenuEntry *) NULL);
  2139.     } else if (eventPtr->type == ConfigureNotify) {
  2140.     EventuallyRedrawMenu(menuPtr, (MenuEntry *) NULL);
  2141.     } else if (eventPtr->type == DestroyNotify) {
  2142.     if (menuPtr->tkwin != NULL) {
  2143.         menuPtr->tkwin = NULL;
  2144.         Tcl_DeleteCommand(menuPtr->interp,
  2145.             Tcl_GetCommandName(menuPtr->interp, menuPtr->widgetCmd));
  2146.     }
  2147.     if (menuPtr->flags & REDRAW_PENDING) {
  2148.         Tcl_CancelIdleCall(DisplayMenu, (ClientData) menuPtr);
  2149.     }
  2150.     if (menuPtr->flags & RESIZE_PENDING) {
  2151.         Tcl_CancelIdleCall(ComputeMenuGeometry, (ClientData) menuPtr);
  2152.     }
  2153.     Tcl_EventuallyFree((ClientData) menuPtr, DestroyMenu);
  2154.     }
  2155. }
  2156.  
  2157. /*
  2158.  *----------------------------------------------------------------------
  2159.  *
  2160.  * MenuCmdDeletedProc --
  2161.  *
  2162.  *    This procedure is invoked when a widget command is deleted.  If
  2163.  *    the widget isn't already in the process of being destroyed,
  2164.  *    this command destroys it.
  2165.  *
  2166.  * Results:
  2167.  *    None.
  2168.  *
  2169.  * Side effects:
  2170.  *    The widget is destroyed.
  2171.  *
  2172.  *----------------------------------------------------------------------
  2173.  */
  2174.  
  2175. static void
  2176. MenuCmdDeletedProc(clientData)
  2177.     ClientData clientData;    /* Pointer to widget record for widget. */
  2178. {
  2179.     Menu *menuPtr = (Menu *) clientData;
  2180.     Tk_Window tkwin = menuPtr->tkwin;
  2181.  
  2182.     /*
  2183.      * This procedure could be invoked either because the window was
  2184.      * destroyed and the command was then deleted (in which case tkwin
  2185.      * is NULL) or because the command was deleted, and then this procedure
  2186.      * destroys the widget.
  2187.      */
  2188.  
  2189.     if (tkwin != NULL) {
  2190.     menuPtr->tkwin = NULL;
  2191.     Tk_DestroyWindow(tkwin);
  2192.     }
  2193. }
  2194.  
  2195. /*
  2196.  *----------------------------------------------------------------------
  2197.  *
  2198.  * MenuNewEntry --
  2199.  *
  2200.  *    This procedure allocates and initializes a new menu entry.
  2201.  *
  2202.  * Results:
  2203.  *    The return value is a pointer to a new menu entry structure,
  2204.  *    which has been malloc-ed, initialized, and entered into the
  2205.  *    entry array for the  menu.
  2206.  *
  2207.  * Side effects:
  2208.  *    Storage gets allocated.
  2209.  *
  2210.  *----------------------------------------------------------------------
  2211.  */
  2212.  
  2213. static MenuEntry *
  2214. MenuNewEntry(menuPtr, index, type)
  2215.     Menu *menuPtr;        /* Menu that will hold the new entry. */
  2216.     int index;            /* Where in the menu the new entry is to
  2217.                  * go. */
  2218.     int type;            /* The type of the new entry. */
  2219. {
  2220.     MenuEntry *mePtr;
  2221.     MenuEntry **newEntries;
  2222.     int i;
  2223.  
  2224.     /*
  2225.      * Create a new array of entries with an empty slot for the
  2226.      * new entry.
  2227.      */
  2228.  
  2229.     newEntries = (MenuEntry **) ckalloc((unsigned)
  2230.         ((menuPtr->numEntries+1)*sizeof(MenuEntry *)));
  2231.     for (i = 0; i < index; i++) {
  2232.     newEntries[i] = menuPtr->entries[i];
  2233.     }
  2234.     for (  ; i < menuPtr->numEntries; i++) {
  2235.     newEntries[i+1] = menuPtr->entries[i];
  2236.     }
  2237.     if (menuPtr->numEntries != 0) {
  2238.     ckfree((char *) menuPtr->entries);
  2239.     }
  2240.     menuPtr->entries = newEntries;
  2241.     menuPtr->numEntries++;
  2242.     menuPtr->entries[index] = mePtr = (MenuEntry *) ckalloc(sizeof(MenuEntry));
  2243.     mePtr->type = type;
  2244.     mePtr->menuPtr = menuPtr;
  2245.     mePtr->label = NULL;
  2246.     mePtr->labelLength = 0;
  2247.     mePtr->underline = -1;
  2248.     mePtr->bitmap = None;
  2249.     mePtr->imageString = NULL;
  2250.     mePtr->image = NULL;
  2251.     mePtr->selectImageString  = NULL;
  2252.     mePtr->selectImage = NULL;
  2253.     mePtr->accel = NULL;
  2254.     mePtr->accelLength = 0;
  2255.     mePtr->state = tkNormalUid;
  2256.     mePtr->height = 0;
  2257.     mePtr->y = 0;
  2258.     mePtr->indicatorDiameter = 0;
  2259.     mePtr->border = NULL;
  2260.     mePtr->fg = NULL;
  2261.     mePtr->activeBorder = NULL;
  2262.     mePtr->activeFg = NULL;
  2263.     mePtr->fontPtr = NULL;
  2264.     mePtr->textGC = None;
  2265.     mePtr->activeGC = None;
  2266.     mePtr->disabledGC = None;
  2267.     mePtr->indicatorOn = 1;
  2268.     mePtr->indicatorFg = NULL;
  2269.     mePtr->indicatorGC = None;
  2270.     mePtr->command = NULL;
  2271.     mePtr->name = NULL;
  2272.     mePtr->onValue = NULL;
  2273.     mePtr->offValue = NULL;
  2274.     mePtr->flags = 0;
  2275.     return mePtr;
  2276. }
  2277.  
  2278. /*
  2279.  *----------------------------------------------------------------------
  2280.  *
  2281.  * MenuAddOrInsert --
  2282.  *
  2283.  *    This procedure does all of the work of the "add" and "insert"
  2284.  *    widget commands, allowing the code for these to be shared.
  2285.  *
  2286.  * Results:
  2287.  *    A standard Tcl return value.
  2288.  *
  2289.  * Side effects:
  2290.  *    A new menu entry is created in menuPtr.
  2291.  *
  2292.  *----------------------------------------------------------------------
  2293.  */
  2294.  
  2295. static int
  2296. MenuAddOrInsert(interp, menuPtr, indexString, argc, argv)
  2297.     Tcl_Interp *interp;            /* Used for error reporting. */
  2298.     Menu *menuPtr;            /* Widget in which to create new
  2299.                      * entry. */
  2300.     char *indexString;            /* String describing index at which
  2301.                      * to insert.  NULL means insert at
  2302.                      * end. */
  2303.     int argc;                /* Number of elements in argv. */
  2304.     char **argv;            /* Arguments to command:  first arg
  2305.                      * is type of entry, others are
  2306.                      * config options. */
  2307. {
  2308.     int c, type, i, index;
  2309.     size_t length;
  2310.     MenuEntry *mePtr;
  2311.  
  2312.     if (indexString != NULL) {
  2313.     if (GetMenuIndex(interp, menuPtr, indexString, 1, &index) != TCL_OK) {
  2314.         return TCL_ERROR;
  2315.     }
  2316.     } else {
  2317.     index = menuPtr->numEntries;
  2318.     }
  2319.     if (index < 0) {
  2320.     Tcl_AppendResult(interp, "bad index \"", indexString, "\"",
  2321.          (char *) NULL);
  2322.     return TCL_ERROR;
  2323.     }
  2324.     if (menuPtr->tearOff && (index == 0)) {
  2325.     index = 1;
  2326.     }
  2327.  
  2328.     /*
  2329.      * Figure out the type of the new entry.
  2330.      */
  2331.  
  2332.     c = argv[0][0];
  2333.     length = strlen(argv[0]);
  2334.     if ((c == 'c') && (strncmp(argv[0], "cascade", length) == 0)
  2335.         && (length >= 2)) {
  2336.     type = CASCADE_ENTRY;
  2337.     } else if ((c == 'c') && (strncmp(argv[0], "checkbutton", length) == 0)
  2338.         && (length >= 2)) {
  2339.     type = CHECK_BUTTON_ENTRY;
  2340.     } else if ((c == 'c') && (strncmp(argv[0], "command", length) == 0)
  2341.         && (length >= 2)) {
  2342.     type = COMMAND_ENTRY;
  2343.     } else if ((c == 'r')
  2344.         && (strncmp(argv[0], "radiobutton", length) == 0)) {
  2345.     type = RADIO_BUTTON_ENTRY;
  2346.     } else if ((c == 's')
  2347.         && (strncmp(argv[0], "separator", length) == 0)) {
  2348.     type = SEPARATOR_ENTRY;
  2349.     } else {
  2350.     Tcl_AppendResult(interp, "bad menu entry type \"",
  2351.         argv[0], "\": must be cascade, checkbutton, ",
  2352.         "command, radiobutton, or separator", (char *) NULL);
  2353.     return TCL_ERROR;
  2354.     }
  2355.     mePtr = MenuNewEntry(menuPtr, index, type);
  2356.     if (ConfigureMenuEntry(interp, menuPtr, mePtr, index,
  2357.         argc-1, argv+1, 0) != TCL_OK) {
  2358.     DestroyMenuEntry((ClientData) mePtr);
  2359.     for (i = index+1; i < menuPtr->numEntries; i++) {
  2360.         menuPtr->entries[i-1] = menuPtr->entries[i];
  2361.     }
  2362.     menuPtr->numEntries--;
  2363.     return TCL_ERROR;
  2364.     }
  2365.     return TCL_OK;
  2366. }
  2367.  
  2368. /*
  2369.  *--------------------------------------------------------------
  2370.  *
  2371.  * MenuVarProc --
  2372.  *
  2373.  *    This procedure is invoked when someone changes the
  2374.  *    state variable associated with a radiobutton or checkbutton
  2375.  *    menu entry.  The entry's selected state is set to match
  2376.  *    the value of the variable.
  2377.  *
  2378.  * Results:
  2379.  *    NULL is always returned.
  2380.  *
  2381.  * Side effects:
  2382.  *    The menu entry may become selected or deselected.
  2383.  *
  2384.  *--------------------------------------------------------------
  2385.  */
  2386.  
  2387.     /* ARGSUSED */
  2388. static char *
  2389. MenuVarProc(clientData, interp, name1, name2, flags)
  2390.     ClientData clientData;    /* Information about menu entry. */
  2391.     Tcl_Interp *interp;        /* Interpreter containing variable. */
  2392.     char *name1;        /* First part of variable's name. */
  2393.     char *name2;        /* Second part of variable's name. */
  2394.     int flags;            /* Describes what just happened. */
  2395. {
  2396.     MenuEntry *mePtr = (MenuEntry *) clientData;
  2397.     Menu *menuPtr;
  2398.     char *value;
  2399.  
  2400.     menuPtr = mePtr->menuPtr;
  2401.  
  2402.     /*
  2403.      * If the variable is being unset, then re-establish the
  2404.      * trace unless the whole interpreter is going away.
  2405.      */
  2406.  
  2407.     if (flags & TCL_TRACE_UNSETS) {
  2408.     mePtr->flags &= ~ENTRY_SELECTED;
  2409.     if ((flags & TCL_TRACE_DESTROYED) && !(flags & TCL_INTERP_DESTROYED)) {
  2410.         Tcl_TraceVar(interp, mePtr->name,
  2411.             TCL_GLOBAL_ONLY|TCL_TRACE_WRITES|TCL_TRACE_UNSETS,
  2412.             MenuVarProc, clientData);
  2413.     }
  2414.     EventuallyRedrawMenu(menuPtr, (MenuEntry *) NULL);
  2415.     return (char *) NULL;
  2416.     }
  2417.  
  2418.     /*
  2419.      * Use the value of the variable to update the selected status of
  2420.      * the menu entry.
  2421.      */
  2422.  
  2423.     value = Tcl_GetVar(interp, mePtr->name, TCL_GLOBAL_ONLY);
  2424.     if (value == NULL) {
  2425.     value = "";
  2426.     }
  2427.     if (strcmp(value, mePtr->onValue) == 0) {
  2428.     if (mePtr->flags & ENTRY_SELECTED) {
  2429.         return (char *) NULL;
  2430.     }
  2431.     mePtr->flags |= ENTRY_SELECTED;
  2432.     } else if (mePtr->flags & ENTRY_SELECTED) {
  2433.     mePtr->flags &= ~ENTRY_SELECTED;
  2434.     } else {
  2435.     return (char *) NULL;
  2436.     }
  2437.     EventuallyRedrawMenu(menuPtr, (MenuEntry *) NULL);
  2438.     return (char *) NULL;
  2439. }
  2440.  
  2441. /*
  2442.  *----------------------------------------------------------------------
  2443.  *
  2444.  * EventuallyRedrawMenu --
  2445.  *
  2446.  *    Arrange for an entry of a menu, or the whole menu, to be
  2447.  *    redisplayed at some point in the future.
  2448.  *
  2449.  * Results:
  2450.  *    None.
  2451.  *
  2452.  * Side effects:
  2453.  *    A when-idle hander is scheduled to do the redisplay, if there
  2454.  *    isn't one already scheduled.
  2455.  *
  2456.  *----------------------------------------------------------------------
  2457.  */
  2458.  
  2459. static void
  2460. EventuallyRedrawMenu(menuPtr, mePtr)
  2461.     register Menu *menuPtr;    /* Information about menu to redraw. */
  2462.     register MenuEntry *mePtr;    /* Entry to redraw.  NULL means redraw
  2463.                  * all the entries in the menu. */
  2464. {
  2465.     int i;
  2466.     if (menuPtr->tkwin == NULL) {
  2467.     return;
  2468.     }
  2469.     if (mePtr != NULL) {
  2470.     mePtr->flags |= ENTRY_NEEDS_REDISPLAY;
  2471.     } else {
  2472.     for (i = 0; i < menuPtr->numEntries; i++) {
  2473.         menuPtr->entries[i]->flags |= ENTRY_NEEDS_REDISPLAY;
  2474.     }
  2475.     }
  2476.     if ((menuPtr->tkwin == NULL) || !Tk_IsMapped(menuPtr->tkwin)
  2477.         || (menuPtr->flags & REDRAW_PENDING)) {
  2478.     return;
  2479.     }
  2480.     Tcl_DoWhenIdle(DisplayMenu, (ClientData) menuPtr);
  2481.     menuPtr->flags |= REDRAW_PENDING;
  2482. }
  2483.  
  2484. /*
  2485.  *--------------------------------------------------------------
  2486.  *
  2487.  * PostSubmenu --
  2488.  *
  2489.  *    This procedure arranges for a particular submenu (i.e. the
  2490.  *    menu corresponding to a given cascade entry) to be
  2491.  *    posted.
  2492.  *
  2493.  * Results:
  2494.  *    A standard Tcl return result.  Errors may occur in the
  2495.  *    Tcl commands generated to post and unpost submenus.
  2496.  *
  2497.  * Side effects:
  2498.  *    If there is already a submenu posted, it is unposted.
  2499.  *    The new submenu is then posted.
  2500.  *
  2501.  *--------------------------------------------------------------
  2502.  */
  2503.  
  2504. static int
  2505. PostSubmenu(interp, menuPtr, mePtr)
  2506.     Tcl_Interp *interp;        /* Used for invoking sub-commands and
  2507.                  * reporting errors. */
  2508.     register Menu *menuPtr;    /* Information about menu as a whole. */
  2509.     register MenuEntry *mePtr;    /* Info about submenu that is to be
  2510.                  * posted.  NULL means make sure that
  2511.                  * no submenu is posted. */
  2512. {
  2513.     char string[30];
  2514.     int result, x, y;
  2515.     Tk_Window tkwin;
  2516.  
  2517.     if (mePtr == menuPtr->postedCascade) {
  2518.     return TCL_OK;
  2519.     }
  2520.  
  2521.     if (menuPtr->postedCascade != NULL) {
  2522.     /*
  2523.      * Note: when unposting a submenu, we have to redraw the entire
  2524.      * parent menu.  This is because of a combination of the following
  2525.      * things:
  2526.      * (a) the submenu partially overlaps the parent.
  2527.      * (b) the submenu specifies "save under", which causes the X
  2528.      *     server to make a copy of the information under it when it
  2529.      *     is posted.  When the submenu is unposted, the X server
  2530.      *     copies this data back and doesn't generate any Expose
  2531.      *     events for the parent.
  2532.      * (c) the parent may have redisplayed itself after the submenu
  2533.      *     was posted, in which case the saved information is no
  2534.      *     longer correct.
  2535.      * The simplest solution is just force a complete redisplay of
  2536.      * the parent.
  2537.      */
  2538.  
  2539.     EventuallyRedrawMenu(menuPtr, (MenuEntry *) NULL);
  2540.     result = Tcl_VarEval(interp, menuPtr->postedCascade->name,
  2541.         " unpost", (char *) NULL);
  2542.     menuPtr->postedCascade = NULL;
  2543.     if (result != TCL_OK) {
  2544.         return result;
  2545.     }
  2546.     }
  2547.  
  2548.     if ((mePtr != NULL) && (mePtr->name != NULL)
  2549.         && Tk_IsMapped(menuPtr->tkwin)) {
  2550.     /*
  2551.      * Make sure that the cascaded submenu is a child of the
  2552.      * parent menu.
  2553.      */
  2554.  
  2555.     tkwin = Tk_NameToWindow(interp, mePtr->name, menuPtr->tkwin);
  2556.     if (tkwin == NULL) {
  2557.         return TCL_ERROR;
  2558.     }
  2559.     if (Tk_Parent(tkwin) != menuPtr->tkwin) {
  2560.         Tcl_AppendResult(interp, "cascaded sub-menu ",
  2561.             Tk_PathName(tkwin), " must be a child of ",
  2562.             Tk_PathName(menuPtr->tkwin), (char *) NULL);
  2563.         return TCL_ERROR;
  2564.     }
  2565.  
  2566.     /*
  2567.      * Position the cascade with its upper left corner slightly
  2568.      * below and to the left of the upper right corner of the
  2569.      * menu entry (this is an attempt to match Motif behavior).
  2570.      */
  2571.     Tk_GetRootCoords(menuPtr->tkwin, &x, &y);
  2572.     x += Tk_Width(menuPtr->tkwin) - menuPtr->borderWidth
  2573.         - menuPtr->activeBorderWidth - 2;
  2574.     y += mePtr->y + menuPtr->activeBorderWidth + 2;
  2575.     sprintf(string, "%d %d", x, y);
  2576.     result = Tcl_VarEval(interp, mePtr->name, " post ", string,
  2577.         (char *) NULL);
  2578.     if (result != TCL_OK) {
  2579.         return result;
  2580.     }
  2581.     menuPtr->postedCascade = mePtr;
  2582.     }
  2583.     return TCL_OK;
  2584. }
  2585.  
  2586. /*
  2587.  *----------------------------------------------------------------------
  2588.  *
  2589.  * ActivateMenuEntry --
  2590.  *
  2591.  *    This procedure is invoked to make a particular menu entry
  2592.  *    the active one, deactivating any other entry that might
  2593.  *    currently be active.
  2594.  *
  2595.  * Results:
  2596.  *    The return value is a standard Tcl result (errors can occur
  2597.  *    while posting and unposting submenus).
  2598.  *
  2599.  * Side effects:
  2600.  *    Menu entries get redisplayed, and the active entry changes.
  2601.  *    Submenus may get posted and unposted.
  2602.  *
  2603.  *----------------------------------------------------------------------
  2604.  */
  2605.  
  2606. static int
  2607. ActivateMenuEntry(menuPtr, index)
  2608.     register Menu *menuPtr;        /* Menu in which to activate. */
  2609.     int index;                /* Index of entry to activate, or
  2610.                      * -1 to deactivate all entries. */
  2611. {
  2612.     register MenuEntry *mePtr;
  2613.     int result = TCL_OK;
  2614.  
  2615.     if (menuPtr->active >= 0) {
  2616.     mePtr = menuPtr->entries[menuPtr->active];
  2617.  
  2618.     /*
  2619.      * Don't change the state unless it's currently active (state
  2620.      * might already have been changed to disabled).
  2621.      */
  2622.  
  2623.     if (mePtr->state == tkActiveUid) {
  2624.         mePtr->state = tkNormalUid;
  2625.     }
  2626.     EventuallyRedrawMenu(menuPtr, menuPtr->entries[menuPtr->active]);
  2627.     }
  2628.     menuPtr->active = index;
  2629.     if (index >= 0) {
  2630.     mePtr = menuPtr->entries[index];
  2631.     mePtr->state = tkActiveUid;
  2632.     EventuallyRedrawMenu(menuPtr, mePtr);
  2633.     }
  2634.     return result;
  2635. }
  2636.  
  2637. /*
  2638.  *----------------------------------------------------------------------
  2639.  *
  2640.  * MenuImageProc --
  2641.  *
  2642.  *    This procedure is invoked by the image code whenever the manager
  2643.  *    for an image does something that affects the size of contents
  2644.  *    of an image displayed in a menu entry.
  2645.  *
  2646.  * Results:
  2647.  *    None.
  2648.  *
  2649.  * Side effects:
  2650.  *    Arranges for the menu to get redisplayed.
  2651.  *
  2652.  *----------------------------------------------------------------------
  2653.  */
  2654.  
  2655. static void
  2656. MenuImageProc(clientData, x, y, width, height, imgWidth, imgHeight)
  2657.     ClientData clientData;        /* Pointer to widget record. */
  2658.     int x, y;                /* Upper left pixel (within image)
  2659.                          * that must be redisplayed. */
  2660.     int width, height;        /* Dimensions of area to redisplay
  2661.                      * (may be <= 0). */
  2662.     int imgWidth, imgHeight;        /* New dimensions of image. */
  2663. {
  2664.     register Menu *menuPtr = ((MenuEntry *) clientData)->menuPtr;
  2665.  
  2666.     if ((menuPtr->tkwin != NULL) && !(menuPtr->flags & RESIZE_PENDING)) {
  2667.     menuPtr->flags |= RESIZE_PENDING;
  2668.     Tcl_DoWhenIdle(ComputeMenuGeometry, (ClientData) menuPtr);
  2669.     }
  2670. }
  2671.  
  2672. /*
  2673.  *----------------------------------------------------------------------
  2674.  *
  2675.  * MenuSelectImageProc --
  2676.  *
  2677.  *    This procedure is invoked by the image code whenever the manager
  2678.  *    for an image does something that affects the size of contents
  2679.  *    of an image displayed in a menu entry when it is selected.
  2680.  *
  2681.  * Results:
  2682.  *    None.
  2683.  *
  2684.  * Side effects:
  2685.  *    Arranges for the menu to get redisplayed.
  2686.  *
  2687.  *----------------------------------------------------------------------
  2688.  */
  2689.  
  2690. static void
  2691. MenuSelectImageProc(clientData, x, y, width, height, imgWidth, imgHeight)
  2692.     ClientData clientData;        /* Pointer to widget record. */
  2693.     int x, y;                /* Upper left pixel (within image)
  2694.                      * that must be redisplayed. */
  2695.     int width, height;            /* Dimensions of area to redisplay
  2696.                      * (may be <= 0). */
  2697.     int imgWidth, imgHeight;        /* New dimensions of image. */
  2698. {
  2699.     register MenuEntry *mePtr = (MenuEntry *) clientData;
  2700.  
  2701.     if ((mePtr->flags & ENTRY_SELECTED)
  2702.         && !(mePtr->menuPtr->flags & REDRAW_PENDING)) {
  2703.     mePtr->menuPtr->flags |= REDRAW_PENDING;
  2704.     Tcl_DoWhenIdle(DisplayMenu, (ClientData) mePtr->menuPtr);
  2705.     }
  2706. }
  2707.