Home » Archimedes archive » Acorn User » AU 1996-02.adf » Clan » ReadMe

ReadMe

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 User » AU 1996-02.adf » Clan
Filename: ReadMe
Read OK:
File size: 0921 bytes
Load address: 0000
Exec address: 0000
File contents
The Toolbox
This disc contains a special version of ResEd (the resource editor) and
ResTest (to test the user interafce that you create). These are fully
working versions except that ResEd will not allow you to save edited
resource files; you can, however, drag resources or groups of resources
directly from ResEd to the ResTest application. Together they will allow you 
to use the new toolbox modules to create and model a new user interface in a
matter of a few minutes.

Modules
To use ResEd and ResTest you must first merge the toolbox modules into you
!System directory. You can use !SysMerge to do this, full instructions are
in the help document in !SysMerge

How to use this version:
The basic process is to load ResEd and then open up a new resource file
window. Menu over either the icon or the window to open the prototypes
window. Select the object that you want to use, such as an Iconbar icon, and
drag it to your new resource file window. You can then start to build up
your user interface, opening each object to set its properties. To create
the links between objects, drop the new object onto the appropriate field in
the properties window of the first object. To see how your user interface
objects will behave at run-time, you can drag objects to the ResTest
application. ResTest's menu allows you to instantiate (ie create) objects
from your object templates, and to show them on the screen. You should now
be able to get a feel of what the user interface that you have created looks
like. Have fun!

Licensing:
Note that this disc contains the RiscOS relocatable modules which form the
Toolbox.  You are not entitled to distribute these modules in any form to
any other party.  By purchasing the full Acorn C/C++ product, you will be
entitled to distribute the Toolbox modules as part of your own software, in
the same way as any other RiscOS module.


Disclaimer
This software is provided "as is"; Acorn Computers Limited  ("Acorn") makes
no warranty, express or implied, of the merchantability of  this software or
its fitness for any particular purpose. In no circumstances shall Acorn be
liable for any damage, loss of profits, or any indirect or  consequential
loss arising out of the use of this software or inability to  use this
software, even if Acorn has been advised of the possibility of such loss.

00000000  0a 54 68 65 20 54 6f 6f  6c 62 6f 78 0a 54 68 69  |.The Toolbox.Thi|
00000010  73 20 64 69 73 63 20 63  6f 6e 74 61 69 6e 73 20  |s disc contains |
00000020  61 20 73 70 65 63 69 61  6c 20 76 65 72 73 69 6f  |a special versio|
00000030  6e 20 6f 66 20 52 65 73  45 64 20 28 74 68 65 20  |n of ResEd (the |
00000040  72 65 73 6f 75 72 63 65  20 65 64 69 74 6f 72 29  |resource editor)|
00000050  20 61 6e 64 0a 52 65 73  54 65 73 74 20 28 74 6f  | and.ResTest (to|
00000060  20 74 65 73 74 20 74 68  65 20 75 73 65 72 20 69  | test the user i|
00000070  6e 74 65 72 61 66 63 65  20 74 68 61 74 20 79 6f  |nterafce that yo|
00000080  75 20 63 72 65 61 74 65  29 2e 20 54 68 65 73 65  |u create). These|
00000090  20 61 72 65 20 66 75 6c  6c 79 0a 77 6f 72 6b 69  | are fully.worki|
000000a0  6e 67 20 76 65 72 73 69  6f 6e 73 20 65 78 63 65  |ng versions exce|
000000b0  70 74 20 74 68 61 74 20  52 65 73 45 64 20 77 69  |pt that ResEd wi|
000000c0  6c 6c 20 6e 6f 74 20 61  6c 6c 6f 77 20 79 6f 75  |ll not allow you|
000000d0  20 74 6f 20 73 61 76 65  20 65 64 69 74 65 64 0a  | to save edited.|
000000e0  72 65 73 6f 75 72 63 65  20 66 69 6c 65 73 3b 20  |resource files; |
000000f0  79 6f 75 20 63 61 6e 2c  20 68 6f 77 65 76 65 72  |you can, however|
00000100  2c 20 64 72 61 67 20 72  65 73 6f 75 72 63 65 73  |, drag resources|
00000110  20 6f 72 20 67 72 6f 75  70 73 20 6f 66 20 72 65  | or groups of re|
00000120  73 6f 75 72 63 65 73 0a  64 69 72 65 63 74 6c 79  |sources.directly|
00000130  20 66 72 6f 6d 20 52 65  73 45 64 20 74 6f 20 74  | from ResEd to t|
00000140  68 65 20 52 65 73 54 65  73 74 20 61 70 70 6c 69  |he ResTest appli|
00000150  63 61 74 69 6f 6e 2e 20  54 6f 67 65 74 68 65 72  |cation. Together|
00000160  20 74 68 65 79 20 77 69  6c 6c 20 61 6c 6c 6f 77  | they will allow|
00000170  20 79 6f 75 20 0a 74 6f  20 75 73 65 20 74 68 65  | you .to use the|
00000180  20 6e 65 77 20 74 6f 6f  6c 62 6f 78 20 6d 6f 64  | new toolbox mod|
00000190  75 6c 65 73 20 74 6f 20  63 72 65 61 74 65 20 61  |ules to create a|
000001a0  6e 64 20 6d 6f 64 65 6c  20 61 20 6e 65 77 20 75  |nd model a new u|
000001b0  73 65 72 20 69 6e 74 65  72 66 61 63 65 20 69 6e  |ser interface in|
000001c0  20 61 0a 6d 61 74 74 65  72 20 6f 66 20 61 20 66  | a.matter of a f|
000001d0  65 77 20 6d 69 6e 75 74  65 73 2e 0a 0a 4d 6f 64  |ew minutes...Mod|
000001e0  75 6c 65 73 0a 54 6f 20  75 73 65 20 52 65 73 45  |ules.To use ResE|
000001f0  64 20 61 6e 64 20 52 65  73 54 65 73 74 20 79 6f  |d and ResTest yo|
00000200  75 20 6d 75 73 74 20 66  69 72 73 74 20 6d 65 72  |u must first mer|
00000210  67 65 20 74 68 65 20 74  6f 6f 6c 62 6f 78 20 6d  |ge the toolbox m|
00000220  6f 64 75 6c 65 73 20 69  6e 74 6f 20 79 6f 75 0a  |odules into you.|
00000230  21 53 79 73 74 65 6d 20  64 69 72 65 63 74 6f 72  |!System director|
00000240  79 2e 20 59 6f 75 20 63  61 6e 20 75 73 65 20 21  |y. You can use !|
00000250  53 79 73 4d 65 72 67 65  20 74 6f 20 64 6f 20 74  |SysMerge to do t|
00000260  68 69 73 2c 20 66 75 6c  6c 20 69 6e 73 74 72 75  |his, full instru|
00000270  63 74 69 6f 6e 73 20 61  72 65 0a 69 6e 20 74 68  |ctions are.in th|
00000280  65 20 68 65 6c 70 20 64  6f 63 75 6d 65 6e 74 20  |e help document |
00000290  69 6e 20 21 53 79 73 4d  65 72 67 65 0a 0a 48 6f  |in !SysMerge..Ho|
000002a0  77 20 74 6f 20 75 73 65  20 74 68 69 73 20 76 65  |w to use this ve|
000002b0  72 73 69 6f 6e 3a 0a 54  68 65 20 62 61 73 69 63  |rsion:.The basic|
000002c0  20 70 72 6f 63 65 73 73  20 69 73 20 74 6f 20 6c  | process is to l|
000002d0  6f 61 64 20 52 65 73 45  64 20 61 6e 64 20 74 68  |oad ResEd and th|
000002e0  65 6e 20 6f 70 65 6e 20  75 70 20 61 20 6e 65 77  |en open up a new|
000002f0  20 72 65 73 6f 75 72 63  65 20 66 69 6c 65 0a 77  | resource file.w|
00000300  69 6e 64 6f 77 2e 20 4d  65 6e 75 20 6f 76 65 72  |indow. Menu over|
00000310  20 65 69 74 68 65 72 20  74 68 65 20 69 63 6f 6e  | either the icon|
00000320  20 6f 72 20 74 68 65 20  77 69 6e 64 6f 77 20 74  | or the window t|
00000330  6f 20 6f 70 65 6e 20 74  68 65 20 70 72 6f 74 6f  |o open the proto|
00000340  74 79 70 65 73 0a 77 69  6e 64 6f 77 2e 20 53 65  |types.window. Se|
00000350  6c 65 63 74 20 74 68 65  20 6f 62 6a 65 63 74 20  |lect the object |
00000360  74 68 61 74 20 79 6f 75  20 77 61 6e 74 20 74 6f  |that you want to|
00000370  20 75 73 65 2c 20 73 75  63 68 20 61 73 20 61 6e  | use, such as an|
00000380  20 49 63 6f 6e 62 61 72  20 69 63 6f 6e 2c 20 61  | Iconbar icon, a|
00000390  6e 64 0a 64 72 61 67 20  69 74 20 74 6f 20 79 6f  |nd.drag it to yo|
000003a0  75 72 20 6e 65 77 20 72  65 73 6f 75 72 63 65 20  |ur new resource |
000003b0  66 69 6c 65 20 77 69 6e  64 6f 77 2e 20 59 6f 75  |file window. You|
000003c0  20 63 61 6e 20 74 68 65  6e 20 73 74 61 72 74 20  | can then start |
000003d0  74 6f 20 62 75 69 6c 64  20 75 70 0a 79 6f 75 72  |to build up.your|
000003e0  20 75 73 65 72 20 69 6e  74 65 72 66 61 63 65 2c  | user interface,|
000003f0  20 6f 70 65 6e 69 6e 67  20 65 61 63 68 20 6f 62  | opening each ob|
00000400  6a 65 63 74 20 74 6f 20  73 65 74 20 69 74 73 20  |ject to set its |
00000410  70 72 6f 70 65 72 74 69  65 73 2e 20 54 6f 20 63  |properties. To c|
00000420  72 65 61 74 65 0a 74 68  65 20 6c 69 6e 6b 73 20  |reate.the links |
00000430  62 65 74 77 65 65 6e 20  6f 62 6a 65 63 74 73 2c  |between objects,|
00000440  20 64 72 6f 70 20 74 68  65 20 6e 65 77 20 6f 62  | drop the new ob|
00000450  6a 65 63 74 20 6f 6e 74  6f 20 74 68 65 20 61 70  |ject onto the ap|
00000460  70 72 6f 70 72 69 61 74  65 20 66 69 65 6c 64 20  |propriate field |
00000470  69 6e 0a 74 68 65 20 70  72 6f 70 65 72 74 69 65  |in.the propertie|
00000480  73 20 77 69 6e 64 6f 77  20 6f 66 20 74 68 65 20  |s window of the |
00000490  66 69 72 73 74 20 6f 62  6a 65 63 74 2e 20 54 6f  |first object. To|
000004a0  20 73 65 65 20 68 6f 77  20 79 6f 75 72 20 75 73  | see how your us|
000004b0  65 72 20 69 6e 74 65 72  66 61 63 65 0a 6f 62 6a  |er interface.obj|
000004c0  65 63 74 73 20 77 69 6c  6c 20 62 65 68 61 76 65  |ects will behave|
000004d0  20 61 74 20 72 75 6e 2d  74 69 6d 65 2c 20 79 6f  | at run-time, yo|
000004e0  75 20 63 61 6e 20 64 72  61 67 20 6f 62 6a 65 63  |u can drag objec|
000004f0  74 73 20 74 6f 20 74 68  65 20 52 65 73 54 65 73  |ts to the ResTes|
00000500  74 0a 61 70 70 6c 69 63  61 74 69 6f 6e 2e 20 52  |t.application. R|
00000510  65 73 54 65 73 74 27 73  20 6d 65 6e 75 20 61 6c  |esTest's menu al|
00000520  6c 6f 77 73 20 79 6f 75  20 74 6f 20 69 6e 73 74  |lows you to inst|
00000530  61 6e 74 69 61 74 65 20  28 69 65 20 63 72 65 61  |antiate (ie crea|
00000540  74 65 29 20 6f 62 6a 65  63 74 73 0a 66 72 6f 6d  |te) objects.from|
00000550  20 79 6f 75 72 20 6f 62  6a 65 63 74 20 74 65 6d  | your object tem|
00000560  70 6c 61 74 65 73 2c 20  61 6e 64 20 74 6f 20 73  |plates, and to s|
00000570  68 6f 77 20 74 68 65 6d  20 6f 6e 20 74 68 65 20  |how them on the |
00000580  73 63 72 65 65 6e 2e 20  59 6f 75 20 73 68 6f 75  |screen. You shou|
00000590  6c 64 20 6e 6f 77 0a 62  65 20 61 62 6c 65 20 74  |ld now.be able t|
000005a0  6f 20 67 65 74 20 61 20  66 65 65 6c 20 6f 66 20  |o get a feel of |
000005b0  77 68 61 74 20 74 68 65  20 75 73 65 72 20 69 6e  |what the user in|
000005c0  74 65 72 66 61 63 65 20  74 68 61 74 20 79 6f 75  |terface that you|
000005d0  20 68 61 76 65 20 63 72  65 61 74 65 64 20 6c 6f  | have created lo|
000005e0  6f 6b 73 0a 6c 69 6b 65  2e 20 48 61 76 65 20 66  |oks.like. Have f|
000005f0  75 6e 21 0a 0a 4c 69 63  65 6e 73 69 6e 67 3a 0a  |un!..Licensing:.|
00000600  4e 6f 74 65 20 74 68 61  74 20 74 68 69 73 20 64  |Note that this d|
00000610  69 73 63 20 63 6f 6e 74  61 69 6e 73 20 74 68 65  |isc contains the|
00000620  20 52 69 73 63 4f 53 20  72 65 6c 6f 63 61 74 61  | RiscOS relocata|
00000630  62 6c 65 20 6d 6f 64 75  6c 65 73 20 77 68 69 63  |ble modules whic|
00000640  68 20 66 6f 72 6d 20 74  68 65 0a 54 6f 6f 6c 62  |h form the.Toolb|
00000650  6f 78 2e 20 20 59 6f 75  20 61 72 65 20 6e 6f 74  |ox.  You are not|
00000660  20 65 6e 74 69 74 6c 65  64 20 74 6f 20 64 69 73  | entitled to dis|
00000670  74 72 69 62 75 74 65 20  74 68 65 73 65 20 6d 6f  |tribute these mo|
00000680  64 75 6c 65 73 20 69 6e  20 61 6e 79 20 66 6f 72  |dules in any for|
00000690  6d 20 74 6f 0a 61 6e 79  20 6f 74 68 65 72 20 70  |m to.any other p|
000006a0  61 72 74 79 2e 20 20 42  79 20 70 75 72 63 68 61  |arty.  By purcha|
000006b0  73 69 6e 67 20 74 68 65  20 66 75 6c 6c 20 41 63  |sing the full Ac|
000006c0  6f 72 6e 20 43 2f 43 2b  2b 20 70 72 6f 64 75 63  |orn C/C++ produc|
000006d0  74 2c 20 79 6f 75 20 77  69 6c 6c 20 62 65 0a 65  |t, you will be.e|
000006e0  6e 74 69 74 6c 65 64 20  74 6f 20 64 69 73 74 72  |ntitled to distr|
000006f0  69 62 75 74 65 20 74 68  65 20 54 6f 6f 6c 62 6f  |ibute the Toolbo|
00000700  78 20 6d 6f 64 75 6c 65  73 20 61 73 20 70 61 72  |x modules as par|
00000710  74 20 6f 66 20 79 6f 75  72 20 6f 77 6e 20 73 6f  |t of your own so|
00000720  66 74 77 61 72 65 2c 20  69 6e 0a 74 68 65 20 73  |ftware, in.the s|
00000730  61 6d 65 20 77 61 79 20  61 73 20 61 6e 79 20 6f  |ame way as any o|
00000740  74 68 65 72 20 52 69 73  63 4f 53 20 6d 6f 64 75  |ther RiscOS modu|
00000750  6c 65 2e 0a 0a 0a 44 69  73 63 6c 61 69 6d 65 72  |le....Disclaimer|
00000760  0a 54 68 69 73 20 73 6f  66 74 77 61 72 65 20 69  |.This software i|
00000770  73 20 70 72 6f 76 69 64  65 64 20 22 61 73 20 69  |s provided "as i|
00000780  73 22 3b 20 41 63 6f 72  6e 20 43 6f 6d 70 75 74  |s"; Acorn Comput|
00000790  65 72 73 20 4c 69 6d 69  74 65 64 20 20 28 22 41  |ers Limited  ("A|
000007a0  63 6f 72 6e 22 29 20 6d  61 6b 65 73 0a 6e 6f 20  |corn") makes.no |
000007b0  77 61 72 72 61 6e 74 79  2c 20 65 78 70 72 65 73  |warranty, expres|
000007c0  73 20 6f 72 20 69 6d 70  6c 69 65 64 2c 20 6f 66  |s or implied, of|
000007d0  20 74 68 65 20 6d 65 72  63 68 61 6e 74 61 62 69  | the merchantabi|
000007e0  6c 69 74 79 20 6f 66 20  20 74 68 69 73 20 73 6f  |lity of  this so|
000007f0  66 74 77 61 72 65 20 6f  72 0a 69 74 73 20 66 69  |ftware or.its fi|
00000800  74 6e 65 73 73 20 66 6f  72 20 61 6e 79 20 70 61  |tness for any pa|
00000810  72 74 69 63 75 6c 61 72  20 70 75 72 70 6f 73 65  |rticular purpose|
00000820  2e 20 49 6e 20 6e 6f 20  63 69 72 63 75 6d 73 74  |. In no circumst|
00000830  61 6e 63 65 73 20 73 68  61 6c 6c 20 41 63 6f 72  |ances shall Acor|
00000840  6e 20 62 65 0a 6c 69 61  62 6c 65 20 66 6f 72 20  |n be.liable for |
00000850  61 6e 79 20 64 61 6d 61  67 65 2c 20 6c 6f 73 73  |any damage, loss|
00000860  20 6f 66 20 70 72 6f 66  69 74 73 2c 20 6f 72 20  | of profits, or |
00000870  61 6e 79 20 69 6e 64 69  72 65 63 74 20 6f 72 20  |any indirect or |
00000880  20 63 6f 6e 73 65 71 75  65 6e 74 69 61 6c 0a 6c  | consequential.l|
00000890  6f 73 73 20 61 72 69 73  69 6e 67 20 6f 75 74 20  |oss arising out |
000008a0  6f 66 20 74 68 65 20 75  73 65 20 6f 66 20 74 68  |of the use of th|
000008b0  69 73 20 73 6f 66 74 77  61 72 65 20 6f 72 20 69  |is software or i|
000008c0  6e 61 62 69 6c 69 74 79  20 74 6f 20 20 75 73 65  |nability to  use|
000008d0  20 74 68 69 73 0a 73 6f  66 74 77 61 72 65 2c 20  | this.software, |
000008e0  65 76 65 6e 20 69 66 20  41 63 6f 72 6e 20 68 61  |even if Acorn ha|
000008f0  73 20 62 65 65 6e 20 61  64 76 69 73 65 64 20 6f  |s been advised o|
00000900  66 20 74 68 65 20 70 6f  73 73 69 62 69 6c 69 74  |f the possibilit|
00000910  79 20 6f 66 20 73 75 63  68 20 6c 6f 73 73 2e 0a  |y of such loss..|
00000920  0a                                                |.|
00000921