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_settings()
Menu Library
menu_popup()                                                            AES

Syntax

WORD menu_popup( menu, xpos, ypos, mdata )
MENU *menu;
WORD xpos, ypos;
MENU *menu;

Function       menu_popup() displays a popup menu and returns the user's
               selection.

Opcode         36 (0x24)

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

Parameters     menu points to a MENU structure (defined under
               menu_attach()) containing the popup menu. xpos and ypos
               specify the location at which the upper-left corner of the
               starting object will be placed.
               If the function returns a value of 1, the MENU structure
               pointed to by mdata will be filled in with the ending state
               of the menu (including the object the user selected).
               As of AES version 4.1, if menu.mn_scroll is set to
               SCROLL_LISTBOX (-1) when this function is called,
               a drop-down list box will be displayed instead of a popup
               menu.
               Dropdown list boxes will only display a scroll bar if at
               least eight entries exist. If you want to force the scroll
               bar to appear, pad the object with empty G_STRING objects
               with their DISABLED flag set.

Binding        intin[0] = xpos;
               intin[1] = ypos;

               addrin[0] = menu;
               addrin[1] = mdata;

               return crys_if(0x24);

Return Value   menu_popup() returns 0 if an error occurred or 1 if
               successful.

See Also       menu_attach(), menu_settings()

Group          Menu Library