Home » Archimedes archive » Acorn Computing » 1994 08 subscription disc.adf » 9408s » Shareware/Event/Documents/!EShellDoc/TextHelp/Menus
Shareware/Event/Documents/!EShellDoc/TextHelp/Menus
This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.
Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.
Tape/disk: | Home » Archimedes archive » Acorn Computing » 1994 08 subscription disc.adf » 9408s |
Filename: | Shareware/Event/Documents/!EShellDoc/TextHelp/Menus |
Read OK: | ✔ |
File size: | 254F bytes |
Load address: | 0000 |
Exec address: | 0000 |
File contents
PROCshell_AttachMenu() Params => int window handle int icon handle int item handle bool shift flag (not implemented) bool ctrl flag (not implemented) bool alt flag (not implemented) The shift, ctrl and alt flags are for future enhancements to the library and should be set to 0 on this release. If the menu is attached to an icon (rather than a window work area) a click with SELECT, MENU or ADJUST will open the menu. Also the button type of the icon is changed to 1 (click) to ensure the menu pops up when SELECT or ADJUST is used. User FN (PROCshell_AttachMenu) Params => str text of menu selection The function to call when the user makes a choice from the menu. -------------------------------------------------------- PROCshell_AttachMenuMaker() Params => int window handle int icon handle str <function name=>UserFN16> Registers a function to be called before the menu is opened, allowing ticking, shading etc of menu items. User FN (PROCshell_AttachMenuMaker) Params => int window handle over which MENU was pressed int icon handle over which MENU was pressed (-1 for no icon) This function is called before the menu is opened. -------------------------------------------------------- PROCshell_AttachFontMenu() Params => int item handle str function to call when menu_select event occurs (optional, may be "") Use this routine to attach the FontMenu to an icon or a window. Attach the FontMenu to an existing menu structure with PROCshell_AttachFontSubMenu. This routine will attempt to load the necessary 'FontMenu' support module if it is not already loaded. It expects to find it in the EvntShellSystem$Path (usually in !ShellSys). User FN (PROCshell_AttachFontMenu) Params => str selection string <= int junk This function can be used to discover the name of the font (if any) that has been selected in the FontMenu. Use FNshell_FontMenuGetLastSelectedFont for this. -------------------------------------------------------- FNshell_FontMenuGetLastSelectedFont Params => None <= str font name (could be "") This routine should be used in the function called when a menu_select event has occurred to discover if font menu selection has been made, and if so the name of the font. If no valid font menu selection has been made the function will return "" and no action should be taken. -------------------------------------------------------- PROCshell_FontMenuSelectFont() Params => str name of font to select The font name is used by the library routines to decide which font name to select when the font menu opens. As the same font menu can be used by different applications it is important to set this up just before the menu opens. -------------------------------------------------------- PROCshell_AttachMenuDBox() Params => int menu item handle str window identifier str function name str function name Calling this routine will automatically setup the sub menu arrow on the menu item, and also set the 'menu warning' flag. It is not necessary to do this in the menu editor. -------------------------------------------------------- User FN (PROCshell_AttachMenuDBox) Params => int window handle The function to call after creating the window but before opening it. This can be used to fill in icon fields etc. A function name of "" may be used if you don't need to call a function. -------------------------------------------------------- User FN (PROCshell_AttachMenuDBox) Params => int window handle The function to call after opening the window. A function name of "" may be used if you don't need to call a function. -------------------------------------------------------- PROCshell_OpenMenu() Params => int menu x coordinate int menu y coordinate int handle of menu to open Normally this routine is called internally by the library routines in response to menu open events set up by PROCshell_AttachMenu. In some circumstances it may be advantageous to call it from the user applications. -------------------------------------------------------- FNshell_MenuLastXPos Returns the X coordinate of the last menu opened by PROCshell_OpenMenu. -------------------------------------------------------- FNshell_MenuLastYPos Returns the Y coordinate of the last menu opened by PROCshell_OpenMenu. -------------------------------------------------------- PROCshell_MenuShade() Params => int menu or item handle int state Shades menu items. If a menu handle is given then all items in the menu are shaded or deshaded. Menu Shade States The state is 0 for no shading, non 0 for shading. -------------------------------------------------------- PROCshell_MenuTick() Params => int menu or item handle int state Adds or removes ticks for menu items. If a menu handle is given then all items in the menu are ticked or not ticked. See also PROCshell_MenuTickOnly1, PROCshell_MenuTickOnly2 Menu Tick States The state is 0 for no tick, non 0 for a tick. -------------------------------------------------------- PROCshell_MenuPutData() Params => int menu handle str data to write into menu item This routine is used to alter the items of a menu when the program runs. The width of the menu is adjusted automatically. -------------------------------------------------------- PROCshell_AttachSubMenu() Params => int item handle int submenu menu handle str function to call when menu_warning message is received (optional, may be "") User FN (PROCshell_AttachSubMenu) Params => int window handle int icon handle <= int junk -------------------------------------------------------- PROCshell_AttachFontSubMenu() Params => int item handle str function to call when menu_warning message is received (optional, may be "") This routine will attempt to load the necessary 'FontMenu' support module if it is not already loaded. It expects to find it in the EvntShellSystem$Path (usually in !ShellSys). User FN (PROCshell_AttachFontSubMenu) Params => int window handle int icon handle <= int junk This function can be used to set the currently selected font in the menu about to be opened. Use PROCshell_FontMenuSelectFont to do this. -------------------------------------------------------- PROCshell_MenuWritable() Params => int menu or menu item handle int state int size of indirected buffer str validation string Makes the given menu item writable or non writable depending on the state parameter. If a menu handle is given then all items in the menu are made writable or non writable. MenuWritable States The state is 0 for non writable, non 0 for writable. -------------------------------------------------------- PROCshell_MenuDotted() Params => int menu or menu item handle int state Adds or removes a dotted line from below the given menu item. If a menu handle is given instead all items in the menu are effected. MenuDotted States The state is 0 for non writable, non 0 for writable. -------------------------------------------------------- FNshell_MenuNew() Params => str menu title <= int menu handle Creates a new menu with the given title. -------------------------------------------------------- FNshell_MenuAdd() Params => int menu or menu item handle str text for menu item str fn to call when item is selected <= int menu item handle Adds a new item to an existing menu. If a menu handle is given then the new item is added to the end of the menu, if an item handle is given the new item is added before the existing item. User FN (FNshell_MenuAdd) Params => int menu decode block Menu decode block blk+00 position of selected menu item in menu (starting from 0) blk+04 pointer to selected item data blk+08 selected item handle or zero if item was created without MenuUtils blk+12 pointer to text string of selected item blk+16 position of parent menu item in menu (starting from 0) blk+20 pointer to parent item data blk+24 parent item handle or zero if item was created without MenuUtils blk+28 pointer to text string of parent item -------------------------------------------------------- FNshell_MenuTickOnly1() Params => int menu handle int position of item in menu Ticks only the item given by the menu handle and the position of the item. This call is provided for when you don't know the handle of the menu item. See also PROCshell_MenuTickOnly2 -------------------------------------------------------- PROCshell_MenuTickOnly2() Params => int menu item handle Ticks only the item given by the menu item handle. See also PROCshell_MenuTickOnly1 -------------------------------------------------------- PROCshell_MenuColours() Params => int menu item handle int foreground colour int background colour Sets the foreground and background colours of the item given. --------------------------------------------------------
00000000 50 52 4f 43 73 68 65 6c 6c 5f 41 74 74 61 63 68 |PROCshell_Attach| 00000010 4d 65 6e 75 28 29 0a 50 61 72 61 6d 73 20 3d 3e |Menu().Params =>| 00000020 20 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 | . int | 00000030 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 0a 20 | window handle. | 00000040 20 20 20 20 20 20 20 20 69 6e 74 20 20 69 63 6f | int ico| 00000050 6e 20 68 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 |n handle. | 00000060 20 20 69 6e 74 20 20 69 74 65 6d 20 68 61 6e 64 | int item hand| 00000070 6c 65 20 20 0a 20 20 20 20 20 20 20 20 20 62 6f |le . bo| 00000080 6f 6c 20 73 68 69 66 74 20 66 6c 61 67 20 28 6e |ol shift flag (n| 00000090 6f 74 20 69 6d 70 6c 65 6d 65 6e 74 65 64 29 0a |ot implemented).| 000000a0 20 20 20 20 20 20 20 20 20 62 6f 6f 6c 20 63 74 | bool ct| 000000b0 72 6c 20 20 66 6c 61 67 20 28 6e 6f 74 20 69 6d |rl flag (not im| 000000c0 70 6c 65 6d 65 6e 74 65 64 29 0a 20 20 20 20 20 |plemented). | 000000d0 20 20 20 20 62 6f 6f 6c 20 61 6c 74 20 20 20 66 | bool alt f| 000000e0 6c 61 67 20 28 6e 6f 74 20 69 6d 70 6c 65 6d 65 |lag (not impleme| 000000f0 6e 74 65 64 29 0a 0a 54 68 65 20 73 68 69 66 74 |nted)..The shift| 00000100 2c 20 63 74 72 6c 20 61 6e 64 20 61 6c 74 20 66 |, ctrl and alt f| 00000110 6c 61 67 73 20 61 72 65 20 66 6f 72 20 66 75 74 |lags are for fut| 00000120 75 72 65 0a 65 6e 68 61 6e 63 65 6d 65 6e 74 73 |ure.enhancements| 00000130 20 74 6f 20 74 68 65 20 6c 69 62 72 61 72 79 20 | to the library | 00000140 61 6e 64 20 73 68 6f 75 6c 64 20 62 65 20 73 65 |and should be se| 00000150 74 0a 74 6f 20 30 20 6f 6e 20 74 68 69 73 20 72 |t.to 0 on this r| 00000160 65 6c 65 61 73 65 2e 0a 0a 49 66 20 74 68 65 20 |elease...If the | 00000170 6d 65 6e 75 20 69 73 20 61 74 74 61 63 68 65 64 |menu is attached| 00000180 20 74 6f 20 61 6e 20 69 63 6f 6e 20 28 72 61 74 | to an icon (rat| 00000190 68 65 72 20 74 68 61 6e 0a 61 20 77 69 6e 64 6f |her than.a windo| 000001a0 77 20 77 6f 72 6b 20 61 72 65 61 29 20 61 20 63 |w work area) a c| 000001b0 6c 69 63 6b 20 77 69 74 68 20 53 45 4c 45 43 54 |lick with SELECT| 000001c0 2c 20 4d 45 4e 55 0a 6f 72 20 41 44 4a 55 53 54 |, MENU.or ADJUST| 000001d0 20 77 69 6c 6c 20 6f 70 65 6e 20 74 68 65 20 6d | will open the m| 000001e0 65 6e 75 2e 20 41 6c 73 6f 20 74 68 65 20 62 75 |enu. Also the bu| 000001f0 74 74 6f 6e 0a 74 79 70 65 20 6f 66 20 74 68 65 |tton.type of the| 00000200 20 69 63 6f 6e 20 69 73 20 63 68 61 6e 67 65 64 | icon is changed| 00000210 20 74 6f 20 31 20 28 63 6c 69 63 6b 29 20 74 6f | to 1 (click) to| 00000220 0a 65 6e 73 75 72 65 20 74 68 65 20 6d 65 6e 75 |.ensure the menu| 00000230 20 70 6f 70 73 20 75 70 20 77 68 65 6e 20 53 45 | pops up when SE| 00000240 4c 45 43 54 20 6f 72 20 41 44 4a 55 53 54 0a 69 |LECT or ADJUST.i| 00000250 73 20 75 73 65 64 2e 0a 0a 55 73 65 72 20 46 4e |s used...User FN| 00000260 20 28 50 52 4f 43 73 68 65 6c 6c 5f 41 74 74 61 | (PROCshell_Atta| 00000270 63 68 4d 65 6e 75 29 0a 50 61 72 61 6d 73 20 3d |chMenu).Params =| 00000280 3e 20 0a 20 20 20 20 20 20 20 20 20 73 74 72 20 |> . str | 00000290 74 65 78 74 20 6f 66 20 6d 65 6e 75 20 73 65 6c |text of menu sel| 000002a0 65 63 74 69 6f 6e 0a 20 0a 54 68 65 20 66 75 6e |ection. .The fun| 000002b0 63 74 69 6f 6e 20 74 6f 20 63 61 6c 6c 20 77 68 |ction to call wh| 000002c0 65 6e 20 74 68 65 20 75 73 65 72 20 6d 61 6b 65 |en the user make| 000002d0 73 0a 61 20 63 68 6f 69 63 65 20 66 72 6f 6d 20 |s.a choice from | 000002e0 74 68 65 20 6d 65 6e 75 2e 0a 0a 2d 2d 2d 2d 2d |the menu...-----| 000002f0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000320 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 41 |---..PROCshell_A| 00000330 74 74 61 63 68 4d 65 6e 75 4d 61 6b 65 72 28 29 |ttachMenuMaker()| 00000340 0a 50 61 72 61 6d 73 20 3d 3e 20 20 20 0a 20 20 |.Params => . | 00000350 20 20 20 20 20 20 20 69 6e 74 20 77 69 6e 64 6f | int windo| 00000360 77 20 68 61 6e 64 6c 65 20 20 20 0a 20 20 20 20 |w handle . | 00000370 20 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 | int icon ha| 00000380 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 73 74 |ndle. st| 00000390 72 20 3c 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 |r <function name| 000003a0 3d 3e 55 73 65 72 46 4e 31 36 3e 0a 0a 52 65 67 |=>UserFN16>..Reg| 000003b0 69 73 74 65 72 73 20 61 20 66 75 6e 63 74 69 6f |isters a functio| 000003c0 6e 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 62 |n to be called b| 000003d0 65 66 6f 72 65 20 74 68 65 0a 6d 65 6e 75 20 69 |efore the.menu i| 000003e0 73 20 6f 70 65 6e 65 64 2c 20 61 6c 6c 6f 77 69 |s opened, allowi| 000003f0 6e 67 20 74 69 63 6b 69 6e 67 2c 20 73 68 61 64 |ng ticking, shad| 00000400 69 6e 67 20 65 74 63 0a 6f 66 20 6d 65 6e 75 20 |ing etc.of menu | 00000410 69 74 65 6d 73 2e 0a 0a 55 73 65 72 20 46 4e 20 |items...User FN | 00000420 28 50 52 4f 43 73 68 65 6c 6c 5f 41 74 74 61 63 |(PROCshell_Attac| 00000430 68 4d 65 6e 75 4d 61 6b 65 72 29 0a 50 61 72 61 |hMenuMaker).Para| 00000440 6d 73 20 3d 3e 0a 20 20 20 20 20 20 20 20 20 69 |ms =>. i| 00000450 6e 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c 65 |nt window handle| 00000460 20 6f 76 65 72 20 77 68 69 63 68 20 4d 45 4e 55 | over which MENU| 00000470 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 77 61 |. wa| 00000480 73 20 70 72 65 73 73 65 64 20 0a 20 20 20 20 20 |s pressed . | 00000490 20 20 20 20 69 6e 74 20 69 63 6f 6e 20 68 61 6e | int icon han| 000004a0 64 6c 65 20 6f 76 65 72 20 77 68 69 63 68 20 4d |dle over which M| 000004b0 45 4e 55 20 77 61 73 0a 20 20 20 20 20 20 20 20 |ENU was. | 000004c0 20 20 20 20 20 70 72 65 73 73 65 64 20 28 2d 31 | pressed (-1| 000004d0 20 66 6f 72 20 6e 6f 20 69 63 6f 6e 29 0a 20 0a | for no icon). .| 000004e0 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 |This function is| 000004f0 20 63 61 6c 6c 65 64 20 62 65 66 6f 72 65 20 74 | called before t| 00000500 68 65 20 6d 65 6e 75 20 69 73 0a 6f 70 65 6e 65 |he menu is.opene| 00000510 64 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |d...------------| 00000520 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000540 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 |------------..PR| 00000550 4f 43 73 68 65 6c 6c 5f 41 74 74 61 63 68 46 6f |OCshell_AttachFo| 00000560 6e 74 4d 65 6e 75 28 29 0a 50 61 72 61 6d 73 20 |ntMenu().Params | 00000570 3d 3e 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 |=>. int | 00000580 69 74 65 6d 20 68 61 6e 64 6c 65 0a 20 20 20 20 |item handle. | 00000590 20 20 20 20 20 73 74 72 20 66 75 6e 63 74 69 6f | str functio| 000005a0 6e 20 74 6f 20 63 61 6c 6c 20 77 68 65 6e 20 6d |n to call when m| 000005b0 65 6e 75 5f 73 65 6c 65 63 74 0a 20 20 20 20 20 |enu_select. | 000005c0 20 20 20 20 20 20 20 20 65 76 65 6e 74 20 6f 63 | event oc| 000005d0 63 75 72 73 20 28 6f 70 74 69 6f 6e 61 6c 2c 20 |curs (optional, | 000005e0 6d 61 79 20 62 65 20 22 22 29 0a 0a 55 73 65 20 |may be "")..Use | 000005f0 74 68 69 73 20 72 6f 75 74 69 6e 65 20 74 6f 20 |this routine to | 00000600 61 74 74 61 63 68 20 74 68 65 20 46 6f 6e 74 4d |attach the FontM| 00000610 65 6e 75 20 74 6f 20 61 6e 20 69 63 6f 6e 20 6f |enu to an icon o| 00000620 72 0a 61 20 77 69 6e 64 6f 77 2e 20 41 74 74 61 |r.a window. Atta| 00000630 63 68 20 74 68 65 20 46 6f 6e 74 4d 65 6e 75 20 |ch the FontMenu | 00000640 74 6f 20 61 6e 20 65 78 69 73 74 69 6e 67 20 6d |to an existing m| 00000650 65 6e 75 0a 73 74 72 75 63 74 75 72 65 20 77 69 |enu.structure wi| 00000660 74 68 20 50 52 4f 43 73 68 65 6c 6c 5f 41 74 74 |th PROCshell_Att| 00000670 61 63 68 46 6f 6e 74 53 75 62 4d 65 6e 75 2e 0a |achFontSubMenu..| 00000680 0a 54 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 |.This routine wi| 00000690 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 6c 6f |ll attempt to lo| 000006a0 61 64 20 74 68 65 20 6e 65 63 65 73 73 61 72 79 |ad the necessary| 000006b0 0a 27 46 6f 6e 74 4d 65 6e 75 27 20 73 75 70 70 |.'FontMenu' supp| 000006c0 6f 72 74 20 6d 6f 64 75 6c 65 20 69 66 20 69 74 |ort module if it| 000006d0 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 0a | is not already.| 000006e0 6c 6f 61 64 65 64 2e 20 49 74 20 65 78 70 65 63 |loaded. It expec| 000006f0 74 73 20 74 6f 20 66 69 6e 64 20 69 74 20 69 6e |ts to find it in| 00000700 20 74 68 65 0a 45 76 6e 74 53 68 65 6c 6c 53 79 | the.EvntShellSy| 00000710 73 74 65 6d 24 50 61 74 68 20 28 75 73 75 61 6c |stem$Path (usual| 00000720 6c 79 20 69 6e 20 21 53 68 65 6c 6c 53 79 73 29 |ly in !ShellSys)| 00000730 2e 0a 0a 55 73 65 72 20 46 4e 20 28 50 52 4f 43 |...User FN (PROC| 00000740 73 68 65 6c 6c 5f 41 74 74 61 63 68 46 6f 6e 74 |shell_AttachFont| 00000750 4d 65 6e 75 29 20 0a 50 61 72 61 6d 73 20 3d 3e |Menu) .Params =>| 00000760 20 0a 20 20 20 20 20 20 20 20 20 73 74 72 20 73 | . str s| 00000770 65 6c 65 63 74 69 6f 6e 20 73 74 72 69 6e 67 0a |election string.| 00000780 0a 20 20 20 20 20 20 20 3c 3d 0a 20 20 20 20 20 |. <=. | 00000790 20 20 20 20 69 6e 74 20 6a 75 6e 6b 0a 0a 54 68 | int junk..Th| 000007a0 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 61 6e 20 |is function can | 000007b0 62 65 20 75 73 65 64 20 74 6f 20 64 69 73 63 6f |be used to disco| 000007c0 76 65 72 20 74 68 65 20 6e 61 6d 65 0a 6f 66 20 |ver the name.of | 000007d0 74 68 65 20 66 6f 6e 74 20 28 69 66 20 61 6e 79 |the font (if any| 000007e0 29 20 74 68 61 74 20 68 61 73 20 62 65 65 6e 20 |) that has been | 000007f0 73 65 6c 65 63 74 65 64 20 69 6e 0a 74 68 65 20 |selected in.the | 00000800 46 6f 6e 74 4d 65 6e 75 2e 20 55 73 65 20 46 4e |FontMenu. Use FN| 00000810 73 68 65 6c 6c 5f 46 6f 6e 74 4d 65 6e 75 47 65 |shell_FontMenuGe| 00000820 74 4c 61 73 74 53 65 6c 65 63 74 65 64 46 6f 6e |tLastSelectedFon| 00000830 74 0a 66 6f 72 20 74 68 69 73 2e 0a 0a 2d 2d 2d |t.for this...---| 00000840 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000870 2d 2d 2d 2d 2d 0a 0a 46 4e 73 68 65 6c 6c 5f 46 |-----..FNshell_F| 00000880 6f 6e 74 4d 65 6e 75 47 65 74 4c 61 73 74 53 65 |ontMenuGetLastSe| 00000890 6c 65 63 74 65 64 46 6f 6e 74 0a 50 61 72 61 6d |lectedFont.Param| 000008a0 73 20 3d 3e 0a 20 20 20 20 20 20 20 20 20 4e 6f |s =>. No| 000008b0 6e 65 0a 0a 20 20 20 20 20 20 20 3c 3d 0a 20 20 |ne.. <=. | 000008c0 20 20 20 20 20 20 20 73 74 72 20 66 6f 6e 74 20 | str font | 000008d0 6e 61 6d 65 20 28 63 6f 75 6c 64 20 62 65 20 22 |name (could be "| 000008e0 22 29 0a 0a 54 68 69 73 20 72 6f 75 74 69 6e 65 |")..This routine| 000008f0 20 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 20 | should be used | 00000900 69 6e 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 0a |in the function.| 00000910 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 20 6d 65 |called when a me| 00000920 6e 75 5f 73 65 6c 65 63 74 20 65 76 65 6e 74 20 |nu_select event | 00000930 68 61 73 20 6f 63 63 75 72 72 65 64 20 74 6f 0a |has occurred to.| 00000940 64 69 73 63 6f 76 65 72 20 69 66 20 66 6f 6e 74 |discover if font| 00000950 20 6d 65 6e 75 20 73 65 6c 65 63 74 69 6f 6e 20 | menu selection | 00000960 68 61 73 20 62 65 65 6e 20 6d 61 64 65 2c 0a 61 |has been made,.a| 00000970 6e 64 20 69 66 20 73 6f 20 74 68 65 20 6e 61 6d |nd if so the nam| 00000980 65 20 6f 66 20 74 68 65 20 66 6f 6e 74 2e 0a 0a |e of the font...| 00000990 49 66 20 6e 6f 20 76 61 6c 69 64 20 66 6f 6e 74 |If no valid font| 000009a0 20 6d 65 6e 75 20 73 65 6c 65 63 74 69 6f 6e 20 | menu selection | 000009b0 68 61 73 20 62 65 65 6e 20 6d 61 64 65 0a 74 68 |has been made.th| 000009c0 65 20 66 75 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 |e function will | 000009d0 72 65 74 75 72 6e 20 22 22 20 61 6e 64 20 6e 6f |return "" and no| 000009e0 20 61 63 74 69 6f 6e 20 73 68 6f 75 6c 64 0a 62 | action should.b| 000009f0 65 20 74 61 6b 65 6e 2e 0a 0a 2d 2d 2d 2d 2d 2d |e taken...------| 00000a00 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000a30 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 46 6f |--..PROCshell_Fo| 00000a40 6e 74 4d 65 6e 75 53 65 6c 65 63 74 46 6f 6e 74 |ntMenuSelectFont| 00000a50 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 |().Params =>. | 00000a60 20 20 20 20 20 20 73 74 72 20 6e 61 6d 65 20 6f | str name o| 00000a70 66 20 66 6f 6e 74 20 74 6f 20 73 65 6c 65 63 74 |f font to select| 00000a80 0a 0a 54 68 65 20 66 6f 6e 74 20 6e 61 6d 65 20 |..The font name | 00000a90 69 73 20 75 73 65 64 20 62 79 20 74 68 65 20 6c |is used by the l| 00000aa0 69 62 72 61 72 79 20 72 6f 75 74 69 6e 65 73 0a |ibrary routines.| 00000ab0 74 6f 20 64 65 63 69 64 65 20 77 68 69 63 68 20 |to decide which | 00000ac0 66 6f 6e 74 20 6e 61 6d 65 20 74 6f 20 73 65 6c |font name to sel| 00000ad0 65 63 74 20 77 68 65 6e 20 74 68 65 0a 66 6f 6e |ect when the.fon| 00000ae0 74 20 6d 65 6e 75 20 6f 70 65 6e 73 2e 20 41 73 |t menu opens. As| 00000af0 20 74 68 65 20 73 61 6d 65 20 66 6f 6e 74 20 6d | the same font m| 00000b00 65 6e 75 20 63 61 6e 20 62 65 0a 75 73 65 64 20 |enu can be.used | 00000b10 62 79 20 64 69 66 66 65 72 65 6e 74 20 61 70 70 |by different app| 00000b20 6c 69 63 61 74 69 6f 6e 73 20 69 74 20 69 73 20 |lications it is | 00000b30 69 6d 70 6f 72 74 61 6e 74 0a 74 6f 20 73 65 74 |important.to set| 00000b40 20 74 68 69 73 20 75 70 20 6a 75 73 74 20 62 65 | this up just be| 00000b50 66 6f 72 65 20 74 68 65 20 6d 65 6e 75 20 6f 70 |fore the menu op| 00000b60 65 6e 73 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |ens...----------| 00000b70 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000b90 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |--------------..| 00000ba0 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 41 74 74 61 |..PROCshell_Atta| 00000bb0 63 68 4d 65 6e 75 44 42 6f 78 28 29 0a 50 61 72 |chMenuDBox().Par| 00000bc0 61 6d 73 20 3d 3e 20 20 0a 20 20 20 20 20 20 20 |ams => . | 00000bd0 20 20 69 6e 74 20 6d 65 6e 75 20 69 74 65 6d 20 | int menu item | 00000be0 68 61 6e 64 6c 65 20 20 20 20 20 0a 20 20 20 20 |handle . | 00000bf0 20 20 20 20 20 73 74 72 20 77 69 6e 64 6f 77 20 | str window | 00000c00 69 64 65 6e 74 69 66 69 65 72 0a 20 20 20 20 20 |identifier. | 00000c10 20 20 20 20 73 74 72 20 66 75 6e 63 74 69 6f 6e | str function| 00000c20 20 6e 61 6d 65 0a 20 20 20 20 20 20 20 20 20 73 | name. s| 00000c30 74 72 20 66 75 6e 63 74 69 6f 6e 20 6e 61 6d 65 |tr function name| 00000c40 0a 0a 43 61 6c 6c 69 6e 67 20 74 68 69 73 20 72 |..Calling this r| 00000c50 6f 75 74 69 6e 65 20 77 69 6c 6c 20 61 75 74 6f |outine will auto| 00000c60 6d 61 74 69 63 61 6c 6c 79 20 73 65 74 75 70 20 |matically setup | 00000c70 74 68 65 20 73 75 62 0a 6d 65 6e 75 20 61 72 72 |the sub.menu arr| 00000c80 6f 77 20 6f 6e 20 74 68 65 20 6d 65 6e 75 20 69 |ow on the menu i| 00000c90 74 65 6d 2c 20 61 6e 64 20 61 6c 73 6f 20 73 65 |tem, and also se| 00000ca0 74 20 74 68 65 20 27 6d 65 6e 75 0a 77 61 72 6e |t the 'menu.warn| 00000cb0 69 6e 67 27 20 66 6c 61 67 2e 20 49 74 20 69 73 |ing' flag. It is| 00000cc0 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 20 74 | not necessary t| 00000cd0 6f 20 64 6f 20 74 68 69 73 20 69 6e 20 74 68 65 |o do this in the| 00000ce0 0a 6d 65 6e 75 20 65 64 69 74 6f 72 2e 0a 0a 2d |.menu editor...-| 00000cf0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000d20 2d 2d 2d 2d 2d 2d 2d 0a 0a 55 73 65 72 20 46 4e |-------..User FN| 00000d30 20 28 50 52 4f 43 73 68 65 6c 6c 5f 41 74 74 61 | (PROCshell_Atta| 00000d40 63 68 4d 65 6e 75 44 42 6f 78 29 0a 50 61 72 61 |chMenuDBox).Para| 00000d50 6d 73 20 3d 3e 20 0a 20 20 20 20 20 20 20 20 20 |ms => . | 00000d60 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 6c |int window handl| 00000d70 65 0a 20 0a 54 68 65 20 66 75 6e 63 74 69 6f 6e |e. .The function| 00000d80 20 74 6f 20 63 61 6c 6c 20 61 66 74 65 72 20 63 | to call after c| 00000d90 72 65 61 74 69 6e 67 20 74 68 65 20 77 69 6e 64 |reating the wind| 00000da0 6f 77 0a 62 75 74 20 62 65 66 6f 72 65 20 6f 70 |ow.but before op| 00000db0 65 6e 69 6e 67 20 69 74 2e 20 54 68 69 73 20 63 |ening it. This c| 00000dc0 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 66 69 |an be used to fi| 00000dd0 6c 6c 0a 69 6e 20 69 63 6f 6e 20 66 69 65 6c 64 |ll.in icon field| 00000de0 73 20 65 74 63 2e 20 41 20 66 75 6e 63 74 69 6f |s etc. A functio| 00000df0 6e 20 6e 61 6d 65 20 6f 66 20 22 22 20 6d 61 79 |n name of "" may| 00000e00 0a 62 65 20 75 73 65 64 20 69 66 20 79 6f 75 20 |.be used if you | 00000e10 64 6f 6e 27 74 20 6e 65 65 64 20 74 6f 20 63 61 |don't need to ca| 00000e20 6c 6c 20 61 20 66 75 6e 63 74 69 6f 6e 2e 0a 0a |ll a function...| 00000e30 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000e60 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 55 73 65 72 20 46 |--------..User F| 00000e70 4e 20 28 50 52 4f 43 73 68 65 6c 6c 5f 41 74 74 |N (PROCshell_Att| 00000e80 61 63 68 4d 65 6e 75 44 42 6f 78 29 0a 50 61 72 |achMenuDBox).Par| 00000e90 61 6d 73 20 3d 3e 20 0a 20 20 20 20 20 20 20 20 |ams => . | 00000ea0 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 6e 64 | int window hand| 00000eb0 6c 65 0a 20 0a 54 68 65 20 66 75 6e 63 74 69 6f |le. .The functio| 00000ec0 6e 20 74 6f 20 63 61 6c 6c 20 61 66 74 65 72 20 |n to call after | 00000ed0 6f 70 65 6e 69 6e 67 20 74 68 65 20 77 69 6e 64 |opening the wind| 00000ee0 6f 77 2e 0a 41 20 66 75 6e 63 74 69 6f 6e 20 6e |ow..A function n| 00000ef0 61 6d 65 20 6f 66 20 22 22 20 6d 61 79 20 62 65 |ame of "" may be| 00000f00 20 75 73 65 64 20 69 66 20 79 6f 75 20 64 6f 6e | used if you don| 00000f10 27 74 0a 6e 65 65 64 20 74 6f 20 63 61 6c 6c 20 |'t.need to call | 00000f20 61 20 66 75 6e 63 74 69 6f 6e 2e 0a 0a 2d 2d 2d |a function...---| 00000f30 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00000f60 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c |-----..PROCshell| 00000f70 5f 4f 70 65 6e 4d 65 6e 75 28 29 0a 50 61 72 61 |_OpenMenu().Para| 00000f80 6d 73 20 3d 3e 20 20 20 20 20 0a 20 20 20 20 20 |ms => . | 00000f90 20 20 20 20 69 6e 74 20 6d 65 6e 75 20 78 20 63 | int menu x c| 00000fa0 6f 6f 72 64 69 6e 61 74 65 0a 20 20 20 20 20 20 |oordinate. | 00000fb0 20 20 20 69 6e 74 20 6d 65 6e 75 20 79 20 63 6f | int menu y co| 00000fc0 6f 72 64 69 6e 61 74 65 0a 20 20 20 20 20 20 20 |ordinate. | 00000fd0 20 20 69 6e 74 20 68 61 6e 64 6c 65 20 6f 66 20 | int handle of | 00000fe0 6d 65 6e 75 20 74 6f 20 6f 70 65 6e 0a 0a 4e 6f |menu to open..No| 00000ff0 72 6d 61 6c 6c 79 20 74 68 69 73 20 72 6f 75 74 |rmally this rout| 00001000 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 69 6e |ine is called in| 00001010 74 65 72 6e 61 6c 6c 79 0a 62 79 20 74 68 65 20 |ternally.by the | 00001020 6c 69 62 72 61 72 79 20 72 6f 75 74 69 6e 65 73 |library routines| 00001030 20 69 6e 20 72 65 73 70 6f 6e 73 65 20 74 6f 20 | in response to | 00001040 6d 65 6e 75 0a 6f 70 65 6e 20 65 76 65 6e 74 73 |menu.open events| 00001050 20 73 65 74 20 75 70 20 62 79 20 50 52 4f 43 73 | set up by PROCs| 00001060 68 65 6c 6c 5f 41 74 74 61 63 68 4d 65 6e 75 2e |hell_AttachMenu.| 00001070 0a 49 6e 20 73 6f 6d 65 20 63 69 72 63 75 6d 73 |.In some circums| 00001080 74 61 6e 63 65 73 20 69 74 20 6d 61 79 20 62 65 |tances it may be| 00001090 20 61 64 76 61 6e 74 61 67 65 6f 75 73 0a 74 6f | advantageous.to| 000010a0 20 63 61 6c 6c 20 69 74 20 66 72 6f 6d 20 74 68 | call it from th| 000010b0 65 20 75 73 65 72 20 61 70 70 6c 69 63 61 74 69 |e user applicati| 000010c0 6f 6e 73 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |ons...----------| 000010d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000010f0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |--------------..| 00001100 46 4e 73 68 65 6c 6c 5f 4d 65 6e 75 4c 61 73 74 |FNshell_MenuLast| 00001110 58 50 6f 73 0a 52 65 74 75 72 6e 73 20 74 68 65 |XPos.Returns the| 00001120 20 58 20 63 6f 6f 72 64 69 6e 61 74 65 20 6f 66 | X coordinate of| 00001130 20 74 68 65 20 6c 61 73 74 20 6d 65 6e 75 0a 6f | the last menu.o| 00001140 70 65 6e 65 64 20 62 79 20 50 52 4f 43 73 68 65 |pened by PROCshe| 00001150 6c 6c 5f 4f 70 65 6e 4d 65 6e 75 2e 0a 0a 2d 2d |ll_OpenMenu...--| 00001160 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001190 2d 2d 2d 2d 2d 2d 0a 0a 46 4e 73 68 65 6c 6c 5f |------..FNshell_| 000011a0 4d 65 6e 75 4c 61 73 74 59 50 6f 73 0a 52 65 74 |MenuLastYPos.Ret| 000011b0 75 72 6e 73 20 74 68 65 20 59 20 63 6f 6f 72 64 |urns the Y coord| 000011c0 69 6e 61 74 65 20 6f 66 20 74 68 65 20 6c 61 73 |inate of the las| 000011d0 74 20 6d 65 6e 75 0a 6f 70 65 6e 65 64 20 62 79 |t menu.opened by| 000011e0 20 50 52 4f 43 73 68 65 6c 6c 5f 4f 70 65 6e 4d | PROCshell_OpenM| 000011f0 65 6e 75 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |enu...----------| 00001200 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001220 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |--------------..| 00001230 50 52 4f 43 73 68 65 6c 6c 5f 4d 65 6e 75 53 68 |PROCshell_MenuSh| 00001240 61 64 65 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a |ade().Params =>.| 00001250 20 20 20 20 20 20 20 20 20 69 6e 74 20 6d 65 6e | int men| 00001260 75 20 6f 72 20 69 74 65 6d 20 68 61 6e 64 6c 65 |u or item handle| 00001270 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 73 74 |. int st| 00001280 61 74 65 0a 0a 53 68 61 64 65 73 20 6d 65 6e 75 |ate..Shades menu| 00001290 20 69 74 65 6d 73 2e 20 49 66 20 61 20 6d 65 6e | items. If a men| 000012a0 75 20 68 61 6e 64 6c 65 20 69 73 0a 67 69 76 65 |u handle is.give| 000012b0 6e 20 74 68 65 6e 20 61 6c 6c 20 69 74 65 6d 73 |n then all items| 000012c0 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 61 72 65 | in the menu are| 000012d0 0a 73 68 61 64 65 64 20 6f 72 20 64 65 73 68 61 |.shaded or desha| 000012e0 64 65 64 2e 0a 0a 4d 65 6e 75 20 53 68 61 64 65 |ded...Menu Shade| 000012f0 20 53 74 61 74 65 73 0a 54 68 65 20 73 74 61 74 | States.The stat| 00001300 65 20 69 73 20 30 20 66 6f 72 20 6e 6f 20 73 68 |e is 0 for no sh| 00001310 61 64 69 6e 67 2c 20 6e 6f 6e 20 30 20 66 6f 72 |ading, non 0 for| 00001320 20 73 68 61 64 69 6e 67 2e 0a 0a 2d 2d 2d 2d 2d | shading...-----| 00001330 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001360 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 4d |---..PROCshell_M| 00001370 65 6e 75 54 69 63 6b 28 29 0a 50 61 72 61 6d 73 |enuTick().Params| 00001380 20 3d 3e 0a 20 20 20 20 20 20 20 20 20 69 6e 74 | =>. int| 00001390 20 6d 65 6e 75 20 6f 72 20 69 74 65 6d 20 68 61 | menu or item ha| 000013a0 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 69 6e |ndle. in| 000013b0 74 20 73 74 61 74 65 0a 0a 41 64 64 73 20 6f 72 |t state..Adds or| 000013c0 20 72 65 6d 6f 76 65 73 20 74 69 63 6b 73 20 66 | removes ticks f| 000013d0 6f 72 20 6d 65 6e 75 0a 69 74 65 6d 73 2e 20 49 |or menu.items. I| 000013e0 66 20 61 20 6d 65 6e 75 20 68 61 6e 64 6c 65 20 |f a menu handle | 000013f0 69 73 20 67 69 76 65 6e 0a 74 68 65 6e 20 61 6c |is given.then al| 00001400 6c 20 69 74 65 6d 73 20 69 6e 20 74 68 65 20 6d |l items in the m| 00001410 65 6e 75 20 61 72 65 0a 74 69 63 6b 65 64 20 6f |enu are.ticked o| 00001420 72 20 6e 6f 74 20 74 69 63 6b 65 64 2e 0a 0a 53 |r not ticked...S| 00001430 65 65 20 61 6c 73 6f 20 50 52 4f 43 73 68 65 6c |ee also PROCshel| 00001440 6c 5f 4d 65 6e 75 54 69 63 6b 4f 6e 6c 79 31 2c |l_MenuTickOnly1,| 00001450 0a 20 20 20 20 20 20 20 20 20 50 52 4f 43 73 68 |. PROCsh| 00001460 65 6c 6c 5f 4d 65 6e 75 54 69 63 6b 4f 6e 6c 79 |ell_MenuTickOnly| 00001470 32 0a 0a 4d 65 6e 75 20 54 69 63 6b 20 53 74 61 |2..Menu Tick Sta| 00001480 74 65 73 0a 54 68 65 20 73 74 61 74 65 20 69 73 |tes.The state is| 00001490 20 30 20 66 6f 72 20 6e 6f 20 20 74 69 63 6b 2c | 0 for no tick,| 000014a0 20 6e 6f 6e 20 30 20 66 6f 72 20 61 20 74 69 63 | non 0 for a tic| 000014b0 6b 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |k...------------| 000014c0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 000014e0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 |------------..PR| 000014f0 4f 43 73 68 65 6c 6c 5f 4d 65 6e 75 50 75 74 44 |OCshell_MenuPutD| 00001500 61 74 61 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a |ata().Params =>.| 00001510 20 20 20 20 20 20 20 20 20 69 6e 74 20 6d 65 6e | int men| 00001520 75 20 68 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 |u handle. | 00001530 20 20 73 74 72 20 64 61 74 61 20 74 6f 20 77 72 | str data to wr| 00001540 69 74 65 20 69 6e 74 6f 20 6d 65 6e 75 20 69 74 |ite into menu it| 00001550 65 6d 0a 0a 54 68 69 73 20 72 6f 75 74 69 6e 65 |em..This routine| 00001560 20 69 73 20 75 73 65 64 20 74 6f 20 61 6c 74 65 | is used to alte| 00001570 72 20 74 68 65 20 69 74 65 6d 73 20 6f 66 20 61 |r the items of a| 00001580 0a 6d 65 6e 75 20 77 68 65 6e 20 74 68 65 20 70 |.menu when the p| 00001590 72 6f 67 72 61 6d 20 72 75 6e 73 2e 20 54 68 65 |rogram runs. The| 000015a0 20 77 69 64 74 68 20 6f 66 20 74 68 65 0a 6d 65 | width of the.me| 000015b0 6e 75 20 69 73 20 61 64 6a 75 73 74 65 64 20 61 |nu is adjusted a| 000015c0 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 0a 2d |utomatically...-| 000015d0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001600 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 |-------..PROCshe| 00001610 6c 6c 5f 41 74 74 61 63 68 53 75 62 4d 65 6e 75 |ll_AttachSubMenu| 00001620 28 29 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 |().Params =>. | 00001630 20 20 20 20 20 20 69 6e 74 20 69 74 65 6d 20 68 | int item h| 00001640 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 69 |andle. i| 00001650 6e 74 20 73 75 62 6d 65 6e 75 20 6d 65 6e 75 20 |nt submenu menu | 00001660 68 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 |handle. | 00001670 73 74 72 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 |str function to | 00001680 63 61 6c 6c 20 77 68 65 6e 20 6d 65 6e 75 5f 77 |call when menu_w| 00001690 61 72 6e 69 6e 67 0a 20 20 20 20 20 20 20 20 20 |arning. | 000016a0 20 20 20 20 6d 65 73 73 61 67 65 20 69 73 20 72 | message is r| 000016b0 65 63 65 69 76 65 64 20 28 6f 70 74 69 6f 6e 61 |eceived (optiona| 000016c0 6c 2c 20 6d 61 79 0a 20 20 20 20 20 20 20 20 20 |l, may. | 000016d0 20 20 20 20 62 65 20 22 22 29 0a 0a 55 73 65 72 | be "")..User| 000016e0 20 46 4e 20 28 50 52 4f 43 73 68 65 6c 6c 5f 41 | FN (PROCshell_A| 000016f0 74 74 61 63 68 53 75 62 4d 65 6e 75 29 20 0a 50 |ttachSubMenu) .P| 00001700 61 72 61 6d 73 20 3d 3e 20 0a 20 20 20 20 20 20 |arams => . | 00001710 20 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 | int window ha| 00001720 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 69 6e |ndle. in| 00001730 74 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 20 |t icon handle.. | 00001740 20 20 20 20 20 20 3c 3d 0a 20 20 20 20 20 20 20 | <=. | 00001750 20 20 69 6e 74 20 6a 75 6e 6b 0a 20 20 20 20 20 | int junk. | 00001760 20 20 20 20 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d | .-----------| 00001770 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001790 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 |-------------..P| 000017a0 52 4f 43 73 68 65 6c 6c 5f 41 74 74 61 63 68 46 |ROCshell_AttachF| 000017b0 6f 6e 74 53 75 62 4d 65 6e 75 28 29 0a 50 61 72 |ontSubMenu().Par| 000017c0 61 6d 73 20 3d 3e 0a 20 20 20 20 20 20 20 20 20 |ams =>. | 000017d0 69 6e 74 20 69 74 65 6d 20 68 61 6e 64 6c 65 0a |int item handle.| 000017e0 20 20 20 20 20 20 20 20 20 73 74 72 20 66 75 6e | str fun| 000017f0 63 74 69 6f 6e 20 74 6f 20 63 61 6c 6c 20 77 68 |ction to call wh| 00001800 65 6e 20 6d 65 6e 75 5f 77 61 72 6e 69 6e 67 0a |en menu_warning.| 00001810 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 73 | mes| 00001820 73 61 67 65 20 69 73 20 72 65 63 65 69 76 65 64 |sage is received| 00001830 20 28 6f 70 74 69 6f 6e 61 6c 2c 20 6d 61 79 0a | (optional, may.| 00001840 20 20 20 20 20 20 20 20 20 20 20 20 20 62 65 20 | be | 00001850 22 22 29 0a 0a 54 68 69 73 20 72 6f 75 74 69 6e |"")..This routin| 00001860 65 20 77 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 |e will attempt t| 00001870 6f 20 6c 6f 61 64 20 74 68 65 20 6e 65 63 65 73 |o load the neces| 00001880 73 61 72 79 0a 27 46 6f 6e 74 4d 65 6e 75 27 20 |sary.'FontMenu' | 00001890 73 75 70 70 6f 72 74 20 6d 6f 64 75 6c 65 20 69 |support module i| 000018a0 66 20 69 74 20 69 73 20 6e 6f 74 20 61 6c 72 65 |f it is not alre| 000018b0 61 64 79 0a 6c 6f 61 64 65 64 2e 20 49 74 20 65 |ady.loaded. It e| 000018c0 78 70 65 63 74 73 20 74 6f 20 66 69 6e 64 20 69 |xpects to find i| 000018d0 74 20 69 6e 20 74 68 65 0a 45 76 6e 74 53 68 65 |t in the.EvntShe| 000018e0 6c 6c 53 79 73 74 65 6d 24 50 61 74 68 20 28 75 |llSystem$Path (u| 000018f0 73 75 61 6c 6c 79 20 69 6e 20 21 53 68 65 6c 6c |sually in !Shell| 00001900 53 79 73 29 2e 0a 0a 55 73 65 72 20 46 4e 20 28 |Sys)...User FN (| 00001910 50 52 4f 43 73 68 65 6c 6c 5f 41 74 74 61 63 68 |PROCshell_Attach| 00001920 46 6f 6e 74 53 75 62 4d 65 6e 75 29 20 0a 50 61 |FontSubMenu) .Pa| 00001930 72 61 6d 73 20 3d 3e 20 0a 20 20 20 20 20 20 20 |rams => . | 00001940 20 20 69 6e 74 20 77 69 6e 64 6f 77 20 68 61 6e | int window han| 00001950 64 6c 65 0a 20 20 20 20 20 20 20 20 20 69 6e 74 |dle. int| 00001960 20 69 63 6f 6e 20 68 61 6e 64 6c 65 0a 0a 20 20 | icon handle.. | 00001970 20 20 20 20 20 3c 3d 0a 20 20 20 20 20 20 20 20 | <=. | 00001980 20 69 6e 74 20 6a 75 6e 6b 0a 0a 54 68 69 73 20 | int junk..This | 00001990 66 75 6e 63 74 69 6f 6e 20 63 61 6e 20 62 65 20 |function can be | 000019a0 75 73 65 64 20 74 6f 20 73 65 74 20 74 68 65 20 |used to set the | 000019b0 63 75 72 72 65 6e 74 6c 79 0a 73 65 6c 65 63 74 |currently.select| 000019c0 65 64 20 66 6f 6e 74 20 69 6e 20 74 68 65 20 6d |ed font in the m| 000019d0 65 6e 75 20 61 62 6f 75 74 20 74 6f 20 62 65 20 |enu about to be | 000019e0 6f 70 65 6e 65 64 2e 0a 55 73 65 20 50 52 4f 43 |opened..Use PROC| 000019f0 73 68 65 6c 6c 5f 46 6f 6e 74 4d 65 6e 75 53 65 |shell_FontMenuSe| 00001a00 6c 65 63 74 46 6f 6e 74 20 74 6f 20 64 6f 20 74 |lectFont to do t| 00001a10 68 69 73 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |his...----------| 00001a20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001a40 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a |--------------..| 00001a50 50 52 4f 43 73 68 65 6c 6c 5f 4d 65 6e 75 57 72 |PROCshell_MenuWr| 00001a60 69 74 61 62 6c 65 28 29 0a 50 61 72 61 6d 73 20 |itable().Params | 00001a70 3d 3e 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 |=>. int | 00001a80 6d 65 6e 75 20 6f 72 20 6d 65 6e 75 20 69 74 65 |menu or menu ite| 00001a90 6d 20 68 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 |m handle. | 00001aa0 20 20 69 6e 74 20 73 74 61 74 65 0a 20 20 20 20 | int state. | 00001ab0 20 20 20 20 20 69 6e 74 20 73 69 7a 65 20 6f 66 | int size of| 00001ac0 20 69 6e 64 69 72 65 63 74 65 64 20 62 75 66 66 | indirected buff| 00001ad0 65 72 0a 20 20 20 20 20 20 20 20 20 73 74 72 20 |er. str | 00001ae0 76 61 6c 69 64 61 74 69 6f 6e 20 73 74 72 69 6e |validation strin| 00001af0 67 0a 0a 4d 61 6b 65 73 20 74 68 65 20 67 69 76 |g..Makes the giv| 00001b00 65 6e 20 6d 65 6e 75 20 69 74 65 6d 20 77 72 69 |en menu item wri| 00001b10 74 61 62 6c 65 20 6f 72 20 6e 6f 6e 20 77 72 69 |table or non wri| 00001b20 74 61 62 6c 65 0a 64 65 70 65 6e 64 69 6e 67 20 |table.depending | 00001b30 6f 6e 20 74 68 65 20 73 74 61 74 65 20 70 61 72 |on the state par| 00001b40 61 6d 65 74 65 72 2e 20 49 66 20 61 20 6d 65 6e |ameter. If a men| 00001b50 75 20 68 61 6e 64 6c 65 0a 69 73 20 67 69 76 65 |u handle.is give| 00001b60 6e 20 74 68 65 6e 20 61 6c 6c 20 69 74 65 6d 73 |n then all items| 00001b70 20 69 6e 20 74 68 65 20 6d 65 6e 75 20 61 72 65 | in the menu are| 00001b80 20 6d 61 64 65 0a 77 72 69 74 61 62 6c 65 20 6f | made.writable o| 00001b90 72 20 6e 6f 6e 20 77 72 69 74 61 62 6c 65 2e 0a |r non writable..| 00001ba0 0a 4d 65 6e 75 57 72 69 74 61 62 6c 65 20 53 74 |.MenuWritable St| 00001bb0 61 74 65 73 0a 54 68 65 20 73 74 61 74 65 20 69 |ates.The state i| 00001bc0 73 20 30 20 66 6f 72 20 6e 6f 6e 20 77 72 69 74 |s 0 for non writ| 00001bd0 61 62 6c 65 2c 20 6e 6f 6e 20 30 0a 66 6f 72 20 |able, non 0.for | 00001be0 77 72 69 74 61 62 6c 65 2e 0a 0a 2d 2d 2d 2d 2d |writable...-----| 00001bf0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001c20 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f 4d |---..PROCshell_M| 00001c30 65 6e 75 44 6f 74 74 65 64 28 29 0a 50 61 72 61 |enuDotted().Para| 00001c40 6d 73 20 3d 3e 0a 20 20 20 20 20 20 20 20 20 69 |ms =>. i| 00001c50 6e 74 20 6d 65 6e 75 20 6f 72 20 6d 65 6e 75 20 |nt menu or menu | 00001c60 69 74 65 6d 20 68 61 6e 64 6c 65 0a 20 20 20 20 |item handle. | 00001c70 20 20 20 20 20 69 6e 74 20 73 74 61 74 65 0a 0a | int state..| 00001c80 41 64 64 73 20 6f 72 20 72 65 6d 6f 76 65 73 20 |Adds or removes | 00001c90 61 20 64 6f 74 74 65 64 20 6c 69 6e 65 20 66 72 |a dotted line fr| 00001ca0 6f 6d 20 62 65 6c 6f 77 0a 74 68 65 20 67 69 76 |om below.the giv| 00001cb0 65 6e 20 6d 65 6e 75 20 69 74 65 6d 2e 20 49 66 |en menu item. If| 00001cc0 20 61 20 6d 65 6e 75 20 68 61 6e 64 6c 65 20 69 | a menu handle i| 00001cd0 73 0a 67 69 76 65 6e 20 69 6e 73 74 65 61 64 20 |s.given instead | 00001ce0 61 6c 6c 20 69 74 65 6d 73 20 69 6e 20 74 68 65 |all items in the| 00001cf0 20 6d 65 6e 75 20 61 72 65 0a 65 66 66 65 63 74 | menu are.effect| 00001d00 65 64 2e 0a 0a 4d 65 6e 75 44 6f 74 74 65 64 20 |ed...MenuDotted | 00001d10 53 74 61 74 65 73 0a 54 68 65 20 73 74 61 74 65 |States.The state| 00001d20 20 69 73 20 30 20 66 6f 72 20 6e 6f 6e 20 77 72 | is 0 for non wr| 00001d30 69 74 61 62 6c 65 2c 20 6e 6f 6e 20 30 0a 66 6f |itable, non 0.fo| 00001d40 72 20 77 72 69 74 61 62 6c 65 2e 0a 0a 2d 2d 2d |r writable...---| 00001d50 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001d80 2d 2d 2d 2d 2d 0a 0a 46 4e 73 68 65 6c 6c 5f 4d |-----..FNshell_M| 00001d90 65 6e 75 4e 65 77 28 29 0a 50 61 72 61 6d 73 20 |enuNew().Params | 00001da0 3d 3e 0a 20 20 20 20 20 20 20 20 20 73 74 72 20 |=>. str | 00001db0 6d 65 6e 75 20 74 69 74 6c 65 0a 0a 20 20 20 20 |menu title.. | 00001dc0 20 20 20 3c 3d 0a 20 20 20 20 20 20 20 20 20 69 | <=. i| 00001dd0 6e 74 20 6d 65 6e 75 20 68 61 6e 64 6c 65 0a 20 |nt menu handle. | 00001de0 20 20 20 20 20 20 20 20 0a 43 72 65 61 74 65 73 | .Creates| 00001df0 20 61 20 6e 65 77 20 6d 65 6e 75 20 77 69 74 68 | a new menu with| 00001e00 20 74 68 65 20 67 69 76 65 6e 20 74 69 74 6c 65 | the given title| 00001e10 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |...-------------| 00001e20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00001e40 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 46 4e 73 |-----------..FNs| 00001e50 68 65 6c 6c 5f 4d 65 6e 75 41 64 64 28 29 0a 50 |hell_MenuAdd().P| 00001e60 61 72 61 6d 73 20 3d 3e 0a 20 20 20 20 20 20 20 |arams =>. | 00001e70 20 20 69 6e 74 20 6d 65 6e 75 20 6f 72 20 6d 65 | int menu or me| 00001e80 6e 75 20 69 74 65 6d 20 68 61 6e 64 6c 65 0a 20 |nu item handle. | 00001e90 20 20 20 20 20 20 20 20 73 74 72 20 74 65 78 74 | str text| 00001ea0 20 66 6f 72 20 6d 65 6e 75 20 69 74 65 6d 0a 20 | for menu item. | 00001eb0 20 20 20 20 20 20 20 20 73 74 72 20 66 6e 20 74 | str fn t| 00001ec0 6f 20 63 61 6c 6c 20 77 68 65 6e 20 69 74 65 6d |o call when item| 00001ed0 20 69 73 20 73 65 6c 65 63 74 65 64 0a 0a 20 20 | is selected.. | 00001ee0 20 20 20 20 20 3c 3d 0a 20 20 20 20 20 20 20 20 | <=. | 00001ef0 20 69 6e 74 20 6d 65 6e 75 20 69 74 65 6d 20 68 | int menu item h| 00001f00 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 20 20 0a |andle. .| 00001f10 41 64 64 73 20 61 20 6e 65 77 20 69 74 65 6d 20 |Adds a new item | 00001f20 74 6f 20 61 6e 20 65 78 69 73 74 69 6e 67 20 6d |to an existing m| 00001f30 65 6e 75 2e 20 49 66 20 61 20 6d 65 6e 75 0a 68 |enu. If a menu.h| 00001f40 61 6e 64 6c 65 20 69 73 20 67 69 76 65 6e 20 74 |andle is given t| 00001f50 68 65 6e 20 74 68 65 20 6e 65 77 20 69 74 65 6d |hen the new item| 00001f60 20 69 73 20 61 64 64 65 64 20 74 6f 0a 74 68 65 | is added to.the| 00001f70 20 65 6e 64 20 6f 66 20 74 68 65 20 6d 65 6e 75 | end of the menu| 00001f80 2c 20 69 66 20 61 6e 20 69 74 65 6d 20 68 61 6e |, if an item han| 00001f90 64 6c 65 20 69 73 20 67 69 76 65 6e 0a 74 68 65 |dle is given.the| 00001fa0 20 6e 65 77 20 69 74 65 6d 20 69 73 20 61 64 64 | new item is add| 00001fb0 65 64 20 62 65 66 6f 72 65 20 74 68 65 20 65 78 |ed before the ex| 00001fc0 69 73 74 69 6e 67 20 69 74 65 6d 2e 0a 0a 55 73 |isting item...Us| 00001fd0 65 72 20 46 4e 20 28 46 4e 73 68 65 6c 6c 5f 4d |er FN (FNshell_M| 00001fe0 65 6e 75 41 64 64 29 0a 50 61 72 61 6d 73 20 3d |enuAdd).Params =| 00001ff0 3e 20 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 |> . int | 00002000 6d 65 6e 75 20 64 65 63 6f 64 65 20 62 6c 6f 63 |menu decode bloc| 00002010 6b 0a 0a 4d 65 6e 75 20 64 65 63 6f 64 65 20 62 |k..Menu decode b| 00002020 6c 6f 63 6b 0a 62 6c 6b 2b 30 30 20 70 6f 73 69 |lock.blk+00 posi| 00002030 74 69 6f 6e 20 6f 66 20 73 65 6c 65 63 74 65 64 |tion of selected| 00002040 20 6d 65 6e 75 20 69 74 65 6d 20 69 6e 20 6d 65 | menu item in me| 00002050 6e 75 0a 20 20 20 20 20 20 20 28 73 74 61 72 74 |nu. (start| 00002060 69 6e 67 20 66 72 6f 6d 20 30 29 0a 62 6c 6b 2b |ing from 0).blk+| 00002070 30 34 20 70 6f 69 6e 74 65 72 20 74 6f 20 73 65 |04 pointer to se| 00002080 6c 65 63 74 65 64 20 69 74 65 6d 20 64 61 74 61 |lected item data| 00002090 0a 62 6c 6b 2b 30 38 20 73 65 6c 65 63 74 65 64 |.blk+08 selected| 000020a0 20 69 74 65 6d 20 68 61 6e 64 6c 65 20 6f 72 20 | item handle or | 000020b0 7a 65 72 6f 20 69 66 20 69 74 65 6d 0a 20 20 20 |zero if item. | 000020c0 20 20 20 20 77 61 73 20 63 72 65 61 74 65 64 20 | was created | 000020d0 77 69 74 68 6f 75 74 20 4d 65 6e 75 55 74 69 6c |without MenuUtil| 000020e0 73 0a 62 6c 6b 2b 31 32 20 70 6f 69 6e 74 65 72 |s.blk+12 pointer| 000020f0 20 74 6f 20 74 65 78 74 20 73 74 72 69 6e 67 20 | to text string | 00002100 6f 66 20 73 65 6c 65 63 74 65 64 20 69 74 65 6d |of selected item| 00002110 0a 62 6c 6b 2b 31 36 20 70 6f 73 69 74 69 6f 6e |.blk+16 position| 00002120 20 6f 66 20 70 61 72 65 6e 74 20 6d 65 6e 75 20 | of parent menu | 00002130 69 74 65 6d 20 69 6e 20 6d 65 6e 75 0a 20 20 20 |item in menu. | 00002140 20 20 20 20 28 73 74 61 72 74 69 6e 67 20 66 72 | (starting fr| 00002150 6f 6d 20 30 29 0a 62 6c 6b 2b 32 30 20 70 6f 69 |om 0).blk+20 poi| 00002160 6e 74 65 72 20 74 6f 20 70 61 72 65 6e 74 20 69 |nter to parent i| 00002170 74 65 6d 20 64 61 74 61 0a 62 6c 6b 2b 32 34 20 |tem data.blk+24 | 00002180 70 61 72 65 6e 74 20 69 74 65 6d 20 68 61 6e 64 |parent item hand| 00002190 6c 65 20 6f 72 20 7a 65 72 6f 20 69 66 20 69 74 |le or zero if it| 000021a0 65 6d 20 77 61 73 0a 20 20 20 20 20 20 20 63 72 |em was. cr| 000021b0 65 61 74 65 64 20 77 69 74 68 6f 75 74 20 4d 65 |eated without Me| 000021c0 6e 75 55 74 69 6c 73 0a 62 6c 6b 2b 32 38 20 70 |nuUtils.blk+28 p| 000021d0 6f 69 6e 74 65 72 20 74 6f 20 74 65 78 74 20 73 |ointer to text s| 000021e0 74 72 69 6e 67 20 6f 66 20 70 61 72 65 6e 74 20 |tring of parent | 000021f0 69 74 65 6d 20 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d |item ..---------| 00002200 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002220 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a |---------------.| 00002230 0a 46 4e 73 68 65 6c 6c 5f 4d 65 6e 75 54 69 63 |.FNshell_MenuTic| 00002240 6b 4f 6e 6c 79 31 28 29 0a 50 61 72 61 6d 73 20 |kOnly1().Params | 00002250 3d 3e 0a 20 20 20 20 20 20 20 20 20 69 6e 74 20 |=>. int | 00002260 6d 65 6e 75 20 68 61 6e 64 6c 65 0a 20 20 20 20 |menu handle. | 00002270 20 20 20 20 20 69 6e 74 20 70 6f 73 69 74 69 6f | int positio| 00002280 6e 20 6f 66 20 69 74 65 6d 20 69 6e 20 6d 65 6e |n of item in men| 00002290 75 0a 0a 54 69 63 6b 73 20 6f 6e 6c 79 20 74 68 |u..Ticks only th| 000022a0 65 20 69 74 65 6d 20 67 69 76 65 6e 20 62 79 20 |e item given by | 000022b0 74 68 65 20 6d 65 6e 75 20 68 61 6e 64 6c 65 0a |the menu handle.| 000022c0 61 6e 64 20 74 68 65 20 70 6f 73 69 74 69 6f 6e |and the position| 000022d0 20 6f 66 20 74 68 65 20 69 74 65 6d 2e 20 54 68 | of the item. Th| 000022e0 69 73 20 63 61 6c 6c 20 69 73 0a 70 72 6f 76 69 |is call is.provi| 000022f0 64 65 64 20 66 6f 72 20 77 68 65 6e 20 79 6f 75 |ded for when you| 00002300 20 64 6f 6e 27 74 20 6b 6e 6f 77 20 74 68 65 20 | don't know the | 00002310 68 61 6e 64 6c 65 0a 6f 66 20 74 68 65 20 6d 65 |handle.of the me| 00002320 6e 75 20 69 74 65 6d 2e 0a 0a 53 65 65 20 61 6c |nu item...See al| 00002330 73 6f 20 50 52 4f 43 73 68 65 6c 6c 5f 4d 65 6e |so PROCshell_Men| 00002340 75 54 69 63 6b 4f 6e 6c 79 32 0a 0a 2d 2d 2d 2d |uTickOnly2..----| 00002350 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002380 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 6c 6c 5f |----..PROCshell_| 00002390 4d 65 6e 75 54 69 63 6b 4f 6e 6c 79 32 28 29 0a |MenuTickOnly2().| 000023a0 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 20 20 20 |Params =>. | 000023b0 20 20 20 69 6e 74 20 6d 65 6e 75 20 69 74 65 6d | int menu item| 000023c0 20 68 61 6e 64 6c 65 0a 0a 54 69 63 6b 73 20 6f | handle..Ticks o| 000023d0 6e 6c 79 20 74 68 65 20 69 74 65 6d 20 67 69 76 |nly the item giv| 000023e0 65 6e 20 62 79 20 74 68 65 20 6d 65 6e 75 20 69 |en by the menu i| 000023f0 74 65 6d 0a 68 61 6e 64 6c 65 2e 0a 0a 53 65 65 |tem.handle...See| 00002400 20 61 6c 73 6f 20 50 52 4f 43 73 68 65 6c 6c 5f | also PROCshell_| 00002410 4d 65 6e 75 54 69 63 6b 4f 6e 6c 79 31 0a 0a 2d |MenuTickOnly1..-| 00002420 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002450 2d 2d 2d 2d 2d 2d 2d 0a 0a 50 52 4f 43 73 68 65 |-------..PROCshe| 00002460 6c 6c 5f 4d 65 6e 75 43 6f 6c 6f 75 72 73 28 29 |ll_MenuColours()| 00002470 0a 50 61 72 61 6d 73 20 3d 3e 0a 20 20 20 20 20 |.Params =>. | 00002480 20 20 20 20 69 6e 74 20 6d 65 6e 75 20 69 74 65 | int menu ite| 00002490 6d 20 68 61 6e 64 6c 65 0a 20 20 20 20 20 20 20 |m handle. | 000024a0 20 20 69 6e 74 20 66 6f 72 65 67 72 6f 75 6e 64 | int foreground| 000024b0 20 63 6f 6c 6f 75 72 0a 20 20 20 20 20 20 20 20 | colour. | 000024c0 20 69 6e 74 20 62 61 63 6b 67 72 6f 75 6e 64 20 | int background | 000024d0 63 6f 6c 6f 75 72 0a 0a 53 65 74 73 20 74 68 65 |colour..Sets the| 000024e0 20 66 6f 72 65 67 72 6f 75 6e 64 20 61 6e 64 20 | foreground and | 000024f0 62 61 63 6b 67 72 6f 75 6e 64 20 63 6f 6c 6f 75 |background colou| 00002500 72 73 0a 6f 66 20 74 68 65 20 69 74 65 6d 20 67 |rs.of the item g| 00002510 69 76 65 6e 2e 0a 0a 2d 2d 2d 2d 2d 2d 2d 2d 2d |iven...---------| 00002520 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| * 00002540 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |---------------| 0000254f