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


NAME
    AddAppMenuItem - add a menuitem to workbench's list              (V36)
                    of appmenuitems.

SYNOPSIS
    appmenuitem = addappmenuitema(id, userdata, text, msgport, taglist)
    D0                            D0     D1      A0     A1       A2

    struct appmenuitem *addappmenuitema(ulong, ulong, char *,
                                            struct msgport *,
                                            struct tagitem *);

    Alternate, varargs version:
    struct appmenuitem *addappmenuitem(ulong, ulong, char *,
                                    struct msgport *,
                                    tag1, data1,
                                    tag2, data2,
                                    ...
                                    TAG_END );

FUNCTION
    Attempt to add the text as a menuitem to workbench's list
    of appmenuitems (the 'Tools' menu strip).

INPUTS
    id       - this variable is strictly for your own use and is ignored
               by workbench.  Typical uses in C are in switch and case
               statements, and in assembly language table lookup.
    userdata - this variable is strictly for your own use and is ignored
               by workbench.
    text     - text for the menuitem (char *)
    msgport  - pointer to message port workbench will use to send you an
               appmessage message of type 'mtype_appmenuitem' when your
               menuitem gets selected.
    taglist  - ptr to a list of tag items.  Must be NULL for V2.0.

RESULTS
    appmenuitem - a pointer to an appmenuitem structure which you pass to
                  removeappmenuitem when you want to remove the menuitem
                  from workbench's list of appmenuitems.  NULL if
                  workbench was unable to add your menuitem; typically
                  happens when workbench is not running or under low
                  memory conditions.

SEE ALSO
    removeappmenuitem()

BUGS
    Currently does not limit the system to 63 menu items...
    Any menu items after the 63rd will not be selectable.