Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.15.7  menu_popup                                                 TOS

 Name:         »Menu popup« - Take over the display and handling of a 
               popup menu.

 Opcode:       36

 Syntax:       int16_t menu_popup ( MENU *me_menu, int16_t me_xpos, 
               int16_t me_ypos, MENU *me_mdata );

 Description:  The call menu_popup takes over the display and handling 
               of a popup menu, returning the user's selection. The 
               following apply:

                Parameter  Meaning

                me_menu    Pointer to the structure of the popup
                me_xpos    X-coordinate, and
                me_ypos    Y-coordinate of the menu's top left corner
                me_mdata   Pointer to the data of the selected menu 
                           entry

 Return value: An error has arisen only if the value 0 is returned.

 Availability: This function is available only with AES versions 3.30 
               and above. As of AES version 4.1, if mn_scroll of MENU 
               is set to -1 when menu_popup is called, a dropdown list 
               box instead of a popup menu will be displayed; this 
               will have a scroll bar if eight entries or more exist.

               The presence of this function can be ascertained by a 
               call of appl_getinfo (opcode 9).

 Group:        Menu library

 See Also:     Binding   menu_settings   XMEN_MGR