[Contents] [Index] [Help] [Retrace] [browse <] [Browse >]


NAME
    LayoutMenusA -- Position all the menus and menu items. (V36)
    LayoutMenus -- Varargs stub for LayoutMenusA(). (V36)

SYNOPSIS
    success = LayoutMenusA(menu, vi, taglist)
    D0                     A0    A1  A2

    BOOL LayoutMenusA(struct menu *, aptr, struct tagitem *);

    success = LayoutMenus(menu, vi, firsttag, ...)

    BOOL LayoutMenus(struct menu *, aptr, tag, ...);

FUNCTION
    Lays out all the menus, menu items and sub-items in the supplied
    menu according to the supplied visual information and tag parameters.
    This routine attempts to columnize and/or shift the MenuItems in
    the event that a menu would be too tall or too wide.

INPUTS
    menu - Pointer to menu obtained from createmenusa().
    vi - Pointer returned by getvisualinfoa().
    taglist - Pointer to a tagitem list.

TAGS
    GTMN_TextAttr (struct textattr *) - text attribute to use for
        menu-items and sub-items.  If not supplied, the screen's
        font will be used.  This font must be openable via openfont()
        when this function is called.

RESULT
    success - TRUE if successful, false otherwise (signifies that
        the textattr wasn't openable).

EXAMPLE

NOTES
    When using this function, there is no need to also call
    layoutmenuitemsa().

BUGS
    If a menu ends up being wider than the whole screen, it will
    run off the right-hand side.

SEE ALSO
    createmenusa(), getvisualinfoa()