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