Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filemenu_attach()
Menu Library
menu_istart()                                                           AES

Syntax

WORD menu_istart( flag, tree, imenu, item )
WORD flag;
OBJECT *tree;
WORD imenu, item;

Function       menu_istart() shifts a sub-menu that is attached to a menu
               item to align vertically with the specified object in the
               sub-menu.

Opcode         38 (0x26)

Availability   This function is only available with AES versions 3.30 and
               above.

Parameters     flag should be set to MIS_SETALIGN (1) to modify the
               alignment of a sub-menu and its parent menu item. If flag
               is set to MIS_GETALIGN (0), no modifications will be made,
               however the sub-menu item index which is currently aligned
               with its parent menu item is returned.
               tree points to the object tree of the menu to alter. imenu
               specifies the object within the submenu which will be
               aligned with menu item item.

Binding        intin[0] = flag;
               intin[1] = imenu;
               intin[2] = item;

               addrin[0] = tree;

               return crys_if(0x26);

Return Value   menu_istart() returns 0 if an error occurred or the
               positive object index of the sub-menu item which is
               currently aligned with its parent menu item.

Comments       Generally, a sub-menu is aligned so that the currently
               selected sub-menu item is aligned with its parent menu.

See Also       menu_attach()

Group          Menu Library