Home » Archimedes archive » Acorn Computing » 1994 08 subscription disc.adf » 9408s » Shareware/Event/Documents/!EShellDoc/!RunImage/Chapter1/Text

Shareware/Event/Documents/!EShellDoc/!RunImage/Chapter1/Text

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/!RunImage/Chapter1/Text
Read OK:
File size: 2250 bytes
Load address: 0000
Exec address: 0000
File contents
� �
�PB"�7A�������5��
�
Introduction�

�	�	P�$B��'3��h7�
	�	$|�M����� "�A �Shell� program is a starting point for developing your own applications that run under the RISC-|| T�w������ "�OS wimp system. The EvntShell library contains code to handle most of the �Events� (i.e. opening a |�H;g?��Gn�� "�menu, closing a window etc) that can occur, and all your application has to do is inform the library �|�R'��6�� "�what it should do when certain events occur. For example a menu can be attached to a window or to ||�S������ "�an icon - the library will open the menu for you (in the correct position!) when the <MENU> button |%4B|�������� "�on the mouse is used.   
4%Bg^��G��� "�
t)'&��U�� "�PROCshell_AttachModeChangeHandler is another very simple example which calls a function in t�K����� "�the �User Application� (this is the bit you write, starting with a �Shell� created by the AppBuild tool �x4U������ "�or by modifying one of the examples) when the screen mode changes. A more complicated example xt�#g}��G��� "�is PROCshell_AttachPane which allows the attachment of pane windows to a parent window. All t|X'E��t�� "�opening and closing of windows and panes is handled totally by the library code.   Normally writing |t������;�� "�a wimp application is a very complex business, involving much reading of the Programmers txh3������ "�Reference Manuals, magazine articles and examining other applications. The aim of the EvntShell x|\�g���G�� "�library is to reduce the need for this and to enable the speedy creation of easily maintained and |%0B,o'd����� "�robust applications.
0%B�+���Z�� "�
xh���"�� "�In order to use the library it is necessary to have a reasonable understanding of how to use an xt�g���G� "�Archimedes and the programs supplied with it. Some experience in BASIC is also of course t|-'������ "�required. This manual does not cover how to use tools like the Template  editor which has its own |%pB�9�J���y�� "�instructions and may not have been supplied with your copy of the EvntShell library.
p%(Fz�����A�� "�ibrz�
(x�g��G	�� "�Documentation on the various library routines should have been supplied as text files and as x%TB�,'����� "�StrongHlp format files on the disk containing the library.
T%B�i��ǘ�� "�
|P�1���`�� "�A list of features of the EvntShell library follows. On reading this again I seem to have used the |�`Dg���G(�� "�word 'automatically' rather a lot, but this describes perfectly the whole point of the system. It is, for �|��'���� "�example, necessary to set one 'bit' of a flag word in the window definition to ensure that redraw ||���Ƿ�� "�requests are sent to your application, but attaching a redraw handler to the window performs this |%hBD��P����� "�task for you which is one less thing to go wrong when writing a wimp program! 
h�(Bg��GG�� "�
o�
�
(��̾'��� "��
�.( �
�
 �
j �
�
��L/Resources (i.e. templates, menus, messages and user sprites) are loaded �%hF������� "�and loa�initialised automatically with a call to shell_ResourcesInit 
h�����o������ "�ces�.h �
�
 �
jL/ �
�
Menus may be attached to window/icon pairs, or to the whole workarea �%<B��g7��Gf�� "�of a window with shell_AttachMenu. 
<����'���.�� "�tac�.< �
�
 �
j �
�
L/A �Menu Warning� routine can also be registered which will be called �X�������� "�when then pointer moves over a submenu arrow, which means that X%LB ��������� "�dialog boxes are created dynamically as required 
L��82gV��G��� "�equ�.L �
�
 �
j �
�
L/Menus are automatically opened in the correct locations and the �X�'��M�� "�ADJUST button causes the menu to be re-opened as per RISC-OS X%$Bl������� "�guidelines 
$��
��X��X�և� "��
�./ �
�
 �
jbe �
�
sheL/A routine can be set up with shell_AttachMenuMaker to shade, tick or �%PB�� �O� "�otherwise alter menu items before the menu is opened 
P����v��V� "� op�.P �
�
 �
j �
�
L/<RETURN>, <Cursor Up> and <Cursor Down> keypresses move caret �X��6���� "�between writeable icons automatically and a <RETURN> keypress X%XB�O�w�֦� "�when the caret is in the last writeable icon activates icon 0 
X��,��?�n� "�s i�.X �
�
 �
j �
�
L/�HotKey� keypresses are handled by a general keypress routine set up �\�v�V6� "�with shell_AttachHotKeys. Keypress not handled by this routine are \L�6���� "�automatically passed on to other applications with L%,BD������� "�Wimp_ProcessKey� 
,����^��� "�ces�., �
�
 �
j �
�
L/Drag loading of a file handled automatically (give type of file, returns �X��v&�VU� "�address of loaded file). RAM buffers used where possible (inter-X%4BT�6��� "�application data transfer) 
4��4������� "�tra�.4 �
�
 �
j �
�
L/Drag saving of files handled automatically using RAM transfer where  �%$B`��}��� "�possible 
$����vE�Vt� "�oss�.$ �
�
 �
jL/ �
�
Interface module supported (button clicks automatically result in icons �\P6
�<� "�slabbing� as appropriate) Pointers may be attached to window work \%4Bp����� "�areas using Interface SWIs 
4��t������ "�fac�.4 �
�
 �
j �
�
L/Interactive help provided by attaching tags in icon validation strings �`��vd�V�� "�and looking up tag in message file. This allows easy editing of the  `\��6,�[� "�message resource file for other languages. (the MsgTrans module is \`�����"� "�used for this). Message Tags can also be attached to any window/icon ``t����� "�combination and the help text will be looked up and sent to the Help `%(B��v��V�� "�application. 
(���N6K�z� "�cat�.( �
�
 �
j �
�
L/All routines in the Shell Library are prefixed with �shell� to avoid �`�&���A� "�clashes with routine names in the user�s program. Global variables are `%8B�.���	� "�kept to an absolute minimum 
8��d�v��V�� "�ini�.8 �
�
 �
j �
�
L/Memory is claimed and released as required from the next wimpslot. �%\B�6j��� "�The  user does not need to know where the files & data are loaded.
\��Ċ�1��`� "�e l�.\ �
�
 �
j �
�
L/The Shell Library includes debugging code which writes a TraceFile �dD>���(� "�into the application directory which can be loaded into !Edit, !DeskEdit d`�.v��V�� "�etc for viewing. A compressed �runtime� library is also supplied which `%PB�6���� "�has had the debugging routines removed to save space 
P��F�k�P��� "�e s�.P �
�
 �
j �
�
L/Panes are handled by registering a function with shell_AttachPane 
����D��G� "�tac�.� �
�
 �
j �
�
L/Handling of draggable icons is automatic - it is only necessary to  �%XB�v��V� "�register a routine to handle what happens when the drag ends. 
X��LH6���� "�ag �.X �
�
 �
j �
�
L/Event handlers can be registered for all message events, i.e mode �% Bx��o�֞� "�change.
 ��F<V�7�f� "�"�.  �
�
 �
j �
�
L/Multiple files may be loaded into resizeable buffers. b�

�yV4��f�	�hB�>��1<��)�fff�	f�	Introductionn�	fff
hyV4�Df�	�hB�>��<��)�fff�	f�	Introductionn�	fff
hyV4
00000000  f0 20 00 00 03 00 00 00  00 00 00 00 06 08 00 00  |. ..............|
00000010  00 08 00 00 01 10 00 00  00 00 00 00 00 00 00 00  |................|
00000020  00 10 00 00 02 18 00 00  10 01 00 00 00 00 00 00  |................|
00000030  01 e4 0d 00 00 00 00 00  00 18 00 00 a5 50 00 00  |.............P..|
00000040  42 22 9a 01 37 41 fe ff  87 87 fe ff dc 35 00 f2  |B"..7A.......5..|
00000050  07 00 00 00 01 e4 0d 00  01 e4 0d 00 00 00 00 00  |................|
00000060  49 6e 74 72 6f 64 75 63  74 69 6f 6e 08 05 05 05  |Introduction....|
00000070  01 e4 0d 00 00 00 00 00  0d 07 00 00 02 af 09 00  |................|
00000080  02 af 09 00 00 00 00 00  00 50 00 00 a5 24 00 00  |.........P...$..|
00000090  42 00 00 00 d7 ec fd ff  27 33 fe ff 68 37 00 f2  |B.......'3..h7..|
000000a0  0d 08 09 00 02 af 09 00  00 00 00 00 00 24 00 00  |.............$..|
000000b0  05 7c 00 00 00 9c 4d 07  e7 af fd ff c7 de fd ff  |.|....M.........|
000000c0  20 22 00 f2 41 20 90 53  68 65 6c 6c 91 20 70 72  | "..A .Shell. pr|
000000d0  6f 67 72 61 6d 20 69 73  20 61 20 73 74 61 72 74  |ogram is a start|
000000e0  69 6e 67 20 70 6f 69 6e  74 20 66 6f 72 20 64 65  |ing point for de|
000000f0  76 65 6c 6f 70 69 6e 67  20 79 6f 75 72 20 6f 77  |veloping your ow|
00000100  6e 20 61 70 70 6c 69 63  61 74 69 6f 6e 73 20 74  |n applications t|
00000110  68 61 74 20 72 75 6e 20  75 6e 64 65 72 20 74 68  |hat run under th|
00000120  65 20 52 49 53 43 2d 00  00 7c 00 00 05 7c 00 00  |e RISC-..|...|..|
00000130  00 20 54 07 a7 77 fd ff  87 a6 fd ff 20 22 00 f0  |. T..w...... "..|
00000140  4f 53 20 77 69 6d 70 20  73 79 73 74 65 6d 2e 20  |OS wimp system. |
00000150  54 68 65 20 45 76 6e 74  53 68 65 6c 6c 20 6c 69  |The EvntShell li|
00000160  62 72 61 72 79 20 63 6f  6e 74 61 69 6e 73 20 63  |brary contains c|
00000170  6f 64 65 20 74 6f 20 68  61 6e 64 6c 65 20 6d 6f  |ode to handle mo|
00000180  73 74 20 6f 66 20 74 68  65 20 90 45 76 65 6e 74  |st of the .Event|
00000190  73 91 20 28 69 2e 65 2e  20 6f 70 65 6e 69 6e 67  |s. (i.e. opening|
000001a0  20 61 20 00 00 7c 00 00  05 80 00 00 00 48 3b 07  | a ..|.......H;.|
000001b0  67 3f fd ff 47 6e fd ff  20 22 00 f0 6d 65 6e 75  |g?..Gn.. "..menu|
000001c0  2c 20 63 6c 6f 73 69 6e  67 20 61 20 77 69 6e 64  |, closing a wind|
000001d0  6f 77 20 65 74 63 29 20  74 68 61 74 20 63 61 6e  |ow etc) that can|
000001e0  20 6f 63 63 75 72 2c 20  61 6e 64 20 61 6c 6c 20  | occur, and all |
000001f0  79 6f 75 72 20 61 70 70  6c 69 63 61 74 69 6f 6e  |your application|
00000200  20 68 61 73 20 74 6f 20  64 6f 20 69 73 20 69 6e  | has to do is in|
00000210  66 6f 72 6d 20 74 68 65  20 6c 69 62 72 61 72 79  |form the library|
00000220  20 00 00 00 00 80 00 00  05 7c 00 00 00 a0 52 07  | ........|....R.|
00000230  27 07 fd ff 07 36 fd ff  20 22 00 f0 77 68 61 74  |'....6.. "..what|
00000240  20 69 74 20 73 68 6f 75  6c 64 20 64 6f 20 77 68  | it should do wh|
00000250  65 6e 20 63 65 72 74 61  69 6e 20 65 76 65 6e 74  |en certain event|
00000260  73 20 6f 63 63 75 72 2e  20 46 6f 72 20 65 78 61  |s occur. For exa|
00000270  6d 70 6c 65 20 61 20 6d  65 6e 75 20 63 61 6e 20  |mple a menu can |
00000280  62 65 20 61 74 74 61 63  68 65 64 20 74 6f 20 61  |be attached to a|
00000290  20 77 69 6e 64 6f 77 20  6f 72 20 74 6f 20 00 00  | window or to ..|
000002a0  00 7c 00 00 05 7c 00 00  00 84 53 07 e7 ce fc ff  |.|...|....S.....|
000002b0  c7 fd fc ff 20 22 00 f0  61 6e 20 69 63 6f 6e 20  |.... "..an icon |
000002c0  2d 20 74 68 65 20 6c 69  62 72 61 72 79 20 77 69  |- the library wi|
000002d0  6c 6c 20 6f 70 65 6e 20  74 68 65 20 6d 65 6e 75  |ll open the menu|
000002e0  20 66 6f 72 20 79 6f 75  20 28 69 6e 20 74 68 65  | for you (in the|
000002f0  20 63 6f 72 72 65 63 74  20 70 6f 73 69 74 69 6f  | correct positio|
00000300  6e 21 29 20 77 68 65 6e  20 74 68 65 20 3c 4d 45  |n!) when the <ME|
00000310  4e 55 3e 20 62 75 74 74  6f 6e 20 00 00 7c 00 00  |NU> button ..|..|
00000320  25 34 00 00 42 7c b5 01  a7 96 fc ff 87 c5 fc ff  |%4..B|..........|
00000330  20 22 00 f0 6f 6e 20 74  68 65 20 6d 6f 75 73 65  | "..on the mouse|
00000340  20 69 73 20 75 73 65 64  2e 20 20 20 0d 00 00 00  | is used.   ....|
00000350  00 34 00 00 25 1c 00 00  42 00 00 00 67 5e fc ff  |.4..%...B...g^..|
00000360  47 8d fc ff 20 22 00 f2  0d 00 00 00 00 1c 00 00  |G... "..........|
00000370  05 74 00 00 00 18 29 07  27 26 fc ff 07 55 fc ff  |.t....).'&...U..|
00000380  20 22 00 f2 50 52 4f 43  73 68 65 6c 6c 5f 41 74  | "..PROCshell_At|
00000390  74 61 63 68 4d 6f 64 65  43 68 61 6e 67 65 48 61  |tachModeChangeHa|
000003a0  6e 64 6c 65 72 20 69 73  20 61 6e 6f 74 68 65 72  |ndler is another|
000003b0  20 76 65 72 79 20 73 69  6d 70 6c 65 20 65 78 61  | very simple exa|
000003c0  6d 70 6c 65 20 77 68 69  63 68 20 63 61 6c 6c 73  |mple which calls|
000003d0  20 61 20 66 75 6e 63 74  69 6f 6e 20 69 6e 20 00  | a function in .|
000003e0  00 74 00 00 05 80 00 00  00 08 4b 07 e7 ed fb ff  |.t........K.....|
000003f0  c7 1c fc ff 20 22 00 f0  74 68 65 20 90 55 73 65  |.... "..the .Use|
00000400  72 20 41 70 70 6c 69 63  61 74 69 6f 6e 91 20 28  |r Application. (|
00000410  74 68 69 73 20 69 73 20  74 68 65 20 62 69 74 20  |this is the bit |
00000420  79 6f 75 20 77 72 69 74  65 2c 20 73 74 61 72 74  |you write, start|
00000430  69 6e 67 20 77 69 74 68  20 61 20 90 53 68 65 6c  |ing with a .Shel|
00000440  6c 91 20 63 72 65 61 74  65 64 20 62 79 20 74 68  |l. created by th|
00000450  65 20 41 70 70 42 75 69  6c 64 20 74 6f 6f 6c 20  |e AppBuild tool |
00000460  00 80 00 00 05 78 00 00  00 34 55 07 a7 b5 fb ff  |.....x...4U.....|
00000470  87 e4 fb ff 20 22 00 f0  6f 72 20 62 79 20 6d 6f  |.... "..or by mo|
00000480  64 69 66 79 69 6e 67 20  6f 6e 65 20 6f 66 20 74  |difying one of t|
00000490  68 65 20 65 78 61 6d 70  6c 65 73 29 20 77 68 65  |he examples) whe|
000004a0  6e 20 74 68 65 20 73 63  72 65 65 6e 20 6d 6f 64  |n the screen mod|
000004b0  65 20 63 68 61 6e 67 65  73 2e 20 41 20 6d 6f 72  |e changes. A mor|
000004c0  65 20 63 6f 6d 70 6c 69  63 61 74 65 64 20 65 78  |e complicated ex|
000004d0  61 6d 70 6c 65 20 00 00  00 78 00 00 05 74 00 00  |ample ...x...t..|
000004e0  00 f0 23 07 67 7d fb ff  47 ac fb ff 20 22 00 f0  |..#.g}..G... "..|
000004f0  69 73 20 50 52 4f 43 73  68 65 6c 6c 5f 41 74 74  |is PROCshell_Att|
00000500  61 63 68 50 61 6e 65 20  77 68 69 63 68 20 61 6c  |achPane which al|
00000510  6c 6f 77 73 20 74 68 65  20 61 74 74 61 63 68 6d  |lows the attachm|
00000520  65 6e 74 20 6f 66 20 70  61 6e 65 20 77 69 6e 64  |ent of pane wind|
00000530  6f 77 73 20 74 6f 20 61  20 70 61 72 65 6e 74 20  |ows to a parent |
00000540  77 69 6e 64 6f 77 2e 20  41 6c 6c 20 00 74 00 00  |window. All .t..|
00000550  05 7c 00 00 00 04 58 07  27 45 fb ff 07 74 fb ff  |.|....X.'E...t..|
00000560  20 22 00 f0 6f 70 65 6e  69 6e 67 20 61 6e 64 20  | "..opening and |
00000570  63 6c 6f 73 69 6e 67 20  6f 66 20 77 69 6e 64 6f  |closing of windo|
00000580  77 73 20 61 6e 64 20 70  61 6e 65 73 20 69 73 20  |ws and panes is |
00000590  68 61 6e 64 6c 65 64 20  74 6f 74 61 6c 6c 79 20  |handled totally |
000005a0  62 79 20 74 68 65 20 6c  69 62 72 61 72 79 20 63  |by the library c|
000005b0  6f 64 65 2e 20 20 20 4e  6f 72 6d 61 6c 6c 79 20  |ode.   Normally |
000005c0  77 72 69 74 69 6e 67 20  00 7c 00 00 05 74 00 00  |writing .|...t..|
000005d0  00 fc c0 06 e7 0c fb ff  c7 3b fb ff 20 22 00 f0  |.........;.. "..|
000005e0  61 20 77 69 6d 70 20 61  70 70 6c 69 63 61 74 69  |a wimp applicati|
000005f0  6f 6e 20 69 73 20 61 20  76 65 72 79 20 63 6f 6d  |on is a very com|
00000600  70 6c 65 78 20 62 75 73  69 6e 65 73 73 2c 20 69  |plex business, i|
00000610  6e 76 6f 6c 76 69 6e 67  20 6d 75 63 68 20 72 65  |nvolving much re|
00000620  61 64 69 6e 67 20 6f 66  20 74 68 65 20 50 72 6f  |ading of the Pro|
00000630  67 72 61 6d 6d 65 72 73  20 00 00 00 00 74 00 00  |grammers ....t..|
00000640  05 78 00 00 00 68 33 07  a7 d4 fa ff 87 03 fb ff  |.x...h3.........|
00000650  20 22 00 f0 52 65 66 65  72 65 6e 63 65 20 4d 61  | "..Reference Ma|
00000660  6e 75 61 6c 73 2c 20 6d  61 67 61 7a 69 6e 65 20  |nuals, magazine |
00000670  61 72 74 69 63 6c 65 73  20 61 6e 64 20 65 78 61  |articles and exa|
00000680  6d 69 6e 69 6e 67 20 6f  74 68 65 72 20 61 70 70  |mining other app|
00000690  6c 69 63 61 74 69 6f 6e  73 2e 20 54 68 65 20 61  |lications. The a|
000006a0  69 6d 20 6f 66 20 74 68  65 20 45 76 6e 74 53 68  |im of the EvntSh|
000006b0  65 6c 6c 20 00 78 00 00  05 7c 00 00 00 5c ee 06  |ell .x...|...\..|
000006c0  67 9c fa ff 47 cb fa ff  20 22 00 f0 6c 69 62 72  |g...G... "..libr|
000006d0  61 72 79 20 69 73 20 74  6f 20 72 65 64 75 63 65  |ary is to reduce|
000006e0  20 74 68 65 20 6e 65 65  64 20 66 6f 72 20 74 68  | the need for th|
000006f0  69 73 20 61 6e 64 20 74  6f 20 65 6e 61 62 6c 65  |is and to enable|
00000700  20 74 68 65 20 73 70 65  65 64 79 20 63 72 65 61  | the speedy crea|
00000710  74 69 6f 6e 20 6f 66 20  65 61 73 69 6c 79 20 6d  |tion of easily m|
00000720  61 69 6e 74 61 69 6e 65  64 20 61 6e 64 20 00 00  |aintained and ..|
00000730  00 7c 00 00 25 30 00 00  42 2c 6f 01 27 64 fa ff  |.|..%0..B,o.'d..|
00000740  07 93 fa ff 20 22 00 f0  72 6f 62 75 73 74 20 61  |.... "..robust a|
00000750  70 70 6c 69 63 61 74 69  6f 6e 73 2e 0d 00 00 00  |pplications.....|
00000760  00 30 00 00 25 1c 00 00  42 00 00 00 e7 2b fa ff  |.0..%...B....+..|
00000770  c7 5a fa ff 20 22 00 f2  0d 00 00 00 00 1c 00 00  |.Z.. "..........|
00000780  05 78 00 00 00 68 d0 06  a7 f3 f9 ff 87 22 fa ff  |.x...h......."..|
00000790  20 22 00 f2 49 6e 20 6f  72 64 65 72 20 74 6f 20  | "..In order to |
000007a0  75 73 65 20 74 68 65 20  6c 69 62 72 61 72 79 20  |use the library |
000007b0  69 74 20 69 73 20 6e 65  63 65 73 73 61 72 79 20  |it is necessary |
000007c0  74 6f 20 68 61 76 65 20  61 20 72 65 61 73 6f 6e  |to have a reason|
000007d0  61 62 6c 65 20 75 6e 64  65 72 73 74 61 6e 64 69  |able understandi|
000007e0  6e 67 20 6f 66 20 68 6f  77 20 74 6f 20 75 73 65  |ng of how to use|
000007f0  20 61 6e 20 00 78 00 00  05 74 00 00 00 0c bd 06  | an .x...t......|
00000800  67 bb f9 ff 47 ea f9 ff  20 22 00 f0 41 72 63 68  |g...G... "..Arch|
00000810  69 6d 65 64 65 73 20 61  6e 64 20 74 68 65 20 70  |imedes and the p|
00000820  72 6f 67 72 61 6d 73 20  73 75 70 70 6c 69 65 64  |rograms supplied|
00000830  20 77 69 74 68 20 69 74  2e 20 53 6f 6d 65 20 65  | with it. Some e|
00000840  78 70 65 72 69 65 6e 63  65 20 69 6e 20 42 41 53  |xperience in BAS|
00000850  49 43 20 69 73 20 61 6c  73 6f 20 6f 66 20 63 6f  |IC is also of co|
00000860  75 72 73 65 20 00 00 00  00 74 00 00 05 7c 00 00  |urse ....t...|..|
00000870  00 08 2d 07 27 83 f9 ff  07 b2 f9 ff 20 22 00 f0  |..-.'....... "..|
00000880  72 65 71 75 69 72 65 64  2e 20 54 68 69 73 20 6d  |required. This m|
00000890  61 6e 75 61 6c 20 64 6f  65 73 20 6e 6f 74 20 63  |anual does not c|
000008a0  6f 76 65 72 20 68 6f 77  20 74 6f 20 75 73 65 20  |over how to use |
000008b0  74 6f 6f 6c 73 20 6c 69  6b 65 20 74 68 65 20 54  |tools like the T|
000008c0  65 6d 70 6c 61 74 65 20  20 65 64 69 74 6f 72 20  |emplate  editor |
000008d0  77 68 69 63 68 20 68 61  73 20 69 74 73 20 6f 77  |which has its ow|
000008e0  6e 20 00 00 00 7c 00 00  25 70 00 00 42 9c 39 06  |n ...|..%p..B.9.|
000008f0  e7 4a f9 ff c7 79 f9 ff  20 22 00 f0 69 6e 73 74  |.J...y.. "..inst|
00000900  72 75 63 74 69 6f 6e 73  20 61 6e 64 20 6d 61 79  |ructions and may|
00000910  20 6e 6f 74 20 68 61 76  65 20 62 65 65 6e 20 73  | not have been s|
00000920  75 70 70 6c 69 65 64 20  77 69 74 68 20 79 6f 75  |upplied with you|
00000930  72 20 63 6f 70 79 20 6f  66 20 74 68 65 20 45 76  |r copy of the Ev|
00000940  6e 74 53 68 65 6c 6c 20  6c 69 62 72 61 72 79 2e  |ntShell library.|
00000950  0d 00 00 00 00 70 00 00  25 28 00 00 46 7a f8 00  |.....p..%(..Fz..|
00000960  a7 12 f9 ff 87 41 f9 ff  20 22 00 f2 12 69 62 72  |.....A.. "...ibr|
00000970  7a f8 00 00 00 00 00 00  0d 00 00 00 00 28 00 00  |z............(..|
00000980  05 78 00 00 00 f0 c0 06  67 da f8 ff 47 09 f9 ff  |.x......g...G...|
00000990  20 22 00 f2 44 6f 63 75  6d 65 6e 74 61 74 69 6f  | "..Documentatio|
000009a0  6e 20 6f 6e 20 74 68 65  20 76 61 72 69 6f 75 73  |n on the various|
000009b0  20 6c 69 62 72 61 72 79  20 72 6f 75 74 69 6e 65  | library routine|
000009c0  73 20 73 68 6f 75 6c 64  20 68 61 76 65 20 62 65  |s should have be|
000009d0  65 6e 20 73 75 70 70 6c  69 65 64 20 61 73 20 74  |en supplied as t|
000009e0  65 78 74 20 66 69 6c 65  73 20 61 6e 64 20 61 73  |ext files and as|
000009f0  20 00 00 00 00 78 00 00  25 54 00 00 42 f0 2c 04  | ....x..%T..B.,.|
00000a00  27 a2 f8 ff 07 d1 f8 ff  20 22 00 f0 53 74 72 6f  |'....... "..Stro|
00000a10  6e 67 48 6c 70 20 66 6f  72 6d 61 74 20 66 69 6c  |ngHlp format fil|
00000a20  65 73 20 6f 6e 20 74 68  65 20 64 69 73 6b 20 63  |es on the disk c|
00000a30  6f 6e 74 61 69 6e 69 6e  67 20 74 68 65 20 6c 69  |ontaining the li|
00000a40  62 72 61 72 79 2e 0d 00  00 54 00 00 25 1c 00 00  |brary....T..%...|
00000a50  42 00 00 00 e7 69 f8 ff  c7 98 f8 ff 20 22 00 f2  |B....i...... "..|
00000a60  0d 00 00 00 00 1c 00 00  05 7c 00 00 00 50 03 07  |.........|...P..|
00000a70  a7 31 f8 ff 87 60 f8 ff  20 22 00 f2 41 20 6c 69  |.1...`.. "..A li|
00000a80  73 74 20 6f 66 20 66 65  61 74 75 72 65 73 20 6f  |st of features o|
00000a90  66 20 74 68 65 20 45 76  6e 74 53 68 65 6c 6c 20  |f the EvntShell |
00000aa0  6c 69 62 72 61 72 79 20  66 6f 6c 6c 6f 77 73 2e  |library follows.|
00000ab0  20 4f 6e 20 72 65 61 64  69 6e 67 20 74 68 69 73  | On reading this|
00000ac0  20 61 67 61 69 6e 20 49  20 73 65 65 6d 20 74 6f  | again I seem to|
00000ad0  20 68 61 76 65 20 75 73  65 64 20 74 68 65 20 00  | have used the .|
00000ae0  00 7c 00 00 05 84 00 00  00 60 44 07 67 f9 f7 ff  |.|.......`D.g...|
00000af0  47 28 f8 ff 20 22 00 f0  77 6f 72 64 20 27 61 75  |G(.. "..word 'au|
00000b00  74 6f 6d 61 74 69 63 61  6c 6c 79 27 20 72 61 74  |tomatically' rat|
00000b10  68 65 72 20 61 20 6c 6f  74 2c 20 62 75 74 20 74  |her a lot, but t|
00000b20  68 69 73 20 64 65 73 63  72 69 62 65 73 20 70 65  |his describes pe|
00000b30  72 66 65 63 74 6c 79 20  74 68 65 20 77 68 6f 6c  |rfectly the whol|
00000b40  65 20 70 6f 69 6e 74 20  6f 66 20 74 68 65 20 73  |e point of the s|
00000b50  79 73 74 65 6d 2e 20 49  74 20 69 73 2c 20 66 6f  |ystem. It is, fo|
00000b60  72 20 00 00 00 84 00 00  05 7c 00 00 00 f8 fd 06  |r .......|......|
00000b70  27 c1 f7 ff 07 f0 f7 ff  20 22 00 f0 65 78 61 6d  |'....... "..exam|
00000b80  70 6c 65 2c 20 6e 65 63  65 73 73 61 72 79 20 74  |ple, necessary t|
00000b90  6f 20 73 65 74 20 6f 6e  65 20 27 62 69 74 27 20  |o set one 'bit' |
00000ba0  6f 66 20 61 20 66 6c 61  67 20 77 6f 72 64 20 69  |of a flag word i|
00000bb0  6e 20 74 68 65 20 77 69  6e 64 6f 77 20 64 65 66  |n the window def|
00000bc0  69 6e 69 74 69 6f 6e 20  74 6f 20 65 6e 73 75 72  |inition to ensur|
00000bd0  65 20 74 68 61 74 20 72  65 64 72 61 77 20 00 00  |e that redraw ..|
00000be0  00 7c 00 00 05 7c 00 00  00 90 11 07 e7 88 f7 ff  |.|...|..........|
00000bf0  c7 b7 f7 ff 20 22 00 f0  72 65 71 75 65 73 74 73  |.... "..requests|
00000c00  20 61 72 65 20 73 65 6e  74 20 74 6f 20 79 6f 75  | are sent to you|
00000c10  72 20 61 70 70 6c 69 63  61 74 69 6f 6e 2c 20 62  |r application, b|
00000c20  75 74 20 61 74 74 61 63  68 69 6e 67 20 61 20 72  |ut attaching a r|
00000c30  65 64 72 61 77 20 68 61  6e 64 6c 65 72 20 74 6f  |edraw handler to|
00000c40  20 74 68 65 20 77 69 6e  64 6f 77 20 70 65 72 66  | the window perf|
00000c50  6f 72 6d 73 20 74 68 69  73 20 00 00 00 7c 00 00  |orms this ...|..|
00000c60  25 68 00 00 42 44 e6 05  a7 50 f7 ff 87 7f f7 ff  |%h..BD...P......|
00000c70  20 22 00 f0 74 61 73 6b  20 66 6f 72 20 79 6f 75  | "..task for you|
00000c80  20 77 68 69 63 68 20 69  73 20 6f 6e 65 20 6c 65  | which is one le|
00000c90  73 73 20 74 68 69 6e 67  20 74 6f 20 67 6f 20 77  |ss thing to go w|
00000ca0  72 6f 6e 67 20 77 68 65  6e 20 77 72 69 74 69 6e  |rong when writin|
00000cb0  67 20 61 20 77 69 6d 70  20 70 72 6f 67 72 61 6d  |g a wimp program|
00000cc0  21 20 0d 00 00 68 00 00  a5 28 00 00 42 00 00 00  |! ...h...(..B...|
00000cd0  67 18 f7 ff 47 47 f7 ff  20 22 00 f2 0d 07 07 6f  |g...GG.. ".....o|
00000ce0  1f e7 0d 00 1f e7 0d 00  00 00 00 00 00 28 00 00  |.............(..|
00000cf0  85 9c 00 00 06 cc be 05  27 e0 f6 ff 07 0f f7 ff  |........'.......|
00000d00  20 22 00 f2 12 e7 0d 00  e0 2e 00 00 00 00 00 00  | "..............|
00000d10  07 28 00 00 20 f8 0d 00  1f e7 0d 00 20 f8 0d 00  |.(.. ....... ...|
00000d20  00 00 00 00 6a 08 00 02  20 f8 0d 00 1f e7 0d 00  |....j... .......|
00000d30  00 00 00 00 12 ae c2 ff  4c 2f 00 00 00 00 00 00  |........L/......|
00000d40  52 65 73 6f 75 72 63 65  73 20 28 69 2e 65 2e 20  |Resources (i.e. |
00000d50  74 65 6d 70 6c 61 74 65  73 2c 20 6d 65 6e 75 73  |templates, menus|
00000d60  2c 20 6d 65 73 73 61 67  65 73 20 61 6e 64 20 75  |, messages and u|
00000d70  73 65 72 20 73 70 72 69  74 65 73 29 20 61 72 65  |ser sprites) are|
00000d80  20 6c 6f 61 64 65 64 20  00 9c 00 00 25 68 00 00  | loaded ....%h..|
00000d90  46 8a 9e 04 e7 a7 f6 ff  c7 d6 f6 ff 20 22 00 f0  |F........... "..|
00000da0  61 6e 64 20 12 6c 6f 61  ee 02 00 00 00 00 00 00  |and .loa........|
00000db0  69 6e 69 74 69 61 6c 69  73 65 64 20 61 75 74 6f  |initialised auto|
00000dc0  6d 61 74 69 63 61 6c 6c  79 20 77 69 74 68 20 61  |matically with a|
00000dd0  20 63 61 6c 6c 20 74 6f  20 73 68 65 6c 6c 5f 52  | call to shell_R|
00000de0  65 73 6f 75 72 63 65 73  49 6e 69 74 20 0d 00 00  |esourcesInit ...|
00000df0  00 68 00 00 85 9c 00 00  06 bc c2 05 a7 6f f6 ff  |.h...........o..|
00000e00  87 9e f6 ff 20 22 00 f2  12 63 65 73 e0 2e 00 00  |.... "...ces....|
00000e10  00 00 00 00 07 68 00 00  20 fd 0d 00 1f e7 0d 00  |.....h.. .......|
00000e20  20 fd 0d 00 00 00 00 00  6a 12 00 02 4c 2f 00 00  | .......j...L/..|
00000e30  00 00 00 00 08 00 00 00  20 fd 0d 00 1f e7 0d 00  |........ .......|
00000e40  00 00 00 00 4d 65 6e 75  73 20 6d 61 79 20 62 65  |....Menus may be|
00000e50  20 61 74 74 61 63 68 65  64 20 74 6f 20 77 69 6e  | attached to win|
00000e60  64 6f 77 2f 69 63 6f 6e  20 70 61 69 72 73 2c 20  |dow/icon pairs, |
00000e70  6f 72 20 74 6f 20 74 68  65 20 77 68 6f 6c 65 20  |or to the whole |
00000e80  77 6f 72 6b 61 72 65 61  20 00 00 00 00 9c 00 00  |workarea .......|
00000e90  25 3c 00 00 42 dc c6 02  67 37 f6 ff 47 66 f6 ff  |%<..B...g7..Gf..|
00000ea0  20 22 00 f0 6f 66 20 61  20 77 69 6e 64 6f 77 20  | "..of a window |
00000eb0  77 69 74 68 20 73 68 65  6c 6c 5f 41 74 74 61 63  |with shell_Attac|
00000ec0  68 4d 65 6e 75 2e 20 0d  00 3c 00 00 85 9c 00 00  |hMenu. ..<......|
00000ed0  06 bc a4 05 27 ff f5 ff  07 2e f6 ff 20 22 00 f2  |....'....... "..|
00000ee0  12 74 61 63 e0 2e 00 00  00 00 00 00 07 3c 00 00  |.tac.........<..|
00000ef0  20 f9 0d 00 1f e7 0d 00  20 f9 0d 00 00 00 00 00  | ....... .......|
00000f00  6a 08 00 02 20 f9 0d 00  1f e7 0d 00 00 00 00 00  |j... ...........|
00000f10  12 00 00 00 4c 2f 00 00  00 00 00 00 41 20 90 4d  |....L/......A .M|
00000f20  65 6e 75 20 57 61 72 6e  69 6e 67 91 20 72 6f 75  |enu Warning. rou|
00000f30  74 69 6e 65 20 63 61 6e  20 61 6c 73 6f 20 62 65  |tine can also be|
00000f40  20 72 65 67 69 73 74 65  72 65 64 20 77 68 69 63  | registered whic|
00000f50  68 20 77 69 6c 6c 20 62  65 20 63 61 6c 6c 65 64  |h will be called|
00000f60  20 00 00 00 00 9c 00 00  05 58 00 00 00 ac e5 04  | ........X......|
00000f70  e7 c6 f5 ff c7 f5 f5 ff  20 22 00 f0 77 68 65 6e  |........ "..when|
00000f80  20 74 68 65 6e 20 70 6f  69 6e 74 65 72 20 6d 6f  | then pointer mo|
00000f90  76 65 73 20 6f 76 65 72  20 61 20 73 75 62 6d 65  |ves over a subme|
00000fa0  6e 75 20 61 72 72 6f 77  2c 20 77 68 69 63 68 20  |nu arrow, which |
00000fb0  6d 65 61 6e 73 20 74 68  61 74 20 00 00 58 00 00  |means that ..X..|
00000fc0  25 4c 00 00 42 20 a0 03  a7 8e f5 ff 87 bd f5 ff  |%L..B ..........|
00000fd0  20 22 00 f0 64 69 61 6c  6f 67 20 62 6f 78 65 73  | "..dialog boxes|
00000fe0  20 61 72 65 20 63 72 65  61 74 65 64 20 64 79 6e  | are created dyn|
00000ff0  61 6d 69 63 61 6c 6c 79  20 61 73 20 72 65 71 75  |amically as requ|
00001000  69 72 65 64 20 0d 00 00  00 4c 00 00 85 94 00 00  |ired ....L......|
00001010  06 38 32 05 67 56 f5 ff  47 85 f5 ff 20 22 00 f2  |.82.gV..G... "..|
00001020  12 65 71 75 e0 2e 00 00  00 00 00 00 07 4c 00 00  |.equ.........L..|
00001030  20 fa 0d 00 1f e7 0d 00  20 fa 0d 00 00 00 00 00  | ....... .......|
00001040  6a 08 00 02 20 fa 0d 00  1f e7 0d 00 00 00 00 00  |j... ...........|
00001050  12 00 00 00 4c 2f 00 00  00 00 00 00 4d 65 6e 75  |....L/......Menu|
00001060  73 20 61 72 65 20 61 75  74 6f 6d 61 74 69 63 61  |s are automatica|
00001070  6c 6c 79 20 6f 70 65 6e  65 64 20 69 6e 20 74 68  |lly opened in th|
00001080  65 20 63 6f 72 72 65 63  74 20 6c 6f 63 61 74 69  |e correct locati|
00001090  6f 6e 73 20 61 6e 64 20  74 68 65 20 00 94 00 00  |ons and the ....|
000010a0  05 58 00 00 00 00 da 04  27 1e f5 ff 07 4d f5 ff  |.X......'....M..|
000010b0  20 22 00 f0 41 44 4a 55  53 54 20 62 75 74 74 6f  | "..ADJUST butto|
000010c0  6e 20 63 61 75 73 65 73  20 74 68 65 20 6d 65 6e  |n causes the men|
000010d0  75 20 74 6f 20 62 65 20  72 65 2d 6f 70 65 6e 65  |u to be re-opene|
000010e0  64 20 61 73 20 70 65 72  20 52 49 53 43 2d 4f 53  |d as per RISC-OS|
000010f0  20 00 00 00 00 58 00 00  25 24 00 00 42 6c cc 00  | ....X..%$..Bl..|
00001100  e7 e5 f4 ff c7 14 f5 ff  20 22 00 f0 67 75 69 64  |........ "..guid|
00001110  65 6c 69 6e 65 73 20 0d  00 24 00 00 01 10 00 00  |elines ..$......|
00001120  00 00 00 00 00 00 00 00  00 10 00 00 02 18 00 00  |................|
00001130  f4 02 00 00 00 00 00 00  1f e7 0d 00 00 00 00 00  |................|
00001140  00 18 00 00 85 9c 00 00  06 58 ab 05 f6 58 f1 ff  |.........X...X..|
00001150  d6 87 f1 ff 20 22 00 f2  12 e7 0d 00 e0 2e 00 00  |.... "..........|
00001160  00 00 00 00 07 2f 00 00  20 f7 0d 00 1f e7 0d 00  |...../.. .......|
00001170  20 f7 0d 00 00 00 00 00  6a 08 62 65 20 f7 0d 00  | .......j.be ...|
00001180  1f e7 0d 00 00 00 00 00  12 73 68 65 4c 2f 00 00  |.........sheL/..|
00001190  00 00 00 00 41 20 72 6f  75 74 69 6e 65 20 63 61  |....A routine ca|
000011a0  6e 20 62 65 20 73 65 74  20 75 70 20 77 69 74 68  |n be set up with|
000011b0  20 73 68 65 6c 6c 5f 41  74 74 61 63 68 4d 65 6e  | shell_AttachMen|
000011c0  75 4d 61 6b 65 72 20 74  6f 20 73 68 61 64 65 2c  |uMaker to shade,|
000011d0  20 74 69 63 6b 20 6f 72  20 00 00 00 00 9c 00 00  | tick or .......|
000011e0  25 50 00 00 42 8c 00 04  b6 20 f1 ff 96 4f f1 ff  |%P..B.... ...O..|
000011f0  20 22 00 f0 6f 74 68 65  72 77 69 73 65 20 61 6c  | "..otherwise al|
00001200  74 65 72 20 6d 65 6e 75  20 69 74 65 6d 73 20 62  |ter menu items b|
00001210  65 66 6f 72 65 20 74 68  65 20 6d 65 6e 75 20 69  |efore the menu i|
00001220  73 20 6f 70 65 6e 65 64  20 0d 00 00 00 50 00 00  |s opened ....P..|
00001230  85 94 00 00 06 dc c3 05  76 e8 f0 ff 56 17 f1 ff  |........v...V...|
00001240  20 22 00 f2 12 20 6f 70  e0 2e 00 00 00 00 00 00  | "... op........|
00001250  07 50 00 00 20 f5 0d 00  1f e7 0d 00 20 f5 0d 00  |.P.. ....... ...|
00001260  00 00 00 00 6a 08 00 02  20 f5 0d 00 1f e7 0d 00  |....j... .......|
00001270  00 00 00 00 12 00 00 00  4c 2f 00 00 00 00 00 00  |........L/......|
00001280  3c 52 45 54 55 52 4e 3e  2c 20 3c 43 75 72 73 6f  |<RETURN>, <Curso|
00001290  72 20 55 70 3e 20 61 6e  64 20 3c 43 75 72 73 6f  |r Up> and <Curso|
000012a0  72 20 44 6f 77 6e 3e 20  6b 65 79 70 72 65 73 73  |r Down> keypress|
000012b0  65 73 20 6d 6f 76 65 20  63 61 72 65 74 20 00 00  |es move caret ..|
000012c0  00 94 00 00 05 58 00 00  00 ac eb 04 36 b0 f0 ff  |.....X......6...|
000012d0  16 df f0 ff 20 22 00 f0  62 65 74 77 65 65 6e 20  |.... "..between |
000012e0  77 72 69 74 65 61 62 6c  65 20 69 63 6f 6e 73 20  |writeable icons |
000012f0  61 75 74 6f 6d 61 74 69  63 61 6c 6c 79 20 61 6e  |automatically an|
00001300  64 20 61 20 3c 52 45 54  55 52 4e 3e 20 6b 65 79  |d a <RETURN> key|
00001310  70 72 65 73 73 20 00 00  00 58 00 00 25 58 00 00  |press ...X..%X..|
00001320  42 f4 4f 04 f6 77 f0 ff  d6 a6 f0 ff 20 22 00 f0  |B.O..w...... "..|
00001330  77 68 65 6e 20 74 68 65  20 63 61 72 65 74 20 69  |when the caret i|
00001340  73 20 69 6e 20 74 68 65  20 6c 61 73 74 20 77 72  |s in the last wr|
00001350  69 74 65 61 62 6c 65 20  69 63 6f 6e 20 61 63 74  |iteable icon act|
00001360  69 76 61 74 65 73 20 69  63 6f 6e 20 30 20 0d 00  |ivates icon 0 ..|
00001370  00 58 00 00 85 9c 00 00  06 2c 9e 05 b6 3f f0 ff  |.X.......,...?..|
00001380  96 6e f0 ff 20 22 00 f2  12 73 20 69 e0 2e 00 00  |.n.. "...s i....|
00001390  00 00 00 00 07 58 00 00  20 f4 0d 00 1f e7 0d 00  |.....X.. .......|
000013a0  20 f4 0d 00 00 00 00 00  6a 08 00 02 20 f4 0d 00  | .......j... ...|
000013b0  1f e7 0d 00 00 00 00 00  12 00 00 00 4c 2f 00 00  |............L/..|
000013c0  00 00 00 00 90 48 6f 74  4b 65 79 91 20 6b 65 79  |.....HotKey. key|
000013d0  70 72 65 73 73 65 73 20  61 72 65 20 68 61 6e 64  |presses are hand|
000013e0  6c 65 64 20 62 79 20 61  20 67 65 6e 65 72 61 6c  |led by a general|
000013f0  20 6b 65 79 70 72 65 73  73 20 72 6f 75 74 69 6e  | keypress routin|
00001400  65 20 73 65 74 20 75 70  20 00 00 00 00 9c 00 00  |e set up .......|
00001410  05 5c 00 00 00 c8 ff 04  76 07 f0 ff 56 36 f0 ff  |.\......v...V6..|
00001420  20 22 00 f0 77 69 74 68  20 73 68 65 6c 6c 5f 41  | "..with shell_A|
00001430  74 74 61 63 68 48 6f 74  4b 65 79 73 2e 20 4b 65  |ttachHotKeys. Ke|
00001440  79 70 72 65 73 73 20 6e  6f 74 20 68 61 6e 64 6c  |ypress not handl|
00001450  65 64 20 62 79 20 74 68  69 73 20 72 6f 75 74 69  |ed by this routi|
00001460  6e 65 20 61 72 65 20 00  00 5c 00 00 05 4c 00 00  |ne are ..\...L..|
00001470  00 08 ac 03 36 cf ef ff  16 fe ef ff 20 22 00 f0  |....6....... "..|
00001480  61 75 74 6f 6d 61 74 69  63 61 6c 6c 79 20 70 61  |automatically pa|
00001490  73 73 65 64 20 6f 6e 20  74 6f 20 6f 74 68 65 72  |ssed on to other|
000014a0  20 61 70 70 6c 69 63 61  74 69 6f 6e 73 20 77 69  | applications wi|
000014b0  74 68 20 00 00 4c 00 00  25 2c 00 00 42 44 9f 01  |th ..L..%,..BD..|
000014c0  f6 96 ef ff d6 c5 ef ff  20 22 00 f0 94 57 69 6d  |........ "...Wim|
000014d0  70 5f 50 72 6f 63 65 73  73 4b 65 79 95 20 0d 00  |p_ProcessKey. ..|
000014e0  00 2c 00 00 85 a0 00 00  06 e4 a0 05 b6 5e ef ff  |.,...........^..|
000014f0  96 8d ef ff 20 22 00 f2  12 63 65 73 e0 2e 00 00  |.... "...ces....|
00001500  00 00 00 00 07 2c 00 00  20 ec 0d 00 1f e7 0d 00  |.....,.. .......|
00001510  20 ec 0d 00 00 00 00 00  6a 08 00 02 20 ec 0d 00  | .......j... ...|
00001520  1f e7 0d 00 00 00 00 00  12 00 00 00 4c 2f 00 00  |............L/..|
00001530  00 00 00 00 44 72 61 67  20 6c 6f 61 64 69 6e 67  |....Drag loading|
00001540  20 6f 66 20 61 20 66 69  6c 65 20 68 61 6e 64 6c  | of a file handl|
00001550  65 64 20 61 75 74 6f 6d  61 74 69 63 61 6c 6c 79  |ed automatically|
00001560  20 28 67 69 76 65 20 74  79 70 65 20 6f 66 20 66  | (give type of f|
00001570  69 6c 65 2c 20 72 65 74  75 72 6e 73 20 00 00 00  |ile, returns ...|
00001580  00 a0 00 00 05 58 00 00  00 a4 ba 04 76 26 ef ff  |.....X......v&..|
00001590  56 55 ef ff 20 22 00 f0  61 64 64 72 65 73 73 20  |VU.. "..address |
000015a0  6f 66 20 6c 6f 61 64 65  64 20 66 69 6c 65 29 2e  |of loaded file).|
000015b0  20 52 41 4d 20 62 75 66  66 65 72 73 20 75 73 65  | RAM buffers use|
000015c0  64 20 77 68 65 72 65 20  70 6f 73 73 69 62 6c 65  |d where possible|
000015d0  20 28 69 6e 74 65 72 2d  00 58 00 00 25 34 00 00  | (inter-.X..%4..|
000015e0  42 54 e0 01 36 ee ee ff  16 1d ef ff 20 22 00 f0  |BT..6....... "..|
000015f0  61 70 70 6c 69 63 61 74  69 6f 6e 20 64 61 74 61  |application data|
00001600  20 74 72 61 6e 73 66 65  72 29 20 0d 00 34 00 00  | transfer) ..4..|
00001610  85 9c 00 00 06 34 a2 05  f6 b5 ee ff d6 e4 ee ff  |.....4..........|
00001620  20 22 00 f2 12 74 72 61  e0 2e 00 00 00 00 00 00  | "...tra........|
00001630  07 34 00 00 20 eb 0d 00  1f e7 0d 00 20 eb 0d 00  |.4.. ....... ...|
00001640  00 00 00 00 6a 08 00 02  20 eb 0d 00 1f e7 0d 00  |....j... .......|
00001650  00 00 00 00 12 00 00 00  4c 2f 00 00 00 00 00 00  |........L/......|
00001660  44 72 61 67 20 73 61 76  69 6e 67 20 6f 66 20 66  |Drag saving of f|
00001670  69 6c 65 73 20 68 61 6e  64 6c 65 64 20 61 75 74  |iles handled aut|
00001680  6f 6d 61 74 69 63 61 6c  6c 79 20 75 73 69 6e 67  |omatically using|
00001690  20 52 41 4d 20 74 72 61  6e 73 66 65 72 20 77 68  | RAM transfer wh|
000016a0  65 72 65 20 20 00 00 00  00 9c 00 00 25 24 00 00  |ere  .......%$..|
000016b0  42 60 a5 00 b6 7d ee ff  96 ac ee ff 20 22 00 f0  |B`...}...... "..|
000016c0  70 6f 73 73 69 62 6c 65  20 0d 00 00 00 24 00 00  |possible ....$..|
000016d0  85 9c 00 00 06 98 b0 05  76 45 ee ff 56 74 ee ff  |........vE..Vt..|
000016e0  20 22 00 f2 12 6f 73 73  e0 2e 00 00 00 00 00 00  | "...oss........|
000016f0  07 24 00 00 20 fe 0d 00  1f e7 0d 00 20 fe 0d 00  |.$.. ....... ...|
00001700  00 00 00 00 6a 12 00 02  4c 2f 00 00 00 00 00 00  |....j...L/......|
00001710  08 00 00 00 20 fe 0d 00  1f e7 0d 00 00 00 00 00  |.... ...........|
00001720  49 6e 74 65 72 66 61 63  65 20 6d 6f 64 75 6c 65  |Interface module|
00001730  20 73 75 70 70 6f 72 74  65 64 20 28 62 75 74 74  | supported (butt|
00001740  6f 6e 20 63 6c 69 63 6b  73 20 61 75 74 6f 6d 61  |on clicks automa|
00001750  74 69 63 61 6c 6c 79 20  72 65 73 75 6c 74 20 69  |tically result i|
00001760  6e 20 69 63 6f 6e 73 20  00 9c 00 00 05 5c 00 00  |n icons .....\..|
00001770  00 50 02 05 36 0d ee ff  16 3c ee ff 20 22 00 f0  |.P..6....<.. "..|
00001780  90 73 6c 61 62 62 69 6e  67 91 20 61 73 20 61 70  |.slabbing. as ap|
00001790  70 72 6f 70 72 69 61 74  65 29 20 50 6f 69 6e 74  |propriate) Point|
000017a0  65 72 73 20 6d 61 79 20  62 65 20 61 74 74 61 63  |ers may be attac|
000017b0  68 65 64 20 74 6f 20 77  69 6e 64 6f 77 20 77 6f  |hed to window wo|
000017c0  72 6b 20 00 00 5c 00 00  25 34 00 00 42 70 03 02  |rk ..\..%4..Bp..|
000017d0  f6 d4 ed ff d6 03 ee ff  20 22 00 f0 61 72 65 61  |........ "..area|
000017e0  73 20 75 73 69 6e 67 20  49 6e 74 65 72 66 61 63  |s using Interfac|
000017f0  65 20 53 57 49 73 20 0d  00 34 00 00 85 9c 00 00  |e SWIs ..4......|
00001800  06 74 80 05 b6 9c ed ff  96 cb ed ff 20 22 00 f2  |.t.......... "..|
00001810  12 66 61 63 e0 2e 00 00  00 00 00 00 07 34 00 00  |.fac.........4..|
00001820  20 ea 0d 00 1f e7 0d 00  20 ea 0d 00 00 00 00 00  | ....... .......|
00001830  6a 08 00 02 20 ea 0d 00  1f e7 0d 00 00 00 00 00  |j... ...........|
00001840  12 00 00 00 4c 2f 00 00  00 00 00 00 49 6e 74 65  |....L/......Inte|
00001850  72 61 63 74 69 76 65 20  68 65 6c 70 20 70 72 6f  |ractive help pro|
00001860  76 69 64 65 64 20 62 79  20 61 74 74 61 63 68 69  |vided by attachi|
00001870  6e 67 20 74 61 67 73 20  69 6e 20 69 63 6f 6e 20  |ng tags in icon |
00001880  76 61 6c 69 64 61 74 69  6f 6e 20 73 74 72 69 6e  |validation strin|
00001890  67 73 20 00 00 9c 00 00  05 60 00 00 00 c8 d8 04  |gs ......`......|
000018a0  76 64 ed ff 56 93 ed ff  20 22 00 f0 61 6e 64 20  |vd..V... "..and |
000018b0  6c 6f 6f 6b 69 6e 67 20  75 70 20 74 61 67 20 69  |looking up tag i|
000018c0  6e 20 6d 65 73 73 61 67  65 20 66 69 6c 65 2e 20  |n message file. |
000018d0  54 68 69 73 20 61 6c 6c  6f 77 73 20 65 61 73 79  |This allows easy|
000018e0  20 65 64 69 74 69 6e 67  20 6f 66 20 74 68 65 20  | editing of the |
000018f0  20 00 00 00 00 60 00 00  05 5c 00 00 00 8c f6 04  | ....`...\......|
00001900  36 2c ed ff 16 5b ed ff  20 22 00 f0 6d 65 73 73  |6,...[.. "..mess|
00001910  61 67 65 20 72 65 73 6f  75 72 63 65 20 66 69 6c  |age resource fil|
00001920  65 20 66 6f 72 20 6f 74  68 65 72 20 6c 61 6e 67  |e for other lang|
00001930  75 61 67 65 73 2e 20 28  74 68 65 20 4d 73 67 54  |uages. (the MsgT|
00001940  72 61 6e 73 20 6d 6f 64  75 6c 65 20 69 73 20 00  |rans module is .|
00001950  00 5c 00 00 05 60 00 00  00 a4 1d 05 f6 f3 ec ff  |.\...`..........|
00001960  d6 22 ed ff 20 22 00 f0  75 73 65 64 20 66 6f 72  |.".. "..used for|
00001970  20 74 68 69 73 29 2e 20  4d 65 73 73 61 67 65 20  | this). Message |
00001980  54 61 67 73 20 63 61 6e  20 61 6c 73 6f 20 62 65  |Tags can also be|
00001990  20 61 74 74 61 63 68 65  64 20 74 6f 20 61 6e 79  | attached to any|
000019a0  20 77 69 6e 64 6f 77 2f  69 63 6f 6e 20 00 00 00  | window/icon ...|
000019b0  00 60 00 00 05 60 00 00  00 74 02 05 b6 bb ec ff  |.`...`...t......|
000019c0  96 ea ec ff 20 22 00 f0  63 6f 6d 62 69 6e 61 74  |.... "..combinat|
000019d0  69 6f 6e 20 61 6e 64 20  74 68 65 20 68 65 6c 70  |ion and the help|
000019e0  20 74 65 78 74 20 77 69  6c 6c 20 62 65 20 6c 6f  | text will be lo|
000019f0  6f 6b 65 64 20 75 70 20  61 6e 64 20 73 65 6e 74  |oked up and sent|
00001a00  20 74 6f 20 74 68 65 20  48 65 6c 70 20 00 00 00  | to the Help ...|
00001a10  00 60 00 00 25 28 00 00  42 c0 e7 00 76 83 ec ff  |.`..%(..B...v...|
00001a20  56 b2 ec ff 20 22 00 f0  61 70 70 6c 69 63 61 74  |V... "..applicat|
00001a30  69 6f 6e 2e 20 0d 00 00  00 28 00 00 85 9c 00 00  |ion. ....(......|
00001a40  06 f4 4e 05 36 4b ec ff  16 7a ec ff 20 22 00 f2  |..N.6K...z.. "..|
00001a50  12 63 61 74 e0 2e 00 00  00 00 00 00 07 28 00 00  |.cat.........(..|
00001a60  20 ed 0d 00 1f e7 0d 00  20 ed 0d 00 00 00 00 00  | ....... .......|
00001a70  6a 08 00 02 20 ed 0d 00  1f e7 0d 00 00 00 00 00  |j... ...........|
00001a80  12 00 00 00 4c 2f 00 00  00 00 00 00 41 6c 6c 20  |....L/......All |
00001a90  72 6f 75 74 69 6e 65 73  20 69 6e 20 74 68 65 20  |routines in the |
00001aa0  53 68 65 6c 6c 20 4c 69  62 72 61 72 79 20 61 72  |Shell Library ar|
00001ab0  65 20 70 72 65 66 69 78  65 64 20 77 69 74 68 20  |e prefixed with |
00001ac0  90 73 68 65 6c 6c 91 20  74 6f 20 61 76 6f 69 64  |.shell. to avoid|
00001ad0  20 00 00 00 00 9c 00 00  05 60 00 00 00 bc 26 05  | ........`....&.|
00001ae0  f6 12 ec ff d6 41 ec ff  20 22 00 f0 63 6c 61 73  |.....A.. "..clas|
00001af0  68 65 73 20 77 69 74 68  20 72 6f 75 74 69 6e 65  |hes with routine|
00001b00  20 6e 61 6d 65 73 20 69  6e 20 74 68 65 20 75 73  | names in the us|
00001b10  65 72 91 73 20 70 72 6f  67 72 61 6d 2e 20 47 6c  |er.s program. Gl|
00001b20  6f 62 61 6c 20 76 61 72  69 61 62 6c 65 73 20 61  |obal variables a|
00001b30  72 65 20 00 00 60 00 00  25 38 00 00 42 9c 2e 02  |re ..`..%8..B...|
00001b40  b6 da eb ff 96 09 ec ff  20 22 00 f0 6b 65 70 74  |........ "..kept|
00001b50  20 74 6f 20 61 6e 20 61  62 73 6f 6c 75 74 65 20  | to an absolute |
00001b60  6d 69 6e 69 6d 75 6d 20  0d 00 00 00 00 38 00 00  |minimum .....8..|
00001b70  85 98 00 00 06 64 8d 05  76 a2 eb ff 56 d1 eb ff  |.....d..v...V...|
00001b80  20 22 00 f2 12 69 6e 69  e0 2e 00 00 00 00 00 00  | "...ini........|
00001b90  07 38 00 00 20 ee 0d 00  1f e7 0d 00 20 ee 0d 00  |.8.. ....... ...|
00001ba0  00 00 00 00 6a 08 00 02  20 ee 0d 00 1f e7 0d 00  |....j... .......|
00001bb0  00 00 00 00 12 00 00 00  4c 2f 00 00 00 00 00 00  |........L/......|
00001bc0  4d 65 6d 6f 72 79 20 69  73 20 63 6c 61 69 6d 65  |Memory is claime|
00001bd0  64 20 61 6e 64 20 72 65  6c 65 61 73 65 64 20 61  |d and released a|
00001be0  73 20 72 65 71 75 69 72  65 64 20 66 72 6f 6d 20  |s required from |
00001bf0  74 68 65 20 6e 65 78 74  20 77 69 6d 70 73 6c 6f  |the next wimpslo|
00001c00  74 2e 20 00 00 98 00 00  25 5c 00 00 42 00 e3 04  |t. .....%\..B...|
00001c10  36 6a eb ff 16 99 eb ff  20 22 00 f0 54 68 65 20  |6j...... "..The |
00001c20  20 75 73 65 72 20 64 6f  65 73 20 6e 6f 74 20 6e  | user does not n|
00001c30  65 65 64 20 74 6f 20 6b  6e 6f 77 20 77 68 65 72  |eed to know wher|
00001c40  65 20 74 68 65 20 66 69  6c 65 73 20 26 20 64 61  |e the files & da|
00001c50  74 61 20 61 72 65 20 6c  6f 61 64 65 64 2e 0d 00  |ta are loaded...|
00001c60  00 5c 00 00 85 98 00 00  06 c4 8a 05 f6 31 eb ff  |.\...........1..|
00001c70  d6 60 eb ff 20 22 00 f2  12 65 20 6c e0 2e 00 00  |.`.. "...e l....|
00001c80  00 00 00 00 07 5c 00 00  20 ef 0d 00 1f e7 0d 00  |.....\.. .......|
00001c90  20 ef 0d 00 00 00 00 00  6a 08 00 02 20 ef 0d 00  | .......j... ...|
00001ca0  1f e7 0d 00 00 00 00 00  12 00 00 00 4c 2f 00 00  |............L/..|
00001cb0  00 00 00 00 54 68 65 20  53 68 65 6c 6c 20 4c 69  |....The Shell Li|
00001cc0  62 72 61 72 79 20 69 6e  63 6c 75 64 65 73 20 64  |brary includes d|
00001cd0  65 62 75 67 67 69 6e 67  20 63 6f 64 65 20 77 68  |ebugging code wh|
00001ce0  69 63 68 20 77 72 69 74  65 73 20 61 20 54 72 61  |ich writes a Tra|
00001cf0  63 65 46 69 6c 65 20 00  00 98 00 00 05 64 00 00  |ceFile ......d..|
00001d00  00 44 3e 05 b6 f9 ea ff  96 28 eb ff 20 22 00 f0  |.D>......(.. "..|
00001d10  69 6e 74 6f 20 74 68 65  20 61 70 70 6c 69 63 61  |into the applica|
00001d20  74 69 6f 6e 20 64 69 72  65 63 74 6f 72 79 20 77  |tion directory w|
00001d30  68 69 63 68 20 63 61 6e  20 62 65 20 6c 6f 61 64  |hich can be load|
00001d40  65 64 20 69 6e 74 6f 20  21 45 64 69 74 2c 20 21  |ed into !Edit, !|
00001d50  44 65 73 6b 45 64 69 74  20 00 00 00 00 64 00 00  |DeskEdit ....d..|
00001d60  05 60 00 00 00 9c 2e 05  76 c1 ea ff 56 f0 ea ff  |.`......v...V...|
00001d70  20 22 00 f0 65 74 63 20  66 6f 72 20 76 69 65 77  | "..etc for view|
00001d80  69 6e 67 2e 20 41 20 63  6f 6d 70 72 65 73 73 65  |ing. A compresse|
00001d90  64 20 90 72 75 6e 74 69  6d 65 91 20 6c 69 62 72  |d .runtime. libr|
00001da0  61 72 79 20 69 73 20 61  6c 73 6f 20 73 75 70 70  |ary is also supp|
00001db0  6c 69 65 64 20 77 68 69  63 68 20 00 00 60 00 00  |lied which ..`..|
00001dc0  25 50 00 00 42 c0 05 04  36 89 ea ff 16 b8 ea ff  |%P..B...6.......|
00001dd0  20 22 00 f0 68 61 73 20  68 61 64 20 74 68 65 20  | "..has had the |
00001de0  64 65 62 75 67 67 69 6e  67 20 72 6f 75 74 69 6e  |debugging routin|
00001df0  65 73 20 72 65 6d 6f 76  65 64 20 74 6f 20 73 61  |es removed to sa|
00001e00  76 65 20 73 70 61 63 65  20 0d 00 00 00 50 00 00  |ve space ....P..|
00001e10  a5 98 00 00 46 8c 6b 05  f6 50 ea ff d6 7f ea ff  |....F.k..P......|
00001e20  20 22 00 f2 12 65 20 73  e0 2e 00 00 00 00 00 00  | "...e s........|
00001e30  07 50 00 00 20 f0 0d 00  1f e7 0d 00 20 f0 0d 00  |.P.. ....... ...|
00001e40  00 00 00 00 6a 08 00 02  20 f0 0d 00 1f e7 0d 00  |....j... .......|
00001e50  00 00 00 00 12 00 00 00  4c 2f 00 00 00 00 00 00  |........L/......|
00001e60  50 61 6e 65 73 20 61 72  65 20 68 61 6e 64 6c 65  |Panes are handle|
00001e70  64 20 62 79 20 72 65 67  69 73 74 65 72 69 6e 67  |d by registering|
00001e80  20 61 20 66 75 6e 63 74  69 6f 6e 20 77 69 74 68  | a function with|
00001e90  20 73 68 65 6c 6c 5f 41  74 74 61 63 68 50 61 6e  | shell_AttachPan|
00001ea0  65 20 0d 00 00 98 00 00  85 98 00 00 06 8c 44 05  |e ............D.|
00001eb0  b6 18 ea ff 96 47 ea ff  20 22 00 f2 12 74 61 63  |.....G.. "...tac|
00001ec0  e0 2e 00 00 00 00 00 00  07 98 00 00 20 f1 0d 00  |............ ...|
00001ed0  1f e7 0d 00 20 f1 0d 00  00 00 00 00 6a 08 00 02  |.... .......j...|
00001ee0  20 f1 0d 00 1f e7 0d 00  00 00 00 00 12 00 00 00  | ...............|
00001ef0  4c 2f 00 00 00 00 00 00  48 61 6e 64 6c 69 6e 67  |L/......Handling|
00001f00  20 6f 66 20 64 72 61 67  67 61 62 6c 65 20 69 63  | of draggable ic|
00001f10  6f 6e 73 20 69 73 20 61  75 74 6f 6d 61 74 69 63  |ons is automatic|
00001f20  20 2d 20 69 74 20 69 73  20 6f 6e 6c 79 20 6e 65  | - it is only ne|
00001f30  63 65 73 73 61 72 79 20  74 6f 20 20 00 98 00 00  |cessary to  ....|
00001f40  25 58 00 00 42 04 91 04  76 e0 e9 ff 56 0f ea ff  |%X..B...v...V...|
00001f50  20 22 00 f0 72 65 67 69  73 74 65 72 20 61 20 72  | "..register a r|
00001f60  6f 75 74 69 6e 65 20 74  6f 20 68 61 6e 64 6c 65  |outine to handle|
00001f70  20 77 68 61 74 20 68 61  70 70 65 6e 73 20 77 68  | what happens wh|
00001f80  65 6e 20 74 68 65 20 64  72 61 67 20 65 6e 64 73  |en the drag ends|
00001f90  2e 20 0d 00 00 58 00 00  85 98 00 00 06 4c 48 05  |. ...X.......LH.|
00001fa0  36 a8 e9 ff 16 d7 e9 ff  20 22 00 f2 12 61 67 20  |6....... "...ag |
00001fb0  e0 2e 00 00 00 00 00 00  07 58 00 00 20 f2 0d 00  |.........X.. ...|
00001fc0  1f e7 0d 00 20 f2 0d 00  00 00 00 00 6a 08 00 02  |.... .......j...|
00001fd0  20 f2 0d 00 1f e7 0d 00  00 00 00 00 12 00 00 00  | ...............|
00001fe0  4c 2f 00 00 00 00 00 00  45 76 65 6e 74 20 68 61  |L/......Event ha|
00001ff0  6e 64 6c 65 72 73 20 63  61 6e 20 62 65 20 72 65  |ndlers can be re|
00002000  67 69 73 74 65 72 65 64  20 66 6f 72 20 61 6c 6c  |gistered for all|
00002010  20 6d 65 73 73 61 67 65  20 65 76 65 6e 74 73 2c  | message events,|
00002020  20 69 2e 65 20 6d 6f 64  65 20 00 00 00 98 00 00  | i.e mode ......|
00002030  25 20 00 00 42 78 90 00  f6 6f e9 ff d6 9e e9 ff  |% ..Bx...o......|
00002040  20 22 00 f0 63 68 61 6e  67 65 2e 0d 00 20 00 00  | "..change... ..|
00002050  a5 98 00 00 46 3c 56 04  b6 37 e9 ff 96 66 e9 ff  |....F<V..7...f..|
00002060  20 22 00 f2 12 22 00 00  e0 2e 00 00 00 00 00 00  | "..."..........|
00002070  07 20 00 00 20 f3 0d 00  1f e7 0d 00 20 f3 0d 00  |. .. ....... ...|
00002080  00 00 00 00 6a 08 00 02  20 f3 0d 00 1f e7 0d 00  |....j... .......|
00002090  00 00 00 00 12 00 00 00  4c 2f 00 00 00 00 00 00  |........L/......|
000020a0  4d 75 6c 74 69 70 6c 65  20 66 69 6c 65 73 20 6d  |Multiple files m|
000020b0  61 79 20 62 65 20 6c 6f  61 64 65 64 20 69 6e 74  |ay be loaded int|
000020c0  6f 20 72 65 73 69 7a 65  61 62 6c 65 20 62 75 66  |o resizeable buf|
000020d0  66 65 72 73 2e 08 20 62  1f e7 0d 00 00 00 00 00  |fers.. b........|
000020e0  0d 00 00 00 00 98 00 00  06 00 00 00 79 56 34 12  |............yV4.|
000020f0  b0 00 00 00 01 00 00 00  00 00 00 00 06 08 00 00  |................|
00002100  00 08 00 00 01 10 00 00  00 00 00 00 00 00 00 00  |................|
00002110  00 10 00 00 02 1c 00 00  f0 01 00 00 00 00 00 00  |................|
00002120  18 66 03 00 11 cc 09 00  00 00 00 00 00 1c 00 00  |.f..............|
00002130  a5 68 00 00 42 fe 3e 01  81 05 f4 ff 31 3c f4 ff  |.h..B.>.....1<..|
00002140  e4 29 00 f2 07 66 03 00  18 66 03 00 18 66 03 00  |.)...f...f...f..|
00002150  00 00 00 00 07 05 05 05  11 cc 09 00 18 66 03 00  |.............f..|
00002160  11 cc 09 00 00 00 00 00  49 6e 74 72 6f 64 75 63  |........Introduc|
00002170  74 69 6f 6e 08 08 6e 08  11 cc 09 00 18 66 03 00  |tion..n......f..|
00002180  00 00 00 00 08 66 03 00  18 66 03 00 00 00 00 00  |.....f...f......|
00002190  0d 00 00 00 00 68 00 00  06 00 00 00 79 56 34 12  |.....h......yV4.|
000021a0  b0 00 00 00 04 00 00 00  00 00 00 00 06 08 00 00  |................|
000021b0  00 08 00 00 01 10 00 00  00 00 00 00 00 00 00 00  |................|
000021c0  00 10 00 00 02 1c 00 00  44 04 00 00 00 00 00 00  |........D.......|
000021d0  18 66 03 00 11 cc 09 00  00 00 00 00 00 1c 00 00  |.f..............|
000021e0  a5 68 00 00 42 fe 3e 01  d0 05 e7 ff 80 3c e7 ff  |.h..B.>......<..|
000021f0  e4 29 00 f2 07 66 03 00  18 66 03 00 18 66 03 00  |.)...f...f...f..|
00002200  00 00 00 00 07 05 05 05  11 cc 09 00 18 66 03 00  |.............f..|
00002210  11 cc 09 00 00 00 00 00  49 6e 74 72 6f 64 75 63  |........Introduc|
00002220  74 69 6f 6e 08 08 6e 08  11 cc 09 00 18 66 03 00  |tion..n......f..|
00002230  00 00 00 00 08 66 03 00  18 66 03 00 00 00 00 00  |.....f...f......|
00002240  0d 00 00 00 00 68 00 00  06 00 00 00 79 56 34 12  |.....h......yV4.|
00002250