Function add_menu

src/windows.c:1784–1812

* Common code point leading into the interface-specific * add_menu() to allow single-spot adjustments to the parameters, * such as those done by menu_colors. */

 *   such as those done by menu_colors.
 */
void
add_menu(
    winid window,  /* window to use, must be of type NHW_MENU */
    const glyph_info *glyphinfo, /* glyph info with glyph to
                                  * display with item */
    const anything *identifier, /* what to return if selected */
    char ch,                    /* selector letter (0 = pick our own) */
    char gch,                   /* group accelerator (0 = no group) */
    int attr,                   /* attribute for menu text (str) */
    int color,                  /* color for menu text (str) */
    const char *str,            /* menu text */
    unsigned int itemflags)     /* itemflags such as MENU_ITEMFLAGS_SELECTED */
{
    if (!str) {
        /* if 'str' is Null, just return without adding any menu entry */
        debugpline0("add_menu(Null)");
        return;
    }

    if (iflags.use_menu_color) {
        if ((itemflags & MENU_ITEMFLAGS_SKIPMENUCOLORS) == 0)
            (void) get_menu_coloring(str, &color, &attr);
    }
    /* this is the only function that cared about this flag; remove it now */
    itemflags &= ~MENU_ITEMFLAGS_SKIPMENUCOLORS;

    (*windowprocs.win_add_menu)(window, glyphinfo, identifier,
                                ch, gch, attr, color, str, itemflags);
}

/* insert a non-selectable, possibly highlighted line of text into a menu */
void