Home » Archimedes archive » Acorn User » AU 1996-Xmas.adf » Regulars » StarInfo/Bullock/!CloseUtil/!Help

StarInfo/Bullock/!CloseUtil/!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 1996-Xmas.adf » Regulars
Filename: StarInfo/Bullock/!CloseUtil/!Help
Read OK:
File size: 072C bytes
Load address: 0000
Exec address: 0000
File contents
             -------------------------------------------
                       !CloseUtil Version 1.00
                           15th March 1996
                         by Matthew Bullock.
             -------------------------------------------

Introduction:
-------------

   Closeutil provides an alternative method of telling the pinboard to
iconise a window and a way of reducing a window to just its title bar.

Usage:
------

   To use, just double click on  the icon to load it, it will set up a 
menu on the close icon of windows (Director must be loaded for this to
work). Select iconise  to tell the  pinboard to iconise the window, or
select  titleise to  reduce the  window  to  a title  bar. To reopen a
titleised  window,  click on the toggle-size icon  (right hand side of
the title bar).
   Alternatively there are two start commands that do the same.

   *Iconise <window handle>
     Tells the pinboard to iconise a window.
  
   *Titleise <window handle>
     Reduces a window to just a title bar.
     
Notes:
------

1) Closeutil requires RISC-OS 3.1 or later.

2) It only requires Director to provide a menu on  close icons, so you
   can still use the command line interface without it.

3) If it is used with Director, it must be  installed  after Director.
   The  easiest  way  to  do  this  is  to copy  !CloseUtil  into  the
   !Dircetor.Utils directory and add the following line to  the end of
   directors !Run file:
     Run Director:Utils.!CloseUtil

4) The Closeutil module  cannot be  RMKilled, you must first quit  the
   task using the task manager.

5) PinFix creates a small  module to fix  a bug in  Pinboard that stop
   Closeutil  working  correctly, this  may not  be  necessary  on all
   versions  of  RISC-OS,  I  have only  tries it on  version 3.6. See
   PinFHelp for more details.
00000000  20 20 20 20 20 20 20 20  20 20 20 20 20 2d 2d 2d  |             ---|
00000010  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
00000030  2d 2d 2d 2d 2d 2d 2d 2d  0a 20 20 20 20 20 20 20  |--------.       |
00000040  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000050  21 43 6c 6f 73 65 55 74  69 6c 20 56 65 72 73 69  |!CloseUtil Versi|
00000060  6f 6e 20 31 2e 30 30 0a  20 20 20 20 20 20 20 20  |on 1.00.        |
00000070  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000080  20 20 20 31 35 74 68 20  4d 61 72 63 68 20 31 39  |   15th March 19|
00000090  39 36 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |96.             |
000000a0  20 20 20 20 20 20 20 20  20 20 20 20 62 79 20 4d  |            by M|
000000b0  61 74 74 68 65 77 20 42  75 6c 6c 6f 63 6b 2e 0a  |atthew Bullock..|
000000c0  20 20 20 20 20 20 20 20  20 20 20 20 20 2d 2d 2d  |             ---|
000000d0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
*
000000f0  2d 2d 2d 2d 2d 2d 2d 2d  0a 0a 49 6e 74 72 6f 64  |--------..Introd|
00000100  75 63 74 69 6f 6e 3a 0a  2d 2d 2d 2d 2d 2d 2d 2d  |uction:.--------|
00000110  2d 2d 2d 2d 2d 0a 0a 20  20 20 43 6c 6f 73 65 75  |-----..   Closeu|
00000120  74 69 6c 20 70 72 6f 76  69 64 65 73 20 61 6e 20  |til provides an |
00000130  61 6c 74 65 72 6e 61 74  69 76 65 20 6d 65 74 68  |alternative meth|
00000140  6f 64 20 6f 66 20 74 65  6c 6c 69 6e 67 20 74 68  |od of telling th|
00000150  65 20 70 69 6e 62 6f 61  72 64 20 74 6f 0a 69 63  |e pinboard to.ic|
00000160  6f 6e 69 73 65 20 61 20  77 69 6e 64 6f 77 20 61  |onise a window a|
00000170  6e 64 20 61 20 77 61 79  20 6f 66 20 72 65 64 75  |nd a way of redu|
00000180  63 69 6e 67 20 61 20 77  69 6e 64 6f 77 20 74 6f  |cing a window to|
00000190  20 6a 75 73 74 20 69 74  73 20 74 69 74 6c 65 20  | just its title |
000001a0  62 61 72 2e 0a 0a 55 73  61 67 65 3a 0a 2d 2d 2d  |bar...Usage:.---|
000001b0  2d 2d 2d 0a 0a 20 20 20  54 6f 20 75 73 65 2c 20  |---..   To use, |
000001c0  6a 75 73 74 20 64 6f 75  62 6c 65 20 63 6c 69 63  |just double clic|
000001d0  6b 20 6f 6e 20 20 74 68  65 20 69 63 6f 6e 20 74  |k on  the icon t|
000001e0  6f 20 6c 6f 61 64 20 69  74 2c 20 69 74 20 77 69  |o load it, it wi|
000001f0  6c 6c 20 73 65 74 20 75  70 20 61 20 0a 6d 65 6e  |ll set up a .men|
00000200  75 20 6f 6e 20 74 68 65  20 63 6c 6f 73 65 20 69  |u on the close i|
00000210  63 6f 6e 20 6f 66 20 77  69 6e 64 6f 77 73 20 28  |con of windows (|
00000220  44 69 72 65 63 74 6f 72  20 6d 75 73 74 20 62 65  |Director must be|
00000230  20 6c 6f 61 64 65 64 20  66 6f 72 20 74 68 69 73  | loaded for this|
00000240  20 74 6f 0a 77 6f 72 6b  29 2e 20 53 65 6c 65 63  | to.work). Selec|
00000250  74 20 69 63 6f 6e 69 73  65 20 20 74 6f 20 74 65  |t iconise  to te|
00000260  6c 6c 20 74 68 65 20 20  70 69 6e 62 6f 61 72 64  |ll the  pinboard|
00000270  20 74 6f 20 69 63 6f 6e  69 73 65 20 74 68 65 20  | to iconise the |
00000280  77 69 6e 64 6f 77 2c 20  6f 72 0a 73 65 6c 65 63  |window, or.selec|
00000290  74 20 20 74 69 74 6c 65  69 73 65 20 74 6f 20 20  |t  titleise to  |
000002a0  72 65 64 75 63 65 20 74  68 65 20 20 77 69 6e 64  |reduce the  wind|
000002b0  6f 77 20 20 74 6f 20 20  61 20 74 69 74 6c 65 20  |ow  to  a title |
000002c0  20 62 61 72 2e 20 54 6f  20 72 65 6f 70 65 6e 20  | bar. To reopen |
000002d0  61 0a 74 69 74 6c 65 69  73 65 64 20 20 77 69 6e  |a.titleised  win|
000002e0  64 6f 77 2c 20 20 63 6c  69 63 6b 20 6f 6e 20 74  |dow,  click on t|
000002f0  68 65 20 74 6f 67 67 6c  65 2d 73 69 7a 65 20 69  |he toggle-size i|
00000300  63 6f 6e 20 20 28 72 69  67 68 74 20 68 61 6e 64  |con  (right hand|
00000310  20 73 69 64 65 20 6f 66  0a 74 68 65 20 74 69 74  | side of.the tit|
00000320  6c 65 20 62 61 72 29 2e  0a 20 20 20 41 6c 74 65  |le bar)..   Alte|
00000330  72 6e 61 74 69 76 65 6c  79 20 74 68 65 72 65 20  |rnatively there |
00000340  61 72 65 20 74 77 6f 20  73 74 61 72 74 20 63 6f  |are two start co|
00000350  6d 6d 61 6e 64 73 20 74  68 61 74 20 64 6f 20 74  |mmands that do t|
00000360  68 65 20 73 61 6d 65 2e  0a 0a 20 20 20 2a 49 63  |he same...   *Ic|
00000370  6f 6e 69 73 65 20 3c 77  69 6e 64 6f 77 20 68 61  |onise <window ha|
00000380  6e 64 6c 65 3e 0a 20 20  20 20 20 54 65 6c 6c 73  |ndle>.     Tells|
00000390  20 74 68 65 20 70 69 6e  62 6f 61 72 64 20 74 6f  | the pinboard to|
000003a0  20 69 63 6f 6e 69 73 65  20 61 20 77 69 6e 64 6f  | iconise a windo|
000003b0  77 2e 0a 20 20 0a 20 20  20 2a 54 69 74 6c 65 69  |w..  .   *Titlei|
000003c0  73 65 20 3c 77 69 6e 64  6f 77 20 68 61 6e 64 6c  |se <window handl|
000003d0  65 3e 0a 20 20 20 20 20  52 65 64 75 63 65 73 20  |e>.     Reduces |
000003e0  61 20 77 69 6e 64 6f 77  20 74 6f 20 6a 75 73 74  |a window to just|
000003f0  20 61 20 74 69 74 6c 65  20 62 61 72 2e 0a 20 20  | a title bar..  |
00000400  20 20 20 0a 4e 6f 74 65  73 3a 0a 2d 2d 2d 2d 2d  |   .Notes:.-----|
00000410  2d 0a 0a 31 29 20 43 6c  6f 73 65 75 74 69 6c 20  |-..1) Closeutil |
00000420  72 65 71 75 69 72 65 73  20 52 49 53 43 2d 4f 53  |requires RISC-OS|
00000430  20 33 2e 31 20 6f 72 20  6c 61 74 65 72 2e 0a 0a  | 3.1 or later...|
00000440  32 29 20 49 74 20 6f 6e  6c 79 20 72 65 71 75 69  |2) It only requi|
00000450  72 65 73 20 44 69 72 65  63 74 6f 72 20 74 6f 20  |res Director to |
00000460  70 72 6f 76 69 64 65 20  61 20 6d 65 6e 75 20 6f  |provide a menu o|
00000470  6e 20 20 63 6c 6f 73 65  20 69 63 6f 6e 73 2c 20  |n  close icons, |
00000480  73 6f 20 79 6f 75 0a 20  20 20 63 61 6e 20 73 74  |so you.   can st|
00000490  69 6c 6c 20 75 73 65 20  74 68 65 20 63 6f 6d 6d  |ill use the comm|
000004a0  61 6e 64 20 6c 69 6e 65  20 69 6e 74 65 72 66 61  |and line interfa|
000004b0  63 65 20 77 69 74 68 6f  75 74 20 69 74 2e 0a 0a  |ce without it...|
000004c0  33 29 20 49 66 20 69 74  20 69 73 20 75 73 65 64  |3) If it is used|
000004d0  20 77 69 74 68 20 44 69  72 65 63 74 6f 72 2c 20  | with Director, |
000004e0  69 74 20 6d 75 73 74 20  62 65 20 20 69 6e 73 74  |it must be  inst|
000004f0  61 6c 6c 65 64 20 20 61  66 74 65 72 20 44 69 72  |alled  after Dir|
00000500  65 63 74 6f 72 2e 0a 20  20 20 54 68 65 20 20 65  |ector..   The  e|
00000510  61 73 69 65 73 74 20 20  77 61 79 20 20 74 6f 20  |asiest  way  to |
00000520  20 64 6f 20 20 74 68 69  73 20 20 69 73 20 20 74  | do  this  is  t|
00000530  6f 20 63 6f 70 79 20 20  21 43 6c 6f 73 65 55 74  |o copy  !CloseUt|
00000540  69 6c 20 20 69 6e 74 6f  20 20 74 68 65 0a 20 20  |il  into  the.  |
00000550  20 21 44 69 72 63 65 74  6f 72 2e 55 74 69 6c 73  | !Dircetor.Utils|
00000560  20 64 69 72 65 63 74 6f  72 79 20 61 6e 64 20 61  | directory and a|
00000570  64 64 20 74 68 65 20 66  6f 6c 6c 6f 77 69 6e 67  |dd the following|
00000580  20 6c 69 6e 65 20 74 6f  20 20 74 68 65 20 65 6e  | line to  the en|
00000590  64 20 6f 66 0a 20 20 20  64 69 72 65 63 74 6f 72  |d of.   director|
000005a0  73 20 21 52 75 6e 20 66  69 6c 65 3a 0a 20 20 20  |s !Run file:.   |
000005b0  20 20 52 75 6e 20 44 69  72 65 63 74 6f 72 3a 55  |  Run Director:U|
000005c0  74 69 6c 73 2e 21 43 6c  6f 73 65 55 74 69 6c 0a  |tils.!CloseUtil.|
000005d0  0a 34 29 20 54 68 65 20  43 6c 6f 73 65 75 74 69  |.4) The Closeuti|
000005e0  6c 20 6d 6f 64 75 6c 65  20 20 63 61 6e 6e 6f 74  |l module  cannot|
000005f0  20 62 65 20 20 52 4d 4b  69 6c 6c 65 64 2c 20 79  | be  RMKilled, y|
00000600  6f 75 20 6d 75 73 74 20  66 69 72 73 74 20 71 75  |ou must first qu|
00000610  69 74 20 20 74 68 65 0a  20 20 20 74 61 73 6b 20  |it  the.   task |
00000620  75 73 69 6e 67 20 74 68  65 20 74 61 73 6b 20 6d  |using the task m|
00000630  61 6e 61 67 65 72 2e 0a  0a 35 29 20 50 69 6e 46  |anager...5) PinF|
00000640  69 78 20 63 72 65 61 74  65 73 20 61 20 73 6d 61  |ix creates a sma|
00000650  6c 6c 20 20 6d 6f 64 75  6c 65 20 74 6f 20 66 69  |ll  module to fi|
00000660  78 20 20 61 20 62 75 67  20 69 6e 20 20 50 69 6e  |x  a bug in  Pin|
00000670  62 6f 61 72 64 20 74 68  61 74 20 73 74 6f 70 0a  |board that stop.|
00000680  20 20 20 43 6c 6f 73 65  75 74 69 6c 20 20 77 6f  |   Closeutil  wo|
00000690  72 6b 69 6e 67 20 20 63  6f 72 72 65 63 74 6c 79  |rking  correctly|
000006a0  2c 20 74 68 69 73 20 20  6d 61 79 20 6e 6f 74 20  |, this  may not |
000006b0  20 62 65 20 20 6e 65 63  65 73 73 61 72 79 20 20  | be  necessary  |
000006c0  6f 6e 20 61 6c 6c 0a 20  20 20 76 65 72 73 69 6f  |on all.   versio|
000006d0  6e 73 20 20 6f 66 20 20  52 49 53 43 2d 4f 53 2c  |ns  of  RISC-OS,|
000006e0  20 20 49 20 20 68 61 76  65 20 6f 6e 6c 79 20 20  |  I  have only  |
000006f0  74 72 69 65 73 20 69 74  20 6f 6e 20 20 76 65 72  |tries it on  ver|
00000700  73 69 6f 6e 20 33 2e 36  2e 20 53 65 65 0a 20 20  |sion 3.6. See.  |
00000710  20 50 69 6e 46 48 65 6c  70 20 66 6f 72 20 6d 6f  | PinFHelp for mo|
00000720  72 65 20 64 65 74 61 69  6c 73 2e 0a              |re details..|
0000072c