Home » Archimedes archive » Acorn User » AU 1998-09.adf » Features » DesktopPD/ExtraBar/!ExLibrary/Utils/!FilerMenu/!Help

DesktopPD/ExtraBar/!ExLibrary/Utils/!FilerMenu/!Help

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 1998-09.adf » Features
Filename: DesktopPD/ExtraBar/!ExLibrary/Utils/!FilerMenu/!Help
Read OK:
File size: 08A5 bytes
Load address: 0000
Exec address: 0000
File contents
!Help for FilerMenu (0.20)
==========================

What is a FilerMenu
===================
A filermenu is simply what it says it is. Its a menu made up with the
contents of a folder in the filer, and can be used via the task window
or any application that allows its toolbars to be user defined and
include star commands. For example ExtraBar or Atlanta both available
from http://www.atlantic.oaktree.co.uk/ 

Installation
============
When using RISC OS 3.5 or above copy the FilerMenu directory in to the
Boot:Choices.PreDesk directory. If you are using something less then you
will either need to copy it in to your !Boot sequence so that it is
booted up. You need to make sure it is either booted or has been run
before trying to use the *Filer_Menu command.

Special flags
=============
When used from the taskwindow or from a user definable tool which allows
star commands there are a number of flags that can be used.

   -path <directory>
   	The path of the directory to display.
   	*** This must be included ***
   
   -title <text>
   	Sets the root menus title

   -notitle
   	Removes the menu title from all menus!

   -filecol <colour number>
   	Set the colour to display files in. Standard 16 colour desktop
   	colour numbers.
   
   -appcol <colour number>
   	Set the colour to display applications in. Standard 16 colour
   	desktop colour numbers.
   
   -dircol <colour number>
   	Set the colour to display directories in. Standard 16 colour
   	desktop colour numbers.
   
   -imagecol <colour number>
   	Set the colour to display image directories in. Standard 16
   	colour desktop colour numbers. Image directories are archives
   	/ PC Partitions / StrongHelp manuals / etc
   
   -nosprites
   	Removes all sprites from menus.
   
   -openitem
   	Add an 'Open directory' item to enable easier opening of
   	a directory
   
   -openapps
   	Enables submenu opening for the contents of applications.
   
   -openimgs
   	Enables submenu opening for the contents of image directories.

Examples
========

*Filer_Menu -path ADFS::4.$ -title HardDisc4

*Filer_Menu -nosprites -path Resources:$.Apps


Filer_Menu is copyright David McCormack, 1997 and can be freely distributed.

00000000  21 48 65 6c 70 20 66 6f  72 20 46 69 6c 65 72 4d  |!Help for FilerM|
00000010  65 6e 75 20 28 30 2e 32  30 29 0a 3d 3d 3d 3d 3d  |enu (0.20).=====|
00000020  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
00000030  3d 3d 3d 3d 3d 0a 0a 57  68 61 74 20 69 73 20 61  |=====..What is a|
00000040  20 46 69 6c 65 72 4d 65  6e 75 0a 3d 3d 3d 3d 3d  | FilerMenu.=====|
00000050  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 0a 41  |==============.A|
00000060  20 66 69 6c 65 72 6d 65  6e 75 20 69 73 20 73 69  | filermenu is si|
00000070  6d 70 6c 79 20 77 68 61  74 20 69 74 20 73 61 79  |mply what it say|
00000080  73 20 69 74 20 69 73 2e  20 49 74 73 20 61 20 6d  |s it is. Its a m|
00000090  65 6e 75 20 6d 61 64 65  20 75 70 20 77 69 74 68  |enu made up with|
000000a0  20 74 68 65 0a 63 6f 6e  74 65 6e 74 73 20 6f 66  | the.contents of|
000000b0  20 61 20 66 6f 6c 64 65  72 20 69 6e 20 74 68 65  | a folder in the|
000000c0  20 66 69 6c 65 72 2c 20  61 6e 64 20 63 61 6e 20  | filer, and can |
000000d0  62 65 20 75 73 65 64 20  76 69 61 20 74 68 65 20  |be used via the |
000000e0  74 61 73 6b 20 77 69 6e  64 6f 77 0a 6f 72 20 61  |task window.or a|
000000f0  6e 79 20 61 70 70 6c 69  63 61 74 69 6f 6e 20 74  |ny application t|
00000100  68 61 74 20 61 6c 6c 6f  77 73 20 69 74 73 20 74  |hat allows its t|
00000110  6f 6f 6c 62 61 72 73 20  74 6f 20 62 65 20 75 73  |oolbars to be us|
00000120  65 72 20 64 65 66 69 6e  65 64 20 61 6e 64 0a 69  |er defined and.i|
00000130  6e 63 6c 75 64 65 20 73  74 61 72 20 63 6f 6d 6d  |nclude star comm|
00000140  61 6e 64 73 2e 20 46 6f  72 20 65 78 61 6d 70 6c  |ands. For exampl|
00000150  65 20 45 78 74 72 61 42  61 72 20 6f 72 20 41 74  |e ExtraBar or At|
00000160  6c 61 6e 74 61 20 62 6f  74 68 20 61 76 61 69 6c  |lanta both avail|
00000170  61 62 6c 65 0a 66 72 6f  6d 20 68 74 74 70 3a 2f  |able.from http:/|
00000180  2f 77 77 77 2e 61 74 6c  61 6e 74 69 63 2e 6f 61  |/www.atlantic.oa|
00000190  6b 74 72 65 65 2e 63 6f  2e 75 6b 2f 20 0a 0a 49  |ktree.co.uk/ ..I|
000001a0  6e 73 74 61 6c 6c 61 74  69 6f 6e 0a 3d 3d 3d 3d  |nstallation.====|
000001b0  3d 3d 3d 3d 3d 3d 3d 3d  0a 57 68 65 6e 20 75 73  |========.When us|
000001c0  69 6e 67 20 52 49 53 43  20 4f 53 20 33 2e 35 20  |ing RISC OS 3.5 |
000001d0  6f 72 20 61 62 6f 76 65  20 63 6f 70 79 20 74 68  |or above copy th|
000001e0  65 20 46 69 6c 65 72 4d  65 6e 75 20 64 69 72 65  |e FilerMenu dire|
000001f0  63 74 6f 72 79 20 69 6e  20 74 6f 20 74 68 65 0a  |ctory in to the.|
00000200  42 6f 6f 74 3a 43 68 6f  69 63 65 73 2e 50 72 65  |Boot:Choices.Pre|
00000210  44 65 73 6b 20 64 69 72  65 63 74 6f 72 79 2e 20  |Desk directory. |
00000220  49 66 20 79 6f 75 20 61  72 65 20 75 73 69 6e 67  |If you are using|
00000230  20 73 6f 6d 65 74 68 69  6e 67 20 6c 65 73 73 20  | something less |
00000240  74 68 65 6e 20 79 6f 75  0a 77 69 6c 6c 20 65 69  |then you.will ei|
00000250  74 68 65 72 20 6e 65 65  64 20 74 6f 20 63 6f 70  |ther need to cop|
00000260  79 20 69 74 20 69 6e 20  74 6f 20 79 6f 75 72 20  |y it in to your |
00000270  21 42 6f 6f 74 20 73 65  71 75 65 6e 63 65 20 73  |!Boot sequence s|
00000280  6f 20 74 68 61 74 20 69  74 20 69 73 0a 62 6f 6f  |o that it is.boo|
00000290  74 65 64 20 75 70 2e 20  59 6f 75 20 6e 65 65 64  |ted up. You need|
000002a0  20 74 6f 20 6d 61 6b 65  20 73 75 72 65 20 69 74  | to make sure it|
000002b0  20 69 73 20 65 69 74 68  65 72 20 62 6f 6f 74 65  | is either boote|
000002c0  64 20 6f 72 20 68 61 73  20 62 65 65 6e 20 72 75  |d or has been ru|
000002d0  6e 0a 62 65 66 6f 72 65  20 74 72 79 69 6e 67 20  |n.before trying |
000002e0  74 6f 20 75 73 65 20 74  68 65 20 2a 46 69 6c 65  |to use the *File|
000002f0  72 5f 4d 65 6e 75 20 63  6f 6d 6d 61 6e 64 2e 0a  |r_Menu command..|
00000300  0a 53 70 65 63 69 61 6c  20 66 6c 61 67 73 0a 3d  |.Special flags.=|
00000310  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 0a 57 68 65  |============.Whe|
00000320  6e 20 75 73 65 64 20 66  72 6f 6d 20 74 68 65 20  |n used from the |
00000330  74 61 73 6b 77 69 6e 64  6f 77 20 6f 72 20 66 72  |taskwindow or fr|
00000340  6f 6d 20 61 20 75 73 65  72 20 64 65 66 69 6e 61  |om a user defina|
00000350  62 6c 65 20 74 6f 6f 6c  20 77 68 69 63 68 20 61  |ble tool which a|
00000360  6c 6c 6f 77 73 0a 73 74  61 72 20 63 6f 6d 6d 61  |llows.star comma|
00000370  6e 64 73 20 74 68 65 72  65 20 61 72 65 20 61 20  |nds there are a |
00000380  6e 75 6d 62 65 72 20 6f  66 20 66 6c 61 67 73 20  |number of flags |
00000390  74 68 61 74 20 63 61 6e  20 62 65 20 75 73 65 64  |that can be used|
000003a0  2e 0a 0a 20 20 20 2d 70  61 74 68 20 3c 64 69 72  |...   -path <dir|
000003b0  65 63 74 6f 72 79 3e 0a  20 20 20 09 54 68 65 20  |ectory>.   .The |
000003c0  70 61 74 68 20 6f 66 20  74 68 65 20 64 69 72 65  |path of the dire|
000003d0  63 74 6f 72 79 20 74 6f  20 64 69 73 70 6c 61 79  |ctory to display|
000003e0  2e 0a 20 20 20 09 2a 2a  2a 20 54 68 69 73 20 6d  |..   .*** This m|
000003f0  75 73 74 20 62 65 20 69  6e 63 6c 75 64 65 64 20  |ust be included |
00000400  2a 2a 2a 0a 20 20 20 0a  20 20 20 2d 74 69 74 6c  |***.   .   -titl|
00000410  65 20 3c 74 65 78 74 3e  0a 20 20 20 09 53 65 74  |e <text>.   .Set|
00000420  73 20 74 68 65 20 72 6f  6f 74 20 6d 65 6e 75 73  |s the root menus|
00000430  20 74 69 74 6c 65 0a 0a  20 20 20 2d 6e 6f 74 69  | title..   -noti|
00000440  74 6c 65 0a 20 20 20 09  52 65 6d 6f 76 65 73 20  |tle.   .Removes |
00000450  74 68 65 20 6d 65 6e 75  20 74 69 74 6c 65 20 66  |the menu title f|
00000460  72 6f 6d 20 61 6c 6c 20  6d 65 6e 75 73 21 0a 0a  |rom all menus!..|
00000470  20 20 20 2d 66 69 6c 65  63 6f 6c 20 3c 63 6f 6c  |   -filecol <col|
00000480  6f 75 72 20 6e 75 6d 62  65 72 3e 0a 20 20 20 09  |our number>.   .|
00000490  53 65 74 20 74 68 65 20  63 6f 6c 6f 75 72 20 74  |Set the colour t|
000004a0  6f 20 64 69 73 70 6c 61  79 20 66 69 6c 65 73 20  |o display files |
000004b0  69 6e 2e 20 53 74 61 6e  64 61 72 64 20 31 36 20  |in. Standard 16 |
000004c0  63 6f 6c 6f 75 72 20 64  65 73 6b 74 6f 70 0a 20  |colour desktop. |
000004d0  20 20 09 63 6f 6c 6f 75  72 20 6e 75 6d 62 65 72  |  .colour number|
000004e0  73 2e 0a 20 20 20 0a 20  20 20 2d 61 70 70 63 6f  |s..   .   -appco|
000004f0  6c 20 3c 63 6f 6c 6f 75  72 20 6e 75 6d 62 65 72  |l <colour number|
00000500  3e 0a 20 20 20 09 53 65  74 20 74 68 65 20 63 6f  |>.   .Set the co|
00000510  6c 6f 75 72 20 74 6f 20  64 69 73 70 6c 61 79 20  |lour to display |
00000520  61 70 70 6c 69 63 61 74  69 6f 6e 73 20 69 6e 2e  |applications in.|
00000530  20 53 74 61 6e 64 61 72  64 20 31 36 20 63 6f 6c  | Standard 16 col|
00000540  6f 75 72 0a 20 20 20 09  64 65 73 6b 74 6f 70 20  |our.   .desktop |
00000550  63 6f 6c 6f 75 72 20 6e  75 6d 62 65 72 73 2e 0a  |colour numbers..|
00000560  20 20 20 0a 20 20 20 2d  64 69 72 63 6f 6c 20 3c  |   .   -dircol <|
00000570  63 6f 6c 6f 75 72 20 6e  75 6d 62 65 72 3e 0a 20  |colour number>. |
00000580  20 20 09 53 65 74 20 74  68 65 20 63 6f 6c 6f 75  |  .Set the colou|
00000590  72 20 74 6f 20 64 69 73  70 6c 61 79 20 64 69 72  |r to display dir|
000005a0  65 63 74 6f 72 69 65 73  20 69 6e 2e 20 53 74 61  |ectories in. Sta|
000005b0  6e 64 61 72 64 20 31 36  20 63 6f 6c 6f 75 72 0a  |ndard 16 colour.|
000005c0  20 20 20 09 64 65 73 6b  74 6f 70 20 63 6f 6c 6f  |   .desktop colo|
000005d0  75 72 20 6e 75 6d 62 65  72 73 2e 0a 20 20 20 0a  |ur numbers..   .|
000005e0  20 20 20 2d 69 6d 61 67  65 63 6f 6c 20 3c 63 6f  |   -imagecol <co|
000005f0  6c 6f 75 72 20 6e 75 6d  62 65 72 3e 0a 20 20 20  |lour number>.   |
00000600  09 53 65 74 20 74 68 65  20 63 6f 6c 6f 75 72 20  |.Set the colour |
00000610  74 6f 20 64 69 73 70 6c  61 79 20 69 6d 61 67 65  |to display image|
00000620  20 64 69 72 65 63 74 6f  72 69 65 73 20 69 6e 2e  | directories in.|
00000630  20 53 74 61 6e 64 61 72  64 20 31 36 0a 20 20 20  | Standard 16.   |
00000640  09 63 6f 6c 6f 75 72 20  64 65 73 6b 74 6f 70 20  |.colour desktop |
00000650  63 6f 6c 6f 75 72 20 6e  75 6d 62 65 72 73 2e 20  |colour numbers. |
00000660  49 6d 61 67 65 20 64 69  72 65 63 74 6f 72 69 65  |Image directorie|
00000670  73 20 61 72 65 20 61 72  63 68 69 76 65 73 0a 20  |s are archives. |
00000680  20 20 09 2f 20 50 43 20  50 61 72 74 69 74 69 6f  |  ./ PC Partitio|
00000690  6e 73 20 2f 20 53 74 72  6f 6e 67 48 65 6c 70 20  |ns / StrongHelp |
000006a0  6d 61 6e 75 61 6c 73 20  2f 20 65 74 63 0a 20 20  |manuals / etc.  |
000006b0  20 0a 20 20 20 2d 6e 6f  73 70 72 69 74 65 73 0a  | .   -nosprites.|
000006c0  20 20 20 09 52 65 6d 6f  76 65 73 20 61 6c 6c 20  |   .Removes all |
000006d0  73 70 72 69 74 65 73 20  66 72 6f 6d 20 6d 65 6e  |sprites from men|
000006e0  75 73 2e 0a 20 20 20 0a  20 20 20 2d 6f 70 65 6e  |us..   .   -open|
000006f0  69 74 65 6d 0a 20 20 20  09 41 64 64 20 61 6e 20  |item.   .Add an |
00000700  27 4f 70 65 6e 20 64 69  72 65 63 74 6f 72 79 27  |'Open directory'|
00000710  20 69 74 65 6d 20 74 6f  20 65 6e 61 62 6c 65 20  | item to enable |
00000720  65 61 73 69 65 72 20 6f  70 65 6e 69 6e 67 20 6f  |easier opening o|
00000730  66 0a 20 20 20 09 61 20  64 69 72 65 63 74 6f 72  |f.   .a director|
00000740  79 0a 20 20 20 0a 20 20  20 2d 6f 70 65 6e 61 70  |y.   .   -openap|
00000750  70 73 0a 20 20 20 09 45  6e 61 62 6c 65 73 20 73  |ps.   .Enables s|
00000760  75 62 6d 65 6e 75 20 6f  70 65 6e 69 6e 67 20 66  |ubmenu opening f|
00000770  6f 72 20 74 68 65 20 63  6f 6e 74 65 6e 74 73 20  |or the contents |
00000780  6f 66 20 61 70 70 6c 69  63 61 74 69 6f 6e 73 2e  |of applications.|
00000790  0a 20 20 20 0a 20 20 20  2d 6f 70 65 6e 69 6d 67  |.   .   -openimg|
000007a0  73 0a 20 20 20 09 45 6e  61 62 6c 65 73 20 73 75  |s.   .Enables su|
000007b0  62 6d 65 6e 75 20 6f 70  65 6e 69 6e 67 20 66 6f  |bmenu opening fo|
000007c0  72 20 74 68 65 20 63 6f  6e 74 65 6e 74 73 20 6f  |r the contents o|
000007d0  66 20 69 6d 61 67 65 20  64 69 72 65 63 74 6f 72  |f image director|
000007e0  69 65 73 2e 0a 0a 45 78  61 6d 70 6c 65 73 0a 3d  |ies...Examples.=|
000007f0  3d 3d 3d 3d 3d 3d 3d 0a  0a 2a 46 69 6c 65 72 5f  |=======..*Filer_|
00000800  4d 65 6e 75 20 2d 70 61  74 68 20 41 44 46 53 3a  |Menu -path ADFS:|
00000810  3a 34 2e 24 20 2d 74 69  74 6c 65 20 48 61 72 64  |:4.$ -title Hard|
00000820  44 69 73 63 34 0a 0a 2a  46 69 6c 65 72 5f 4d 65  |Disc4..*Filer_Me|
00000830  6e 75 20 2d 6e 6f 73 70  72 69 74 65 73 20 2d 70  |nu -nosprites -p|
00000840  61 74 68 20 52 65 73 6f  75 72 63 65 73 3a 24 2e  |ath Resources:$.|
00000850  41 70 70 73 0a 0a 0a 46  69 6c 65 72 5f 4d 65 6e  |Apps...Filer_Men|
00000860  75 20 69 73 20 63 6f 70  79 72 69 67 68 74 20 44  |u is copyright D|
00000870  61 76 69 64 20 4d 63 43  6f 72 6d 61 63 6b 2c 20  |avid McCormack, |
00000880  31 39 39 37 20 61 6e 64  20 63 61 6e 20 62 65 20  |1997 and can be |
00000890  66 72 65 65 6c 79 20 64  69 73 74 72 69 62 75 74  |freely distribut|
000008a0  65 64 2e 0a 0a                                    |ed...|
000008a5