MenuLoad Function (ROM Call 0x3F2)

AMS 2.00 or higher menus.h

HANDLE MenuLoad (const void *BaseMenu, unsigned short Size);

Begins a dynamically created menu using a prefilled static menu as the starting point.

MenuLoad creates a dynamic menu, using the prefilled static menu structure BaseMenu with the size Size (in bytes) as the starting point. It copies the menu's items, flags, width, and height from the static structure. MenuLoad returns the handle of the new dynamically created menu which may be used in DynMenuAdd or DynMenuChange and then passed to MenuBegin to draw the menu, or returns H_NULL if there was not enough memory.

Note: Please see MenuPopup for more informations on menu structures, and take a look at the proposed method to execute menus as described in MenuNew.


Uses: HeapAlloc, memcpy


See also: MenuBegin, MenuNew, DynMenuAdd, DynMenuChange